Overview

Forge is a terminal-based autonomous AI coding agent that runs locally on the operator's machine. It connects to any OpenAI-compatible endpoint, to Anthropic and ChatGPT Codex via OAuth against existing Claude Pro and ChatGPT Plus subscriptions, or to local model servers such as LM Studio, Ollama, llama.cpp, and vLLM. No mandatory cloud, no per-token billing on top of an existing subscription, no telemetry.

The agent is built around a small Rust core and a terminal UI, and is designed to be readable and tailorable rather than feature-maximal. The codebase is intentionally small enough that an operator can read it, understand what the agent is doing, and modify it when their workflow demands something a vendor wouldn't ship.

Capabilities

  • Tool surface

    File read and write, unified-diff patching, code search, glob, shell execution through a streaming PTY path, web search and fetch, structured user questions, and a custom shell-backed tool interface that loads from ~/.config/forge/tools/ or project-local .agent/tools/.

  • Parallel subagents

    Bounded subagent delegation with independent context windows, per-agent tool allowlists, configurable concurrency and depth, and rolling-window fallback on context overflow.

  • Planning mode

    Plans are drafted, reviewed, and approved before any write or execute action runs.

  • Context management

    Two strategies: model-backed structured compaction, or rolling window. Configurable thresholds. Custom live file slot handling reduces context waste from repeated file reads in multi-file work.

  • Session persistence and revert

    Sessions are logged to .forge/sessions/{id}/conversation.jsonl and can be resumed. Revert is Git-backed: workspace state is snapshotted at turn boundaries and can be restored together with conversation history.

  • Safety model

    Approval-based command gating, not host isolation. Forge is a sharp tool: once a tool is approved or auto-approval is enabled, it runs with the same access as the user account that launched it. The project root is the default working directory, not a sandbox. This boundary is documented in the architecture notes.

Project log

  • Project page expanded

    Forge's project page now describes the agent's capability surface ahead of the public release push. Repository and documentation links remain pending until the public push lands.

  • Project page established

    Forge now has a project page and Git-backed project log source. Detailed changelogs can remain in the repository when public.

Documents

  • Repository

    Pending public link.

  • Documentation

    Pending public documentation.

  • Inquiries

    [email protected]