Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 17 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -298,18 +298,19 @@ These marketplace names auto-resolve to their GitHub repos:

### Supported Clients

| Client | Skills | Agent File | Hooks | Commands |
|--------|--------|------------|-------|----------|
| claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
| copilot | `.agents/skills/` | `AGENTS.md` | No | No |
| codex | `.agents/skills/` | `AGENTS.md` | No | No |
| cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
| opencode | `.agents/skills/` | `AGENTS.md` | No | No |
| gemini | `.agents/skills/` | `GEMINI.md` | No | No |
| factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
| ampcode | `.agents/skills/` | `AGENTS.md` | No | No |

> **Note:** Clients supporting the universal `.agents/` folder (copilot, codex, opencode, gemini, ampcode) share the same skills directory. Commands are a Claude-specific feature.
| Client | Skills | Agent File | Hooks | Commands | GitHub Overrides |
|--------|--------|------------|-------|----------|------------------|
| claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` | No |
| copilot | `.agents/skills/` | `AGENTS.md` | No | No | `.github/` |
| codex | `.agents/skills/` | `AGENTS.md` | No | No | No |
| cursor | `.cursor/skills/` | `AGENTS.md` | No | No | No |
| opencode | `.agents/skills/` | `AGENTS.md` | No | `.opencode/commands/` | No |
| gemini | `.agents/skills/` | `GEMINI.md` | No | No | No |
| factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No | No |
| ampcode | `.agents/skills/` | `AGENTS.md` | No | No | No |
| vscode | `.agents/skills/` | `AGENTS.md` | No | No | `.github/` |

> **Note:** Clients supporting the universal `.agents/` folder (copilot, codex, opencode, gemini, ampcode, vscode) share the same skills directory. GitHub overrides (`.github/prompts/`, `copilot-instructions.md`) are copied to Copilot/VSCode's `.github/` folder.

## Marketplace Structure

Expand Down Expand Up @@ -337,9 +338,12 @@ my-plugin/
├── skills/ # Skill directories with SKILL.md (all clients)
│ └── debugging/
│ └── SKILL.md
├── commands/ # Command files (.md) - Claude only
├── commands/ # Command files (.md) - Claude, OpenCode
│ ├── build.md
│ └── deploy.md
├── .github/ # GitHub overrides (Copilot, VSCode)
│ └── prompts/
│ └── review.md
├── hooks/ # Hook files (Claude/Factory only)
│ └── pre-commit.md
└── AGENTS.md # Agent configuration (optional)
Expand Down
3 changes: 2 additions & 1 deletion docs/src/content/docs/guides/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ Plugins are packages of AI tooling that can be shared across projects and client
my-plugin/
├── plugin.json
├── skills/ # Cross-client skills
├── commands/ # Claude-specific commands
├── commands/ # Commands (Claude, OpenCode)
├── .github/ # GitHub overrides (Copilot, VSCode)
└── AGENTS.md
```

Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/guides/workspaces.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ my-workspace/
│ ├── workspace.yaml # Workspace configuration
│ └── sync-state.json # Tracks synced files (auto-generated)
├── .claude/
│ └── commands/ # Claude-specific commands (from plugins)
│ └── commands/ # Claude commands (from plugins)
├── AGENTS.md # Agent instructions (auto-copied from template)
└── CLAUDE.md # Claude-specific instructions (optional)
```
Expand Down
26 changes: 13 additions & 13 deletions docs/src/content/docs/reference/clients.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,22 +5,22 @@ description: AI coding assistant clients supported by AllAgents.

## Client Comparison

| Client | Skills | Agent File | Hooks | Commands |
|--------|--------|------------|-------|----------|
| Claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
| Copilot | `.agents/skills/` | `AGENTS.md` | No | `.github/prompts/` |
| Codex | `.agents/skills/` | `AGENTS.md` | No | No |
| Cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
| OpenCode | `.agents/skills/` | `AGENTS.md` | No | `.opencode/commands/` |
| Gemini | `.agents/skills/` | `GEMINI.md` | No | No |
| Factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
| Amp Code | `.agents/skills/` | `AGENTS.md` | No | No |
| VSCode | `.agents/skills/` | `AGENTS.md` | No | `.github/prompts/` |
| Client | Skills | Agent File | Hooks | Commands | GitHub Overrides |
|--------|--------|------------|-------|----------|------------------|
| Claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` | No |
| Copilot | `.agents/skills/` | `AGENTS.md` | No | No | `.github/` |
| Codex | `.agents/skills/` | `AGENTS.md` | No | No | No |
| Cursor | `.cursor/skills/` | `AGENTS.md` | No | No | No |
| OpenCode | `.agents/skills/` | `AGENTS.md` | No | `.opencode/commands/` | No |
| Gemini | `.agents/skills/` | `GEMINI.md` | No | No | No |
| Factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No | No |
| Amp Code | `.agents/skills/` | `AGENTS.md` | No | No | No |
| VSCode | `.agents/skills/` | `AGENTS.md` | No | No | `.github/` |

:::note
Skills are the cross-client way to share reusable prompts.
Skills are the cross-client way to share reusable prompts. GitHub overrides (`.github/prompts/`, `copilot-instructions.md`) are copied to the workspace's `.github/` folder for Copilot/VSCode.
:::

### VSCode

VSCode syncs the same skills, agent file, and commands as Copilot. Additionally, adding `vscode` to `clients` triggers automatic `.code-workspace` file generation and MCP config syncing during `workspace sync`. See the [Workspaces guide](/guides/workspaces/#vscode-workspace-generation) for details.
VSCode syncs the same skills, agent file, and GitHub overrides as Copilot. Additionally, adding `vscode` to `clients` triggers automatic `.code-workspace` file generation and MCP config syncing during `workspace sync`. See the [Workspaces guide](/guides/workspaces/#vscode-workspace-generation) for details.
2 changes: 1 addition & 1 deletion src/core/transform.ts
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ function getMapping(client: ClientType, options?: { clientMappings?: Record<stri

/**
* Copy commands from plugin to workspace for a specific client
* Commands are a Claude-specific feature (only claude client supports them)
* Commands are copied to clients that support commandsPath
* @param pluginPath - Path to plugin directory
* @param workspacePath - Path to workspace directory
* @param client - Target client type
Expand Down
2 changes: 1 addition & 1 deletion src/models/client-mapping.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import type { ClientType } from './workspace-config.js';
* Client-specific path and file configuration
*/
export interface ClientMapping {
/** Path for commands (Claude-specific feature) */
/** Path for commands (Claude, OpenCode) */
commandsPath?: string;
skillsPath: string;
agentsPath?: string;
Expand Down