CLI Reference

Questi contenuti non sono ancora disponibili nella tua lingua.

The Soleri CLI (@soleri/cli) manages agent creation, development, and maintenance.

Install

The CLI is available via npx (no install needed) or as a dev dependency:

npx @soleri/cli <command>

Commands

create

Scaffold a new agent project.

npx @soleri/cli create [name]

Options:

Flag	Description
`[name]`	Agent name (prompted if omitted)

Interactive wizard prompts for: agent name, role, domains, persona voice.

Example:

npx @soleri/cli create sentinel
# or use the npm create shorthand:
npm create soleri sentinel

list

Show agents in a directory.

npx @soleri/cli list [dir]

Scans for agent projects and displays ID, domains, and build status.

dev

Run agent locally in development mode with auto-rebuild.

npx @soleri/cli dev

Starts the MCP server via stdio transport. Watches for file changes and restarts automatically.

test

Run agent test suite.

npx @soleri/cli test [options]

Options:

Flag	Description
`--watch`	Re-run tests on file changes
`--coverage`	Generate coverage report

Runs vitest under the hood. For the monorepo-level E2E test suite, use npm run test:e2e from the project root. See Testing for full details.

add-domain

Add a knowledge domain to your agent.

npx @soleri/cli add-domain <domain>

Creates a new domain facade with 5 ops (get_patterns, search, get_entry, capture, remove) and regenerates the agent’s facade registry.

Example:

npx @soleri/cli add-domain security
npx @soleri/cli add-domain infrastructure

install-knowledge

Import a knowledge bundle into the agent’s vault.

npx @soleri/cli install-knowledge <path>

Accepts a directory or JSON file containing knowledge entries.

Example:

npx @soleri/cli install-knowledge ./bundles/react-patterns

doctor

System health check.

npx @soleri/cli doctor

Reports:

Node.js version compatibility
npm status
Agent context (detected project)
Vault health
CLAUDE.md status
Recommendations for fixes

hooks

Manage editor hooks for quality gates.

npx @soleri/cli hooks add <editor>
npx @soleri/cli hooks remove <editor>
npx @soleri/cli hooks list
npx @soleri/cli hooks add-pack <pack>

Editors: claude-code, cursor, vscode, neovim

Hook Packs:

Pack	Hooks included
`full`	All 8 quality gates
`minimal`	Core safety hooks only

Quality gate hooks: no-console-log, no-any-types, no-important, no-inline-styles, semantic-html, focus-ring-required, ux-touch-targets, no-ai-attribution.

governance

View or set vault governance policies.

npx @soleri/cli governance [options]

Options:

Flag	Description
`--preset <name>`	Apply a preset: `strict`, `moderate`, `permissive`
`--show`	Display current governance settings

extend

Manage agent extensions — custom ops, facades, and middleware.

npx @soleri/cli extend <subcommand>

Subcommands:

Subcommand	Description
`init`	Initialize `src/extensions/` directory
`add-op <name>`	Scaffold a custom op (snake_case, e.g. `summarize_pr`)
`add-facade <name>`	Scaffold a custom facade (kebab-case, e.g. `github`)
`add-middleware <name>`	Scaffold a middleware (kebab-case, e.g. `audit-logger`)

Examples:

npx @soleri/cli extend init
npx @soleri/cli extend add-op summarize_pr
npx @soleri/cli extend add-facade github
npx @soleri/cli extend add-middleware audit-logger

See Extending Your Agent for full documentation.

install

npx @soleri/cli install

Adds the agent to ~/.claude.json so Claude Code discovers it on startup. Run from inside your agent directory.

uninstall

Remove your agent’s MCP server registration.

npx @soleri/cli uninstall

Removes the entry from ~/.claude.json.

pack

Unified pack manager for hooks, skills, knowledge, and domains.

npx @soleri/cli pack <subcommand> [options]

Subcommands:

Subcommand	Description
`list`	List available packs
`install`	Install a pack
`uninstall`	Remove a pack
`validate`	Validate a pack before installing

Options:

Flag	Description
`--type <type>`	Pack type: `hooks`, `skills`, `knowledge`, `domains`

skills

Manage agent skills (convenience wrapper for pack --type skills).

npx @soleri/cli skills [subcommand]

Lists, installs, or removes skill packs for your agent.

agent

Agent lifecycle management.

npx @soleri/cli agent <subcommand>

Subcommands:

Subcommand	Description
`status`	Show agent status and configuration
`update`	Update agent to latest engine
`diff`	Show differences from latest scaffold

upgrade

Check for and perform CLI upgrades.

npx @soleri/cli upgrade [options]

Options:

Flag	Description
`--check`	Check for updates without installing

See Customizing Your Agent for detailed configuration guides. For API operations, see API Reference and Capabilities. If something isn’t working, check Troubleshooting.