पवन — Self-healing CLI coding agent

Pawan (पवन) is a Rust-native CLI coding agent. Named after Power Star Pawan Kalyan — martial artist, Telugu cinema icon, Deputy CM of Andhra Pradesh. That energy: raw power, cult following, fearless execution. It reads, writes, and heals code autonomously — no subscription, no vendor lock-in. Built for the dirmacs ecosystem, works with any OpenAI-compatible API.

• Self-hosted — runs on your own machine, uses your own API keys
• 17 tools — file ops, search, bash, git (status/diff/add/commit/log/blame/branch/checkout/stash), sub-agents
• 18 subcommands — from interactive TUI to headless scripting
• 107 tests — markdown rendering, API error handling, CLI parsing, git tools, integration
• Streaming TUI — ratatui with markdown rendering, vim keybindings, live token display
• AI workflows — commit, review, explain, test analysis, watch mode

# Clone and build
git clone https://github.com/dirmacs/pawan && cd pawan
cargo install --path crates/pawan-cli

# Set API key (NVIDIA NIM free tier)
export NVIDIA_API_KEY=nvapi-...

# Interactive TUI
pawan

# AI-powered commit (stage + generate message + commit)
pawan commit -a

# Self-heal: fix errors, warnings, test failures
pawan heal

# AI code review of current changes
pawan review

# Explain a file or concept
pawan explain src/lib.rs

# Run tests and AI-analyze failures
pawan test --fix

# Headless scripted execution
pawan run "add input validation to the config parser"

# Watch mode: auto-heal on file changes
pawan watch --interval 10

# Check setup
pawan doctor

pawan/
  crates/
    pawan-core/    # Library: agent engine, 17 tools, config, healing
    pawan-cli/     # Binary: CLI + ratatui TUI + AI workflows
    pawan-mcp/     # MCP client (rmcp 0.12, stdio transport)
    pawan-aegis/   # Aegis config resolution

pawan-core has zero internal dependencies — it works standalone with any OpenAI-compatible API.

Pawan loads config in priority order: CLI flags > env vars > pawan.toml > defaults

# Environment variables
export PAWAN_MODEL=qwen/qwen3.5-397b-a17b
export PAWAN_PROVIDER=nvidia    # nvidia | ollama | openai
export PAWAN_TEMPERATURE=0.8
export PAWAN_MAX_TOKENS=8192

# pawan.toml
provider = "nvidia"
model = "mistralai/devstral-2-123b-instruct-2512"
temperature = 1.0
max_tokens = 8192

[mcp.daedra]
command = "daedra"
args = ["serve", "--transport", "stdio", "--quiet"]

Add PAWAN.md to your project root for per-project context (like CLAUDE.md).

• Markdown rendering: headers, bold, italic, code, code blocks with dark bg, bullets, numbered lists, blockquotes
• Streaming tokens (appear as they arrive)
• Tool execution progress (start/complete notifications)
• Vim keybindings: / search, n/N next/prev, g/G top/bottom, Ctrl+u/d half-page
• Token usage tracking in status bar
• Mouse scroll support

MIT