Vantage Agent

AI coding agent with per-tool permissions, cost tracking, prompt optimization, and anomaly detection. Works across Claude (API), Claude Code, Codex CLI, and Gemini CLI.

Install

pip install vantageai-agent

Requires Python 3.9+.

Quick Start

Interactive REPL

# Set your API key, then launch
export ANTHROPIC_API_KEY=sk-...
vantageai-agent

One-shot prompt

vantageai-agent "explain the main function in cli.py"

Pipe mode

echo "summarize this file" | vantageai-agent

Backends

Vantage auto-detects the best backend. You can override with --backend:

vantageai-agent --backend claude "refactor this function"
vantageai-agent --backend codex "write unit tests for auth.py"

Auto-detect priority: VANTAGE_BACKEND env → ANTHROPIC_API_KEY → claude binary → codex binary → gemini binary.

Session Management

Sessions are persisted to ~/.vantage/sessions/. Resume any previous session:

# List sessions and costs
vantageai-agent summary

# Resume by session ID
vantageai-agent --resume abc12345

REPL Commands

Cost Tracking

Every turn shows token usage and cost. Exit shows a full session summary:

  +----- Cost Summary -----+
  Model:             claude-sonnet-4-6
  Input tokens:      1,234
  Output tokens:     456
  Cost:              $0.0123
  Session total:     $0.0456
  Prompts:           3
  +-------------------------+

For Claude Code / Codex / Gemini (subscription or free tier), costs are labeled ~$0.00 (free tier) or ~$0.0123 (estimated).

VantageAI Dashboard

Send telemetry to your VantageAI dashboard for cross-session cost analysis:

export VANTAGE_API_KEY=vnt_...
vantageai-agent

Or pass inline: vantageai-agent --vantage-key vnt_...

All Flags

vantageai-agent [OPTIONS] [PROMPT]

  PROMPT              One-shot prompt (omit for interactive REPL)

  --backend           api | claude | codex | gemini (auto-detected)
  --model             Model ID (default: claude-sonnet-4-6)
  --max-tokens        Max output tokens (default: 16384)
  --resume SESSION_ID Resume a previous session
  --api-key           Anthropic API key (or ANTHROPIC_API_KEY env)
  --vantage-key       VantageAI dashboard API key (or VANTAGE_API_KEY env)
  --system            Custom system prompt
  --no-optimize       Disable prompt optimization
  --cwd               Set working directory
  --debug             Enable debug output

Environment Variables

License

MIT