Skip to main content

​
Core Commands

​
terramind

Start an interactive AI coding session. 
terramind [options]
Options:
  • --model <model> - Specify AI model to use
  • --cwd <directory> - Set working directory
Example: 
terramind --model claude-sonnet-4-5

​
terramind run

Execute a single AI command. 
terramind run <prompt> [options]
Arguments:
  • <prompt> - The prompt or question for the AI
Options:
  • --model <model> - Specify AI model
  • --format <format> - Output format (text, json)
Examples: 
terramind run "Write a Python function to calculate fibonacci numbers"
terramind run "Explain how async/await works" --model gpt-5

​
terramind auth

Configure authentication credentials. 
terramind auth [options]
Options:
  • --token <token> - Firebase authentication token
  • --api-key <key> - Terramind API key
Example: 
terramind auth --api-key your_api_key_here
Get your API key from terramind.com.

​
terramind models

List all available AI models. 
terramind models [options]
Options:
  • --json - Output in JSON format
  • --filter <category> - Filter by model category
Example: 
terramind models
terramind models --filter claude
Output: 
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

Start an ACP (Agent Client Protocol) server for editor integration. 
terramind acp [options]
Options:
  • --cwd <directory> - Set working directory
  • --port <port> - Specify port (default: stdio)
Example: 
terramind acp --cwd /path/to/project
See the ACP Integration guide for editor setup.

​
Development Commands

​
terramind serve

Start the Terramind server for programmatic access. 
terramind serve [options]
Options:
  • --port <port> - Port number (default: 3000)
  • --host <host> - Host address (default: localhost)
Example: 
terramind serve --port 8080

​
terramind web

Launch the web interface. 
terramind web [options]
Options:
  • --port <port> - Port for web server (default: 3000)
  • --open - Automatically open in browser
Example: 
terramind web --port 8080 --open

​
Utility Commands

​
terramind upgrade

Upgrade Terramind to the latest version. 
terramind upgrade [options]
Options:
  • --check - Only check for updates
  • --force - Force upgrade even if already up to date
Example: 
terramind upgrade
terramind upgrade --check

​
terramind stats

Display usage statistics and costs. 
terramind stats [options]
Options:
  • --period <period> - Time period (day, week, month)
  • --format <format> - Output format (text, json)
Example: 
terramind stats --period week

​
terramind export

Export conversation history. 
terramind export [options]
Options:
  • --output <file> - Output file path
  • --format <format> - Export format (json, markdown)
Example: 
terramind export --output conversation.json --format json

​
terramind import

Import conversation history. 
terramind import <file> [options]
Arguments:
  • <file> - File to import
Example: 
terramind import conversation.json

​
GitHub Integration

​
terramind github

Interact with GitHub repositories. 
terramind github <action> [options]
Actions:
  • pr - Create or review pull requests
  • issue - Manage issues
Example: 
terramind github pr --review

​
MCP Integration

​
terramind mcp

Manage Model Context Protocol servers. 
terramind mcp <action> [options]
Actions:
  • list - List configured MCP servers
  • add - Add a new MCP server
  • remove - Remove an MCP server
Example: 
terramind mcp list
terramind mcp add --name myserver --command "node server.js"

​
Debug Commands

​
terramind debug

Access debugging utilities. 
terramind debug <command> [options]
Commands:
  • logs - View application logs
  • config - Display current configuration
  • clear-cache - Clear application cache
Example: 
terramind debug logs
terramind debug clear-cache

​
Global Options

These options work with any command:
  • --help, -h - Show help information
  • --version, -v - Display version
  • --debug - Enable debug mode
  • --no-color - Disable colored output
  • --config <file> - Use custom config file
Example: 
terramind run "your prompt" --debug --no-color

​
Environment Variables

Configure Terramind behavior with 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)
Example: 
export TERRAMIND_API_KEY=your_key_here
export TERRAMIND_MODEL=claude-sonnet-4-5
terramind run "your prompt"

​
Next Steps

Configuration

Learn how to customize Terramind

AI SDK Provider

Use Terramind in your applications