ErforgeCli 0.3.0

Erforge CLI

An agentic AI-powered coding assistant for your terminal, built in C#/.NET 10. Full feature parity with Claude Code CLI — reads, writes, edits files, searches codebases, executes commands, spawns sub-agents, manages sessions, loads skills, and integrates with MCP servers.

Features

• Agentic tool calling — AI decides which tools to call and iterates until the task is complete
• 8 built-in tools — Read, Write, Edit, MultiEdit, Glob, Grep, Bash, LS
• 28 slash commands — /help, /review, /refactor, /analyze, /plan, /compact, /think, and more
• Sub-agents — Spawn parallel isolated agents (explore, task, code-review, general-purpose)
• Session persistence — SQLite-backed with checkpoint save/restore
• Skills & Hooks — Extensible SKILL.md/ERFORGE.md loading, lifecycle hooks
• Extended thinking — Toggle with /think, keywords (think hard, ultrathink)
• MCP client — Model Context Protocol for external tool integration
• Multiple AI providers — Ollama (local, free), Anthropic (Claude), and OpenAI (GPT) with direct API access
• Permission system — Granular allow/deny per tool with interactive prompts

Quick Start

# Build
dotnet build ErforgeCli.sln

# Test (417 tests)
dotnet test ErforgeCli.sln

# Run with Ollama (local, free, no API key needed)
ollama pull qwen2.5:14b-instruct-q4_K_M
dotnet run --project src/ErforgeCli -- -p "Explain what a mutex is"

# Run with Anthropic
$env:ANTHROPIC_API_KEY = "sk-ant-..."
dotnet run --project src/ErforgeCli -- -p "Explain what a mutex is"

# Run with OpenAI
$env:OPENAI_API_KEY = "sk-..."
dotnet run --project src/ErforgeCli -- --provider openai -p "Hello"

# Interactive REPL
dotnet run --project src/ErforgeCli

See QuickStart.md for full setup instructions, all CLI flags, slash commands, and keyboard shortcuts.

Architecture

src/ErforgeCli/
├── Agents/          Agent loop, sub-agents, context
├── Commands/        28 slash commands
├── Configuration/   Options, ConfigManager
├── Hooks/           Lifecycle hooks
├── Mcp/             MCP client
├── OutputStyles/    Default, Explanatory, Learning
├── Permissions/     Permission manager, prompts
├── Providers/       Anthropic + OpenAI providers
├── Repl/            REPL host, renderers, input
├── Sessions/        SQLite session store
├── Skills/          Skill loader, markdown skills
├── Thinking/        Extended thinking mode
└── Tools/           8 built-in tools

Technology Stack

• .NET 10, System.CommandLine, Spectre.Console
• SQLite + Dapper for local state
• xUnit + Moq + FluentAssertions for testing