CLI Commands

CLI Commands

Complete CLI command reference.

---

Global Options

-v, --verbose    # Set log level to debug
-q, --quiet      # Set log level to error
--version        # Show version
--help           # Show help

Commands

init

Initialize aistack project.

npx @blackms/aistack init
npx @blackms/aistack init --path ./myproject

agent

Agent management commands.

# Spawn
npx @blackms/aistack agent spawn -t coder -n my-coder

# List
npx @blackms/aistack agent list

# Stop
npx @blackms/aistack agent stop -i <id>
npx @blackms/aistack agent stop -n <name>

# Status
npx @blackms/aistack agent status -i <id>

# Types
npx @blackms/aistack agent types

# Run (spawn + execute)
npx @blackms/aistack agent run -t coder -p "Write a function"

# Execute (existing agent)
npx @blackms/aistack agent exec -i <id> -p "Refactor this"

memory

Memory operations.

# Store
npx @blackms/aistack memory store -k "key" -c "content" -n "namespace"

# Search
npx @blackms/aistack memory search -q "query" -n "namespace" -l 10

mcp

MCP server commands.

# Start server
npx @blackms/aistack mcp start
npx @blackms/aistack mcp start --verbose

web

Web dashboard commands.

# Start web server
npx @blackms/aistack web start
npx @blackms/aistack web start --port 3001

plugin

Plugin management.

# Add plugin
npx @blackms/aistack plugin add ./my-plugin

# List plugins
npx @blackms/aistack plugin list

# Remove plugin
npx @blackms/aistack plugin remove my-plugin

workflow

Workflow commands.

# Run workflow
npx @blackms/aistack workflow run doc-sync
npx @blackms/aistack workflow run doc-sync --docs ./docs --src ./src

status

Show system status.

npx @blackms/aistack status

---

Related:

• Quick Start Tutorial
• Configuration Guide