pakx

docs · supported agents

Supported AI agents

pakx ships per-agent adapters as part of the pakx-agents crate. Each adapter handles detection on the local machine plus the per-primitive install path that agent expects on disk. pakx install dispatches one adapter at a time, so a project with only Claude Code installed never touches the Cursor config dir.

Run pakx doctor to see which adapters detected an agent on the current machine.

Adapters at a glance

stable ships full install + uninstall. detect-only registers the adapter so the CLI can target it from agents.ymlbut has no install path yet — pakx will skip writes for that agent and print a clear "unsupported primitive" in pakx doctor.

The columns below show which manifest primitives pakx writes to disk for each agent today. Agents themselves may support additional primitives natively — Claude Code, for example, reads subagents from ~/.claude/agents/ and slash commands from ~/.claude/commands/ even though pakx doesn't install into those paths yet.

Adapter status and primitive support — which agents pakx detects and which manifest primitives it currently writes to disk for each.
AgentVendorStatusidSkills (pakx installs)MCP (pakx installs)
Claude CodeAnthropicstableclaude-code
CursorAnyspheredetect-onlycursor
Codex CLIOpenAIdetect-onlycodex
GitHub CopilotGitHubdetect-onlycopilot
WindsurfCodeiumdetect-onlywindsurf

Per-adapter detail

Claude Code

claude-code
stable

Skills install under ~/.claude/skills/<owner>/<name>/; MCP servers merge into project-scoped .mcp.json.

Vendor
Anthropic
Config dir
~/.claude

Primitives pakx installs

  • Skills
  • MCP servers
  • Subagents
  • Prompts
  • Slash commands
  • Hooks
adapter source →Claude Code docs →

Cursor

cursor
detect-only

Detection only at v0.1 — config dir lives at ~/.cursor; future versions may project skills onto .cursor/rules/*.md.

Vendor
Anysphere
Config dir
~/.cursor

Primitives pakx installs

  • Skills
  • MCP servers
  • Subagents
  • Prompts
  • Slash commands
  • Hooks
adapter source →Cursor docs →

Codex CLI

codex
detect-only

Detection only at v0.1 — config dir is ~/.codex; the closest skill convention is project-level AGENTS.md.

Vendor
OpenAI
Config dir
~/.codex

Primitives pakx installs

  • Skills
  • MCP servers
  • Subagents
  • Prompts
  • Slash commands
  • Hooks
adapter source →Codex CLI docs →

GitHub Copilot

copilot
detect-only

Detection only at v0.1 — XDG config-dir/github-copilot on Linux/macOS, %APPDATA%\github-copilot on Windows.

Vendor
GitHub
Config dir
$XDG_CONFIG_HOME/github-copilot

Primitives pakx installs

  • Skills
  • MCP servers
  • Subagents
  • Prompts
  • Slash commands
  • Hooks
adapter source →GitHub Copilot docs →

Windsurf

windsurf
detect-only

Detection only at v0.1 — config dir lives at ~/.codeium/windsurf; no native skills primitive yet.

Vendor
Codeium
Config dir
~/.codeium/windsurf

Primitives pakx installs

  • Skills
  • MCP servers
  • Subagents
  • Prompts
  • Slash commands
  • Hooks
adapter source →Windsurf docs →

What about agent X?

New adapters land as a single file under crates/pakx-agents/src/ implementing the Adapter trait (detection + the install_* primitives the agent natively supports). Open an issue at github.com/pakxdev/pakx/issues to request one, or send a PR — the existing adapters are short and self-contained references.

See also