Skip to content

Commit bf61810

Browse files
committed
docs: update agent and skill counts, and refine compatibility matrix
- Update agent count to 32 and skill catalog to 150+ skills across 70+ technologies - Add VS Code to Agent Compatibility Matrix and refine agent metadata - Add 'agentsync skill suggest' to README usage examples - Standardize CLI project root flags in reference documentation - Move status subcommand for better flow and clarify global flags
1 parent 674b6d0 commit bf61810

3 files changed

Lines changed: 54 additions & 49 deletions

File tree

README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -337,6 +337,7 @@ agentsync status
337337
agentsync doctor [--project-root <path>]
338338

339339
# Manage skills
340+
agentsync skill suggest
340341
agentsync skill install <skill-id>
341342
agentsync skill update <skill-id>
342343
agentsync skill uninstall <skill-id>
@@ -442,7 +443,7 @@ AgentSync supports the following agents and will synchronize corresponding files
442443
- **VS Code**`.vscode/mcp.json` (agent id: `vscode`)
443444
- **OpenCode**`opencode.json` (agent id: `opencode`)
444445

445-
AgentSync also supports 32+ agents (7 native MCP agents and 25+ configurable agents) including Windsurf, Cline, Amazon Q, Aider, RooCode, Trae, and more. See the [full list in the documentation](https://dallay.github.io/agentsync/reference/configuration/).
446+
AgentSync also supports 32 agents (7 native MCP agents and 25 configurable agents) including Windsurf, Cline, Amazon Q, Aider, RooCode, Trae, and more. See the [full list in the documentation](https://dallay.github.io/agentsync/reference/configuration/).
446447

447448
See the [MCP Integration Guide](https://dallay.github.io/agentsync/guides/mcp/) for formatter details and merge behavior.
448449

@@ -602,7 +603,7 @@ If you need agentsync in CI, you can download the latest version automatically u
602603
603604
## Skills
604605
605-
AgentSync includes a curated skill catalog with 100+ skills across 40+ technologies. Skills are small bundles of AI-agent instructions that can be installed into your project.
606+
AgentSync includes a curated skill catalog with 150+ skills across 70+ technologies. Skills are small bundles of AI-agent instructions that can be installed into your project.
606607
607608
- **[dallay/agents-skills](https://github.com/dallay/agents-skills)** — Canonical home for all dallay-maintained skills. Community contributions welcome via PR.
608609
- **External providers** — Skills from Angular, Vercel, Cloudflare, Expo, Stripe, and many more are resolved from their respective repositories.

website/docs/src/content/docs/reference/cli.mdx

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ agentsync apply [OPTIONS]
6464
```
6565

6666
**Options**:
67-
- `-p, --path <PATH>`: Project root directory. Also aliased as `--project-root`.
67+
- `-p, --path <PATH>`: Project root directory (defaults to current dir). Also aliased as `--project-root`.
6868
- `-c, --config <CONFIG>`: Use a custom configuration file path instead of the default `.agents/agentsync.toml`.
6969
- `--clean`: Deletes existing symbolic links before applying.
7070
- `--dry-run`: Shows what actions would be taken without actually making any changes, including pending `.gitignore` writes or cleanup when gitignore reconciliation is active.
@@ -119,11 +119,11 @@ Preview without any gitignore writes or cleanup:
119119
Removes all symbolic links managed by AgentSync.
120120

121121
```bash
122-
agentsync clean [FLAGS]
122+
agentsync clean [OPTIONS]
123123
```
124124

125-
**Flags**:
126-
- `-p, --path <PATH>`: Path to the project root. Also aliased as `--project-root`.
125+
**Options**:
126+
- `-p, --path <PATH>`: Project root directory (defaults to current dir). Also aliased as `--project-root`.
127127
- `-c, --config <PATH>`: Path to a custom configuration file.
128128
- `--dry-run`: Shows what would be removed without actually deleting anything.
129129
- `-v, --verbose`: Enable verbose logging.
@@ -250,34 +250,16 @@ agentsync doctor [OPTIONS]
250250
251251
---
252252
253-
### `version`
254-
255-
Shows the current version of the AgentSync CLI.
256-
257-
<CommandTabs command="--version" />
258-
259-
---
260-
261-
### `--help`
262-
263-
Shows help information for the CLI or a specific command.
264-
265-
<CommandTabs command="--help" />
266-
267-
<CommandTabs command="apply --help" />
268-
269-
---
270-
271253
### `status`
272254
273255
Verify the status of AgentSync-managed targets and report drift.
274256
275257
```bash
276-
agentsync status [--project-root <path>] [--json]
258+
agentsync status [OPTIONS]
277259
```
278260
279-
**Flags**:
280-
- `-p, --project-root <path>`: Optional. Path to the project root to locate the agentsync config. If omitted, the current working directory is used.
261+
**Options**:
262+
- `-p, --project-root <PROJECT_ROOT>`: Project root (defaults to CWD).
281263
- `--json`: Output machine-readable JSON (pretty-printed) describing each managed target. Useful for CI.
282264
283265
**Behavior**:
@@ -319,3 +301,21 @@ Examples
319301
- <CommandTabs command="status --project-root /path/to/repo --json" />
320302
321303
On Windows, `status` is also a practical post-setup verification step after you fix symlink permissions or switch to WSL. See the <a href="/guides/windows-symlink-setup/">Windows Symlink Setup guide</a> for the broader verification flow.
304+
305+
---
306+
307+
### `--version`
308+
309+
Shows the current version of the AgentSync CLI. This is a global flag available at the root.
310+
311+
<CommandTabs command="--version" />
312+
313+
---
314+
315+
### `--help`
316+
317+
Shows help information for the CLI or a specific command.
318+
319+
<CommandTabs command="--help" />
320+
321+
<CommandTabs command="apply --help" />

website/docs/src/content/docs/reference/configuration.mdx

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,7 @@ Those destinations stay as real directories:
187187

188188
## Agent Compatibility Matrix
189189

190-
AgentSync has two support levels:
190+
AgentSync supports 32 agents across two levels:
191191

192192
- **Native MCP generation** (built-in formatter + merge behavior): `claude`, `copilot`, `codex`, `gemini`, `cursor`, `vscode`, `opencode`.
193193
- **Configurable sync targets** (rules/skills via symlink): any agent as long as you declare `[agents.<name>.targets.*]` entries.
@@ -203,33 +203,37 @@ The matrix below documents common agent locations and whether AgentSync can hand
203203
| Pi Coding Agent | - | No native MCP formatter | Configurable |
204204
| Jules | - | No native MCP formatter | Configurable |
205205
| Cursor | `.cursor/rules/agentsync.mdc` | `.cursor/mcp.json` (native MCP) | Configurable; `.cursor/skills/` |
206-
| Windsurf | `.windsurfrules` | No native MCP formatter; `.windsurf/mcp_config.json` ignore | Configurable |
206+
| VS Code | - | `.vscode/mcp.json` (native MCP) | Configurable |
207+
| Windsurf | `.windsurfrules` | `.windsurf/mcp_config.json` ignore | Configurable |
207208
| Cline | `.clinerules` | No native MCP formatter | Configurable |
208-
| Crush | `CRUSH.md` | No native MCP formatter; `.crush.json` ignore | Configurable |
209+
| Crush | `CRUSH.md` | `CRUSH.md`, `.crush.json` ignore | Configurable |
209210
| Amp | `AMPCODE.md` | No native MCP formatter | Configurable |
210-
| Antigravity | - | No native MCP formatter; `.agent/rules/`, `.agent/skills/` ignores | Configurable |
211-
| Amazon Q CLI | - | No native MCP formatter; `.amazonq/rules/`, `.amazonq/mcp.json` ignores | Configurable |
212-
| Aider | - | No native MCP formatter; `.aider.conf.yml`, `.aiderignore` ignores | Configurable |
213-
| Firebase Studio | - | No native MCP formatter; `.idx/airules.md`, `.idx/mcp.json` ignores | Configurable |
214-
| Open Hands | - | No native MCP formatter; `.openhands/microagents/` ignore | Configurable |
211+
| Antigravity | - | `.agent/rules/`, `.agent/skills/` ignores | Configurable; `.agent/skills/` |
212+
| Amazon Q CLI | - | `.amazonq/rules/`, `.amazonq/mcp.json` ignores | Configurable |
213+
| Aider | - | `.aider.conf.yml`, `.aiderignore` ignores | Configurable |
214+
| Firebase Studio | - | `.idx/airules.md`, `.idx/mcp.json` ignores | Configurable |
215+
| Open Hands | - | `.openhands/microagents/` ignore | Configurable |
215216

216217
**Note (Cursor rules filename):** `.cursor/rules/agentsync.mdc` is the documented example path used by AgentSync for Cursor rules. You may use a different `.mdc` filename/path if you configure it explicitly under your `[agents.<name>.targets.*]` entries.
218+
219+
| Agent | Rules File(s) | MCP Configuration / Notes | Skills Support / Location |
220+
| :--- | :--- | :--- | :--- |
217221
| Gemini CLI | `GEMINI.md` | `.gemini/settings.json` (native MCP, adds `"trust": true`) | Configurable; `.gemini/skills/` |
218-
| Junie | - | No native MCP formatter; `.junie/` ignore | Configurable |
219-
| AugmentCode | - | No native MCP formatter; `.augment/rules/` ignore | Configurable |
220-
| Kilo Code | - | No native MCP formatter; `.kilocode/mcp.json` ignore | Configurable |
222+
| Junie | - | `.junie/` ignore | Configurable |
223+
| AugmentCode | - | `.augment/rules/` ignore | Configurable |
224+
| Kilo Code | - | `.kilocode/mcp.json` ignore | Configurable |
221225
| OpenCode | `OPENCODE.md` | `opencode.json` (native MCP) | Configurable; `.opencode/skills/` |
222-
| Goose | - | No native MCP formatter; `.goosehints` ignore | Configurable |
223-
| Qwen Code | - | No native MCP formatter; `.qwen/settings.json` ignore | Configurable |
224-
| RooCode | - | No native MCP formatter; `.roo/mcp.json`, `.roo/rules/`, `.roo/skills/` ignores | Configurable |
225-
| Zed | - | No native MCP formatter; `.zed/settings.json` ignore | Configurable |
226-
| Trae AI | - | No native MCP formatter; `.trae/rules/` ignore | Configurable |
227-
| Warp | `WARP.md` | No native MCP formatter | Configurable |
228-
| Kiro | - | No native MCP formatter; `.kiro/steering/`, `.kiro/settings/mcp.json` ignores | Configurable |
229-
| Firebender | - | No native MCP formatter; `firebender.json` ignore | Configurable |
230-
| Factory Droid | - | No native MCP formatter; `.factory/mcp.json`, `.factory/skills/` ignores | Configurable |
231-
| Mistral Vibe | - | No native MCP formatter; `.vibe/config.toml`, `.vibe/skills/` ignores | Configurable |
232-
| JetBrains AI Assistant | - | No native MCP formatter; `.aiassistant/rules/` ignore | Configurable |
226+
| Goose | `.goosehints` | `.goosehints` ignore | Configurable |
227+
| Qwen Code | - | `.qwen/settings.json` ignore | Configurable |
228+
| RooCode | - | `.roo/mcp.json`, `.roo/rules/`, `.roo/skills/` ignores | Configurable; `.roo/skills/` |
229+
| Zed | - | `.zed/settings.json` ignore | Configurable |
230+
| Trae AI | - | `.trae/rules/` ignore | Configurable |
231+
| Warp | `WARP.md` | `WARP.md` ignore | Configurable |
232+
| Kiro | - | `.kiro/steering/`, `.kiro/settings/mcp.json` ignores | Configurable |
233+
| Firebender | - | `firebender.json` ignore | Configurable |
234+
| Factory Droid | - | `.factory/mcp.json`, `.factory/skills/` ignores | Configurable; `.factory/skills/` |
235+
| Mistral Vibe | - | `.vibe/config.toml`, `.vibe/skills/` ignores | Configurable; `.vibe/skills/` |
236+
| JetBrains AI Assistant | - | `.aiassistant/rules/` ignore | Configurable |
233237

234238
### What "configurable" means in practice
235239

0 commit comments

Comments
 (0)