✦        ✦        ✦

           ▓▓▓
           ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
         ▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒
         ▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒
           ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
             ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
               ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
                   ▓▓▓▓▓▓▓▓▓▓▓▓
                    ▓▓      ▓▓
                    ▓▓      ▓▓
                 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
               ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
             ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
           ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

AKMON

The AI coding agent built for developers who take security seriously.

local-first trust-first rust-native single binary full audit log no subscription
↓ Install Read the docs → GitHub
akmon — ~/my-project — claude-haiku — Anthropic
~/my-project $ akmon chat
▓▓▓▓ akmon v1.7.0 · ~/my-project · claude-haiku · Anthropic

You: find all places where authentication tokens are validated

→ semantic_search "token validation"
✓ semantic_search 3 results [Tab to expand]
→ read_file src/auth/middleware.rs
✓ read_file 287 lines

Akmon: Token validation happens in src/auth/middleware.rs.
The validate_jwt function at line 47 decodes Bearer
tokens using HS256 and checks expiry against Redis...

a1b2c3d4 · tokens:4,821 · cache:8,779 · ~$0.004 · step 3
Live preview
// unique to akmon

See the agent loop

Tool calls with permission boundaries, diffs before writes, JSONL audit, and real cost visibility— not a hosted black box. The preview below cycles through a typical turn (read → act → summarize).

akmon — live session preview

Step 1 — You steer; Akmon proposes tools.

// why akmon

Built different
by design

Hosted agents can change access, pricing, or terms on their timeline. Akmon is a binary you run, with your keys and your rules.

📋

Full audit trail

Every tool call, permission decision, and model response can be logged to a JSONL file—useful when you need a record of what the agent did.

🔒

Sandbox + SSRF protection

Files are constrained to your git root. Web requests block RFC1918 ranges and cloud metadata endpoints. API keys are zeroized in memory on drop.

⚙️

Single Rust binary

3.4MB with no runtime dependencies. Drop it in /usr/local/bin. Works over SSH. Works in Docker. Works in CI. No Node.js, no Python, no VS Code required.

🔑

BYOK — any provider

Ollama for free local inference. Anthropic, OpenRouter (500+ models), Groq, OpenAI, Azure, or Amazon Bedrock. You own the keys and the tool.

💰

Real cost transparency

Cache hits shown in green. Session cost in USD always visible. Exit summary shows exactly what was spent. No surprise bills, no opaque credit systems.

🔍

Diff before every write

Colored diff in the TUI after edits and before writes. Incremental edit / apply_patch flows keep responses small so the model is less likely to truncate mid-file.

Wondering how Akmon differs from other coding agents? Other tools vs Akmon — short notes in the docs, not a billboard here.

// get started

Install in seconds

GitHub Releases attach a real binary per platform. Writing to /usr/local/bin usually requires sudo on macOS — installing to ~/bin avoids that. If a download is HTML instead of a binary, the matching release asset is missing (cut a v* tag after the release workflow runs).

# Apple Silicon — M1, M2, M3, M4 (no sudo)
mkdir -p ~/bin
curl -L https://github.com/radotsvetkov/akmon/releases/latest/download/akmon-darwin-arm64 \
  -o ~/bin/akmon && chmod +x ~/bin/akmon
# If `akmon` is not found, add ~/bin to PATH (zsh):
# echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
# Alternative: sudo curl … -o /usr/local/bin/akmon && sudo chmod +x /usr/local/bin/akmon

akmon --version # akmon 1.7.0
akmon config # run setup wizard
mkdir -p ~/bin
curl -L https://github.com/radotsvetkov/akmon/releases/latest/download/akmon-darwin-x86_64 \
  -o ~/bin/akmon && chmod +x ~/bin/akmon

akmon --version
mkdir -p ~/bin
curl -L https://github.com/radotsvetkov/akmon/releases/latest/download/akmon-linux-x86_64 \
  -o ~/bin/akmon && chmod +x ~/bin/akmon

akmon --version
git clone https://github.com/radotsvetkov/akmon
cd akmon

# Slim build — 3.4MB, no semantic indexing
cargo build --release --no-default-features

# Full build — 20MB, with semantic indexing
cargo build --release

mkdir -p ~/bin
cp target/release/akmon ~/bin/
# 1. Install Ollama from https://ollama.com
ollama pull qwen2.5-coder:7b

# 2. Install Akmon (example: Apple Silicon → ~/bin)
mkdir -p ~/bin
curl -L https://github.com/radotsvetkov/akmon/releases/latest/download/akmon-darwin-arm64 \
  -o ~/bin/akmon && chmod +x ~/bin/akmon

# 3. Open any project
cd my-project
akmon chat # free, offline, private
// providers

Works with
every provider

One tool, any model. Set an environment variable and it works. No config files required to get started.

Ollama
Any local model. Llama, Qwen, DeepSeek, Mistral. Fully offline.
free
Anthropic
Claude Haiku, Sonnet, Opus. Direct API access with prompt caching.
BYOK
OpenRouter
500+ models. One key. Automatic provider failover. 5.5% platform fee.
BYOK
Groq
800+ tokens/second. Llama 3.3 70B. Fastest inference available.
BYOK
OpenAI
GPT-4o, GPT-4o-mini. Full tool use support.
BYOK
Azure OpenAI
Enterprise GPT-4o via Azure. Private networking, compliance support.
enterprise
Amazon Bedrock
Claude and Llama via AWS. Stays inside your VPC. SigV4 auth.
enterprise
Any OpenAI-compatible
LM Studio, Together AI, Mistral, DeepSeek, or your own endpoint.
BYOK
// trust model

You see
everything

Akmon logs every action to a JSONL audit file. Every session ends with a full summary—so you can see what ran, what it cost, and what changed.

  • 01

    Colored diff before every write

    See exactly what changes before approving. Green for additions, red for removals.

  • 02

    Per-session JSONL audit log

    Every tool call, permission verdict, and token usage logged with timestamps.

  • 03

    Exit summary with cost breakdown

    Sessions end with tool calls, files touched, cache savings, and USD cost.

  • 04

    Real-time cost in status bar

    Cache hit tokens shown in green. Session cost always visible.

session summary
Akmon session complete

Session
──────────────────────────────
ID a1b2c3d4
Duration 12m 34s
Model claude-haiku-4-5

Activity
──────────────────────────────
Messages 14
Tool calls 23
✓ Succeeded 22
✗ Failed 1
Files written 3

Tokens
──────────────────────────────
Input 48,291
Output 6,847
Cache hit 41,203 (85% savings)
Est. cost ~$0.047

.akmon/audit/a1b2c3d4.jsonl

Agent powering down. Goodbye!
// community

Built in the open

Akmon is Apache 2.0—friendly to shipping CLI wrappers, internal forks, and agent experiments. Issues, docs fixes, and focused PRs are welcome.

Contribute

Read the development setup, run tests with cargo test --workspace, and open a PR with a clear description.

Documentation

The book covers tutorials, capabilities, and automation patterns—help us keep examples sharp.

License

Apache 2.0 only. See license notes for why that fits agent tooling.

// get started

Ship with confidence.

The AI agent that respects your security, your budget, and your workflow. Single binary. No subscription. Every action audited.

↓ Install Akmon Read the docs → View on GitHub