CLI Reference
The mcp-cli command provides project onboarding, session lifecycle management, memory inspection, and observability reporting. The published package also exposes mcp-ai-agent-guidelines as the MCP stdio server entrypoint for editors and MCP hosts.
# Run via npx / npm exec (no install required)npx --yes --package mcp-ai-agent-guidelines@latest mcp-cli [command]
# Or after global installmcp-cli [command]
# Or after local installnode dist/cli-main.js [command]Global Options
Section titled “Global Options”| Option | Description |
|---|---|
-v, --verbose | Enable verbose output |
--version | Print version |
--help | Show help |
onboard — Project Setup
Section titled “onboard — Project Setup”onboard init
Section titled “onboard init”Run the interactive onboarding wizard. Guides you through model configuration, skill surface selection, and MCP client setup. Skips automatically if configuration already exists.
mcp-cli onboard initonboard status
Section titled “onboard status”Show the current onboarding status and active configuration.
mcp-cli onboard statusonboard reset
Section titled “onboard reset”Reset configuration. Removes session and memory state and re-runs the wizard.
mcp-cli onboard resetorchestration — Model Configuration
Section titled “orchestration — Model Configuration”Manage model routing via orchestration.toml without editing the file directly.
orchestration config read
Section titled “orchestration config read”Print the current orchestration.toml as JSON.
mcp-cli orchestration config readorchestration config write
Section titled “orchestration config write”Update a specific role in orchestration.toml.
mcp-cli orchestration config write --role strong_primary --model claude-sonnet-4-5memory — TOON Context
Section titled “memory — TOON Context”memory list
Section titled “memory list”List all memory artifacts and TOON snapshots.
mcp-cli memory listmemory show <id>
Section titled “memory show <id>”Print a specific memory artifact by ID.
mcp-cli memory show <session-id>status — Server Info
Section titled “status — Server Info”Print version, loaded skills, active flags, and model router state.
mcp-cli statusdocs:* — Documentation Scripts
Section titled “docs:* — Documentation Scripts”These npm scripts delegate to the docs/ Starlight site.
npm run docs:dev # Start dev server at localhost:4321npm run docs:build # Build static site to docs/dist/npm run docs:preview # Preview built site locallyMCP Server Entry Point
Section titled “MCP Server Entry Point”The MCP server itself (not the CLI) is started with:
node dist/index.jsThis speaks MCP over stdin/stdout and is what your MCP client (Copilot, Claude Desktop, etc.) invokes.