AI Terminal CLI

ai_terminal.py is a Click-based terminal tool that can call Anthropic (Claude) or Google Gemini, with a mock mode for demos that avoids real API usage.

Setup

1. Create a virtual environment (recommended) and install dependencies:

pip install -r requirements.txt

2. Copy env.example to .env and fill in your keys:

ANTHROPIC_API_KEY=your_claude_api_key
GEMINI_API_KEY=your_gemini_api_key
DEFAULT_PROVIDER=claude
DEFAULT_MODEL_CLAUDE=claude-4.5-opus-latest
DEFAULT_MODEL_GEMINI=gemini-3-pro-latest
TIMEOUT_SECONDS=30

Usage

Run the CLI by passing your prompt as an argument (multi-word prompts are fine):

python ai_terminal.py "Summarize the latest AI trends."

Switch providers

# Use Gemini with default model from .env
python ai_terminal.py --provider gemini "Give me a 2-line haiku."

# Override the model explicitly
python ai_terminal.py --provider claude --model claude-4.5-opus-latest "Explain transformers in one paragraph."

Mock mode (no real API calls)

python ai_terminal.py --mock "Demo the flow without spending credits."

Timeouts

python ai_terminal.py --timeout 15 "Keep this request under 15 seconds."

Exit codes:

• 0 success
• 1 config or provider selection errors
• 2 timeouts
• 3 unexpected errors

Notes

• Defaults read from .env; CLI flags override env values.
• Mock mode is available via --mock or by selecting --provider mock.