CLI Commands

​

Core Commands

​

terramind

terramind [options]

• --model <model> - Specify AI model to use
• --cwd <directory> - Set working directory

terramind --model claude-sonnet-4-5

​

terramind run

terramind run <prompt> [options]

• <prompt> - The prompt or question for the AI

• --model <model> - Specify AI model
• --format <format> - Output format (text, json)

terramind run "Write a Python function to calculate fibonacci numbers"
terramind run "Explain how async/await works" --model gpt-5

​

terramind auth

terramind auth [options]

• --token <token> - Firebase authentication token
• --api-key <key> - Terramind API key

terramind auth --api-key your_api_key_here

​

terramind models

terramind models [options]

• --json - Output in JSON format
• --filter <category> - Filter by model category

terramind models
terramind models --filter claude

Available Models:
  claude-sonnet-4-5      Claude Sonnet 4.5 (Latest)
  claude-sonnet-4        Claude Sonnet 4
  claude-haiku-4-5       Claude Haiku 4.5 (Fast)
  gpt-5                  GPT-5
  gpt-5-codex            GPT-5 Codex (Code-specialized)
  ...

​

Agent Client Protocol

​

terramind acp

terramind acp [options]

• --cwd <directory> - Set working directory
• --port <port> - Specify port (default: stdio)

terramind acp --cwd /path/to/project

​

Development Commands

​

terramind serve

terramind serve [options]

• --port <port> - Port number (default: 3000)
• --host <host> - Host address (default: localhost)

terramind serve --port 8080

​

terramind web

terramind web [options]

• --port <port> - Port for web server (default: 3000)
• --open - Automatically open in browser

terramind web --port 8080 --open

​

Utility Commands

​

terramind upgrade

terramind upgrade [options]

• --check - Only check for updates
• --force - Force upgrade even if already up to date

terramind upgrade
terramind upgrade --check

​

terramind stats

terramind stats [options]

• --period <period> - Time period (day, week, month)
• --format <format> - Output format (text, json)

terramind stats --period week

​

terramind export

terramind export [options]

• --output <file> - Output file path
• --format <format> - Export format (json, markdown)

terramind export --output conversation.json --format json

​

terramind import

terramind import <file> [options]

• <file> - File to import

terramind import conversation.json

​

GitHub Integration

​

terramind github

terramind github <action> [options]

• pr - Create or review pull requests
• issue - Manage issues

terramind github pr --review

​

MCP Integration

​

terramind mcp

terramind mcp <action> [options]

• list - List configured MCP servers
• add - Add a new MCP server
• remove - Remove an MCP server

terramind mcp list
terramind mcp add --name myserver --command "node server.js"

​

Debug Commands

​

terramind debug

terramind debug <command> [options]

• logs - View application logs
• config - Display current configuration
• clear-cache - Clear application cache

terramind debug logs
terramind debug clear-cache

​

Global Options

• --help, -h - Show help information
• --version, -v - Display version
• --debug - Enable debug mode
• --no-color - Disable colored output
• --config <file> - Use custom config file

terramind run "your prompt" --debug --no-color

​

Environment Variables

• TERRAMIND_API_KEY - API key for authentication
• TERRAMIND_MODEL - Default model to use
• TERRAMIND_CONFIG_PATH - Custom config file location
• TERRAMIND_LOG_LEVEL - Logging level (error, warn, info, debug)

export TERRAMIND_API_KEY=your_key_here
export TERRAMIND_MODEL=claude-sonnet-4-5
terramind run "your prompt"

​

Next Steps