CLI Commands

Complete reference for every equip command, flag, and option.

Global flags

Flag	Description
`--local`	Operate on project-local skills instead of global
`--agent <id>`	Target specific agents (comma-separated IDs)
`--all`	Target all 18 agents regardless of detection
`--json`	Machine-readable JSON output
`--version`	Print version
`--help`	Print help

install

Install a skill from a GitHub repo, git URL, or local path.

equip install <source> [options]

Source formats

Format	Example
GitHub shorthand	`equip install owner/repo`
GitHub with subpath	`equip install owner/repo/path/to/skill`
Git URL	`equip install https://github.com/user/repo.git`
Local path	`equip install ./my-skill`

Options

Flag	Description
`--local`	Install to project-local scope
`--agent <id>`	Install to specific agents only
`--all`	Install to all 18 agents

Examples

$ equip install anthropics/skill-creator
✓ Installed skill-creator to 3 agents
  → claude-code, cursor, windsurf

$ equip install ./my-skill --local --agent claude
✓ Installed my-skill to 1 agent (project-local)

remove

Remove a skill from all agents. Alias: uninstall.

equip remove <name> [options]

Options

Flag	Description
`--local`	Remove from project-local scope
`--agent <id>`	Remove from specific agents only

Examples

$ equip remove skill-creator
✓ Removed skill-creator from 3 agents

$ equip uninstall my-skill --local

update

Pull the latest version from source. Updates all skills or a specific one.

equip update [name] [options]

Options

Flag	Description
`--local`	Update project-local skills
`--json`	JSON output

Examples

$ equip update
✓ Updated skill-creator (1 file changed)
  ✓ frontend-design is up to date

$ equip update skill-creator

list

Show installed skills and which agents have them.

equip list [options]

Options

Flag	Description
`--long`	Include full descriptions
`--local`	List project-local skills
`--json`	JSON output

Examples

$ equip list
  skill-creator       3 agents  ✓ up to date
  frontend-design     3 agents  ✓ up to date

$ equip list --long
  skill-creator       3 agents  ✓ up to date
    Create new skills, modify and improve existing skills
  frontend-design     3 agents  ✓ up to date
    Create production-grade frontend interfaces

search

Search the registry of 180,000+ indexed skills.

equip search <query> [options]

Options

Flag	Description
`--sort <field>`	Sort by: `relevance` (default), `installs`, `name`
`--limit <n>`	Number of results (default: 10)
`--json`	JSON output

Examples

$ equip search "commit" --sort installs
  commit                Create conventional commits         ⬇ 2,841
  commit-push-pr        Commit, push, and open a PR          ⬇ 1,204
  git-workflow          Git branching and merge strategies    ⬇   892

outdated

Check for upstream or local changes without applying them.

equip outdated [name] [options]

Options

Flag	Description
`--local`	Check project-local skills
`--json`	JSON output

survey

Scan for duplicates, version mismatches, unmanaged skills, and sprawl.

equip survey [options]

Options

Flag	Description
`--local`	Survey project-local skills only
`--path <dir>`	Scan a directory tree for skills
`--fix`	Interactively fix issues
`--json`	JSON output

Examples

$ equip survey
  Duplicates:
    commit — found in claude, cursor (different versions)
  Unmanaged:
    ~/.cursor/skills/old-skill/ (no equip metadata)

$ equip survey --fix
  Fix duplicate "commit"? [y/N]

$ equip survey --path ~/dev

init

Link to a sync backend for cross-machine sync. See Cross-Machine Sync.

equip init [repo] [options]

Options

Flag	Description
`--path <dir>`	Use a file path backend instead of GitHub
`--protocol <ssh\|https>`	Git protocol for GitHub backend

export

Push your skill manifest to the sync backend.

equip export [options]

Options

Flag	Description
`--output <file>`	Export to a local file instead of the backend

restore

Install all skills from the sync backend on a new machine.

equip restore [options]

Options

Flag	Description
`--from <file>`	Restore from a local file instead of the backend
`--dry-run`	Preview without installing

status

Show sync state: what's synced, missing, or untracked.

equip status

agents

Generate an AGENTS.md file listing all project skills.

equip agents [options]

Options

Flag	Description
`--output <file>`	Custom output filename (default: `AGENTS.md`)

config

View and modify equip settings. See Configuration for details.

equip config [key] [value]

Examples

$ equip config                         # Show all settings
$ equip config projects_path ~/dev     # Set a value
$ equip config projects_path unset     # Clear a value
$ equip config telemetry off           # Disable telemetry