TrueForge – The open-source agent harness

The open-source agent harness - the runtime layer that turns an LLM into a working agent

TrueForge runs the agent execution loop for you - model calls, MCP tools, skills, sandboxing, approvals, context management, and session state - and exposes it three ways: a chat UI , an HTTP API with a TypeScript SDK , and an embeddable UI SDK .

Building an agent is easy. Running one well is not - you need streaming, session persistence, tool servers, sandboxing, approvals, and a UI. TrueForge gives you that out of the box:

It scales down and up: local mode (one process, SQLite) or hosted mode (Postgres + Redis, Docker Compose or Helm).

Run TrueForge (local, Docker Compose, or Kubernetes), connect a model and tools, and build your first reusable agent in the Quickstart .

To work on TrueForge from this repository, see CONTRIBUTING.md .

Local mode is for your machine only. It is a convenient way to try TrueForge — not a production or internet-facing setup. There is no login by default, and data lives in a local SQLite file. Please keep it on localhost. We cannot take responsibility for data loss or unauthorized access if local mode is used beyond that. For a shared or production deployment, use hosted mode.

Section What you'll find Introduction What an agent harness is and how TrueForge fits together Quickstart Run local or hosted, build your first agent Initial Setup Models, MCP, skills, sandbox - catalogs and overrides Create an Agent Select resources; tool approval, questions, Generative UI Harness Capabilities Sandbox-as-tool, subagents, deferred tools, Code Mode, compaction Setup Login Optional OIDC for shared deployments Benchmarking Cost/accuracy vs Claude Managed Agents and deepagents SDK TypeScript client: sessions, turns, events Chat UI Bundled UI and embedding @truefoundry/trueforge-ui API Reference OpenAPI paths and schemas Benchmarks We compare TrueForge against Claude Managed Agents and deepagents on the same tasks, tools, and model - same accuracy, lower cost. Reproduce it from benchmark/ . Write-up: Benchmarking .

We love contributions - bug reports, features, and docs fixes. See CONTRIBUTING.md and our Code of Conduct . Fork PRs should change source only; maintainers regenerate the SDK after merge.

To report a security vulnerability, follow SECURITY.md instead of opening a public issue.

Community Discord Founder emails: abhishek@truefoundry.com / anuraag@truefoundry.com License TrueForge is released under the MIT License .