aix add

Installs skills, MCP servers, rules, prompts, agents, hooks, plugins, or marketplaces to user editor config by default. ai.json is optional. Pass --project to target project editor config, and pass --save to also write the item to ai.json (or ai.local.json).

--target <editor> / -t limits the operation to named editors and can be repeated. --no-install is only useful with --save; it writes the config entry without installing it.

Commands

`aix add skill`

aix add skill <source> [flags]

Flags:

--name <name> / -n: Override skill name.
--ref <ref> / -r: Git branch/tag/commit.
--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user or project editor config.
--save / -s: Also save the item to ai.json.

Sources:

react (npm package aix-skill-react)
@scope/pkg
github:user/repo
owner/repo/path-to-skill
https://github.com/org/repo/tree/main/skills/my-skill
https://github.com/org/repo/blob/main/skills/my-skill/SKILL.md
./local/path

aix add skill stores native aix skill references in ai.json and installs skills through aix’s own resolver/installer flow. Skills are copied into .aix/skills/{name}/, then symlinked into editors with native skill support.

`aix add mcp`

aix add mcp <name> [flags]

If no command/url is provided, it searches the registry.

Flags:

--command <cmd>: Command to run (stdio).
--args <args>: Command arguments.
--url <url>: HTTP/SSE URL.
--env <vars>: Environment variables (KEY=val,KEY2=val).
--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

`aix add rule`

aix add rule <source> [flags]

Flags:

--name <name> / -n: Rule name.
--activation <mode> / -a: always, auto, glob, or manual.
--globs <patterns> / -g: Glob patterns (comma separated).
--description <desc> / -d: Description for auto-activation.
--ref <ref> / -r: Git branch/tag/commit.
--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

`aix add prompt`

aix add prompt <source> [flags]

Flags:

--name <name> / -n: Prompt name.
--description <desc> / -d: Command description.
--argument-hint <hint>: Hint for user arguments.
--ref <ref> / -r: Git branch/tag/commit.
--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

`aix add agent`

aix add agent <source> [flags]

Adds a specialized agent to ai.json (or ai.local.json) and installs it to supported editors.

Flags:

--name <name> / -n: Agent name (inferred from filename if omitted).
--mode <mode> / -m: Agent mode: subagent (default) or primary.
--model <model>: Model alias or model ID.
--tools <tools>: Comma-separated list of tools available to the agent.
--description <desc> / -d: When this agent should be used.
--ref <ref> / -r: Git branch/tag/commit.
--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

Examples:

aix add agent ./agents/reviewer.md
aix add agent ./agents/reviewer.agent.md --mode primary
aix add agent github:org/agents/tester.md --model claude-3-7-sonnet --tools bash,edit

`aix add hook`

aix add hook <event> [flags]
aix add hook <source> [flags]

Pass a hook event name to describe the hook inline, or a path, URL, or npm/git reference to a JSON hook fragment. A new hook joins whatever is already registered for that event instead of replacing it.

Flags (event form):

--command <cmd>: Shell command to run when the event fires.
--url <url>: URL to POST the hook payload to (http action).
--prompt <text>: Prompt text for an LLM-evaluated hook.
--type <kind>: command, http, prompt, or agent. Inferred from the flag above when omitted.
--matcher <pattern> / -m: Pattern selecting which tools or actions the hook applies to.
--timeout <seconds>: Timeout in seconds.
--description <desc> / -d: Free-form description for the hook group.

Flags (fragment form):

--name <name> / -n: Fragment name, when it cannot be inferred from the source.
--ref <ref> / -r: Git branch/tag/commit.

Shared flags:

--no-install: Skip the install step after adding.
--local / -l: Add to ai.local.json.
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

Examples:

aix add hook pre_command --command "npm run lint"
aix add hook pre_file_write --matcher "Write|Edit" --command ./scripts/guard.sh
aix add hook agent_stop --prompt "Summarize what changed" --type agent
aix add hook ./hooks/guard.json

A fragment names its event alongside the actions:

{
   "event": "pre_file_write",
   "matcher": "Write|Edit",
   "hooks": [{ "command": "./scripts/guard.sh", "timeout": 10 }]
}

`aix add plugin`

aix add plugin <source> [flags]

Adds a plugin to target editors (and saves to ai.json with --save).

Flags:

--name <name> / -n: Plugin name or identifier override.
--marketplace <name> / -m: Marketplace name where plugin is published.
--save / -s: Also save the plugin to ai.json.
--no-install: Skip installing to editors after adding.
--local / -l: Add to ai.local.json.
--target <editor> / -t: Target specific editors (repeatable).
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

Examples:

aix add plugin code-review
aix add plugin code-review@claude-plugins-official
aix add plugin code-review --marketplace custom-market
aix add plugin ./plugins/local-plugin --name my-plugin

`aix add marketplace`

aix add marketplace <source> [flags]

Registers a plugin marketplace or catalog in ai.json.

Flags:

--name <name> / -n: Marketplace name (inferred from URL or repo if omitted).
--description <desc> / -d: Optional description of the marketplace.
--save / -s: Also save the marketplace to ai.json.
--no-install: Skip installing to editors after adding.
--local / -l: Add to ai.local.json.
--target <editor> / -t: Target specific editors (repeatable).
--scope <scope> / --user (-u) / --project (-p): Target user-level or project-level config.

Examples:

aix add marketplace https://github.com/anthropics/claude-plugins-official --name claude-plugins-official