Codemaster

AI-powered CLI coding assistant. Plan, execute, and chat — with multi-provider AI support.

npx codemaster-cli "explain this project"
npx codemaster-cli --interaction plan "add error handling"
npx codemaster-cli --provider openai --model gpt-4o "refactor the auth module"

Features

• 3 modes — :plan (AI plans), :exec (AI runs plan), :chat (free conversation)
• Multi-provider — Anthropic, OpenAI, Gemini, Ollama, Azure, OpenAI-compatible
• Agent loop — plans → executes → observes → reflects (Cursor-style)
• Safe — confirms file writes and commands (unless --mode auto)
• Slash commands — /edit, /explain, /test, /fix, /plan, /status, /cost
• Web fetch — AI can browse docs
• Git aware — status, diff, commit, log
• Cost tracking — token counts and cost per session

Install

npm install -g codemaster-cli
codemaster "what does this project do"

Usage

# Chat mode (default) — free conversation with AI
codemaster "explain the architecture"

# Plan mode — AI generates a plan, you review
codemaster --interaction plan "add user authentication"

# Execute mode — AI runs the plan step by step
codemaster --interaction exec "fix the type errors"

# Interactive — tab between modes with :plan, :exec, :chat
codemaster

Providers

| Provider | Flag | Env var | |----------|------|---------| | Anthropic | --provider anthropic | ANTHROPIC_API_KEY | | OpenAI | --provider openai | OPENAI_API_KEY | | Gemini | --provider gemini | GEMINI_API_KEY | | Ollama | --provider ollama | (local) | | Azure | --provider azure | AZURE_OPENAI_API_KEY | | Mock | --provider mock | (none needed) |

Flags

--mode <m>           safe | assisted | auto
--interaction <m>    plan | exec | chat
--provider <p>       anthropic | openai | gemini | ollama | azure | mock
--model <name>       model name (auto-detects provider)
--base-url <url>     custom API endpoint