agentx - agentx

agentx is a command line tool for the AI agents on your machine. It finds every agent client, such as Claude Code or Cursor, and lists the skills, MCP servers and plugins each one sees. It also installs and updates skills in all of them at once. Run it from a terminal.

Highlights

Supports 75 agent clients. For Claude Code, Codex, Cursor and Gemini CLI, agentx reads skills, MCP servers and plugins. For Windsurf and GitHub Copilot, it reads skills and MCP servers. For the others, it reads skills only.
Installs skills from any git repository into one library, ~/.agents/skills, and links them into each agent client, so one update reaches every client.
Shows what you changed in a skill, and keeps your edits when you update it.
Takes over the skills the Vercel skills CLI installed, without reinstalling them.
Copies this machine’s settings to another machine, with a list of the skills to bring back.

Install

The app (recommended)

On a Mac with Apple silicon, install the app with Homebrew. This also puts the agentx CLI on your PATH:

brew install grundmanise/tap/agentx

On Linux, download the .deb or the AppImage in Install the app. With the AppImage, also install the CLI to run the commands on this page.

Alternatively, CLI only

For a machine with no desktop, such as a server, install only the CLI, on macOS or Linux. Use Homebrew:

brew install grundmanise/tap/agentx-cli

or, on Linux or a Mac with Apple silicon, the install script, which installs the CLI to ~/.local/bin:

curl -fsSL https://agentx.wtf/install | sh

agentx also needs git 2.40 or later on your PATH. Run agentx doctor to check that this machine is ready. See Install and update for nightly builds, updates and building from source.

See what your agents have

From a terminal, list every agent client on this machine and what each one sees:

$ agentx scan
2 configurations, 3 skills, 2 servers, 1 plugin detected

Claude Code (claude-code)  /home/me/.claude  enabled  3 skills, 1 plugin
  skills:
    commit  symlink    user  /home/me/.claude/skills/commit -> /home/me/.agents/skills/commit
    format  directory  user  /home/me/.claude/plugins/cache/acme-tools/formatter/1.2.0/skills/format  (plugin formatter)
    review  directory  user  /home/me/.claude/skills/review
  plugins:
    formatter  1.2.0  1 skill

Cursor (cursor)  /home/me/.cursor  enabled  2 skills, 2 servers
  skills:
    commit  symlink    user  /home/me/.claude/skills/commit -> /home/me/.agents/skills/commit
    review  directory  user  /home/me/.claude/skills/review
  servers:
    context7  stdio            npx -y @upstash/context7-mcp
    stripe    streamable-http  https://mcp.stripe.com

See agentx scan for how to read the output.

Install a skill in every client

Install a skill once, and agentx links it into each client:

$ agentx skill add anthropics/skills --name pdf
✓ added source https://github.com/anthropics/skills: 17 skills
✓ installed pdf from https://github.com/anthropics/skills under skills/pdf: 4 placements
  claude-code  symlink  /home/me/.claude/skills/pdf -> /home/me/.agents/skills/pdf
  codex        library  /home/me/.agents/skills/pdf
  cursor       symlink  /home/me/.cursor/skills/pdf -> /home/me/.agents/skills/pdf
  gemini-cli   library  /home/me/.agents/skills/pdf
  always available to universal clients: codex, gemini-cli

agentx adds the source, installs the skill into the library and links it into each client. Codex and Gemini CLI read the library directly, so they need no link (see Clients that see every skill). See agentx skill to place, update and remove skills.

Get help

agentx --help
agentx skill add --help

Key terms

See the glossary for the terms these pages use.

Learn more

Account remote and cloud agents

Account remote: the repository that carries your own skills and the snapshot of each machine between your machines.
Cloud agents: bring your skills to every session of a cloud agent, such as Claude Code on the web.

Inventory

agentx scan: list every agent configuration on this machine and the skills each one sees.
agentx serve: keep watching this machine and report each change. The desktop app runs it for you.

Skills

agentx skill: install, place and remove skills, list your library, see what you changed, check for updates, update and publish.
agentx source: add the git repositories you install skills from, fetch them again, list their skills and remove them. Also add your account remote here.
agentx adopt: take over the skills the Vercel skills CLI or Skillshare installed.
Your own skills: create a skill, fork one, publish its edits, read its history, rename and remove it.

This machine

agentx machine: show this machine’s id and label, rename it or reset the id.
agentx config: list, get and set this machine’s settings, and enable or disable a configuration.
agentx export and agentx import: save a snapshot of this machine, and apply it to another machine: its settings, its skills and where each one is placed.
agentx doctor: check that this machine can run agentx.
agentx update: update agentx to the latest release, or check whether one is out.

Reference

Output and exit codes: colours, logs, exit codes and environment variables.
agentx version: print the CLI version and its output schema version.