Adapters

Adapters wire Shared Agents into each AI tool: session hooks, skill symlinks, rule symlinks, and merged instruction files.

Configuration is driven by adapters/manifest.json.

Command	Purpose
`sa install`	Configure detected tools (first time or new tool)
`sa sync`	Refresh symlinks and `AGENTS.md` / `CLAUDE.md` blocks
`sa check`	Installed vs configured matrix
`sa doctor --fix`	Repair broken rule symlinks

Installed ≠ configured. sa install only touches tools detected as installed.

Supported tools

Tool	Adapter ID	Rules delivery	Details
Cursor IDE	`cursor`	`~/.cursor/rules/` symlinks	cursor/README
Claude Code	`claude-code`	`~/.claude/CLAUDE.md` marker	claude-code/README
Zed	`zed`	`~/.config/zed/AGENTS.md`	zed/README
Pi	`pi`	`~/.pi/agent/AGENTS.md`	pi/README
OpenAI Codex CLI	`codex`	`~/.codex/AGENTS.md`	codex/README
OpenCode	`opencode`	`~/.config/opencode/AGENTS.md`	opencode/README
Gemini CLI	`gemini`	`~/.gemini/GEMINI.md`	gemini/README
Windsurf	`windsurf`	`~/.codeium/windsurf/AGENTS.md`	windsurf/README
Continue.dev	`continue`	`~/.continue/AGENTS.md`	continue/README
GitHub Copilot	`copilot`	Copilot `AGENTS.md` paths	copilot/README
Aider	`aider`	`~/.aider/AGENTS.md`	aider/README
Grok Build	`grok`	`~/.grok/AGENTS.md`	grok/README
OpenClaw / headless	`openclaw`	Reads `$SHARED_AGENTS_HOME`	openclaw/README
Generic / manual	`generic`	Copy-paste instructions	generic/README

What `sa sync` does per tool

Skill symlinks — Core + team skills → ~/.agents/skills, ~/.claude/skills, etc.
Cursor rule symlinks — Core + team .mdc → ~/.cursor/rules/
Team-rules blocks — Injected between markers in each tool’s global agents file

Session hooks (where configured) run sa sync quietly at session start.

Cursor

Hook: sessionStart → shared-agents-sync.sh
Rules: symlinked .mdc files
If a rule path is a regular file, sa doctor --fix backs it up and relinks

Claude Code, Zed, Codex, …

Merged blocks in CLAUDE.md / AGENTS.md / GEMINI.md
Base block:  (sync + learnings hints)
Team rules block:

Zed and Pi have no session hook — agents should run sync as an early step when needed. Pi already discovers ~/.agents/skills, so sync does not add a second skill directory.

Grok Build

Hook: ~/.grok/hooks/shared-agents.json → SessionStart (timeout 60s, because Grok's default is 5s)
Rules: merged into ~/.grok/AGENTS.md
Skills: ~/.agents/skills (Grok reads that directory; no ~/.grok/skills copy)
Does not change [compat.claude]. Grok keeps reading ~/.claude/CLAUDE.md and <repo>/.claude/CLAUDE.md. sa install also writes the same team-rules block into ~/.grok/AGENTS.md, so that block can show up twice.

Details: adapters/grok/README.md.

Adding a new tool (contributors)

Add entry to adapters/manifest.json (detect, detect_bins, agents_md, sync, …)
Add adapters/<tool-id>/README.md
Run sa install --dry-run, sa install, sa check
Open a PR with sample sa check output

See Contributing.

Generic fallback

If your CLI is not in the manifest, copy adapters/generic/instructions.md into your global agent config and set $SHARED_AGENTS_HOME.