Cohrint 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 cohrint-agent

Requires Python 3.9+.

Quick Start

Interactive REPL

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

One-shot prompt

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

Pipe mode

echo "summarize this file" | cohrint-agent

Backends

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

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

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

Session Management

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

# List sessions and costs
cohrint-agent summary

# Resume by session ID
cohrint-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).

Cohrint Dashboard

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

export COHRINT_API_KEY=crt_...
cohrint-agent

Or pass inline: cohrint-agent --cohrint-key crt_...

All Flags

cohrint-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)
  --cohrint-key       Cohrint dashboard API key (or COHRINT_API_KEY env)
  --system            Custom system prompt
  --no-optimize       Disable prompt optimization
  --cwd               Set working directory
  --debug             Enable debug output

Environment Variables

License

MIT