Skip to main content

​
Introduction

The Terramind CLI is a powerful command-line interface for interacting with AI models directly from your terminal. It provides an intuitive way to get AI assistance for coding tasks, generate code, debug issues, and more.

​
Basic Usage

​
Interactive Mode

Start an interactive session where you can have a conversation with the AI: 
terramind
In interactive mode, you can:
  • Ask questions and get immediate responses
  • Have multi-turn conversations with context
  • Execute commands and see results
  • Switch between different AI models

​
Single Command Mode

Execute a single command and exit: 
terramind run "your prompt here"
This is useful for:
  • Quick one-off tasks
  • Scripting and automation
  • CI/CD pipelines
  • Integration with other tools

​
Command Structure

All Terramind commands follow this structure: 
terramind [command] [options] [arguments]

​
Global Options

These options work with any command:
  • --model <model> - Specify which AI model to use
  • --help - Show help information
  • --version - Display version information
  • --debug - Enable debug mode for troubleshooting

​
Common Workflows

​
Code Generation

terramind run "Create a React component for a user profile card"

​
Code Explanation

terramind run "Explain this code: $(cat myfile.ts)"

​
Debugging

terramind run "Debug this error: TypeError: Cannot read property 'map' of undefined"

​
Refactoring

terramind run "Refactor this function to use async/await instead of promises"

​
Working with Projects

Terramind understands your project context: 
# Navigate to your project directory
cd /path/to/your/project

# Start Terramind
terramind

# Now Terramind can access and modify files in your project
The CLI will automatically:
  • Read your project structure
  • Respect .gitignore files
  • Access file contents when needed
  • Make changes to files with your permission

​
Model Selection

Choose the right model for your task: 
# Use Claude Sonnet 4.5 (default, best for most tasks)
terramind run "your prompt" --model claude-sonnet-4-5

# Use GPT-5 for alternative perspective
terramind run "your prompt" --model gpt-5

# Use Claude Haiku for faster responses
terramind run "your prompt" --model claude-haiku-4-5
Different models have different strengths. Claude Sonnet excels at code generation, while GPT-5 is great for reasoning tasks.

​
Session Management

Terramind maintains conversation context across your session:
  • Each interactive session remembers the conversation history
  • Context is preserved until you exit
  • You can reference previous messages and responses
  • File changes are tracked within the session

​
Output Control

Control how Terramind displays output: 
# Verbose output with detailed explanations
terramind run "your prompt" --verbose

# Minimal output (just the result)
terramind run "your prompt" --quiet

# JSON output for scripting
terramind run "your prompt" --format json

​
Next Steps

All Commands

Complete reference of all CLI commands

Configuration

Customize Terramind settings