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:
Initial setup from catalogs- configuremodels,MCP servers,skills, and asandboxonce; agents pick from what you connected. Presets come from shipped YAML catalogs you can customize.Any model provider- OpenAI, Anthropic, Google Gemini, and other catalog providers, or any OpenAI-compatible endpoint.** MCP tools**- remote MCP servers with header auth or OAuth, including in-chat authorization.** Skills**- git-backedSKILL.md
instruction packs, loaded on demand in the sandbox.Sandbox as a tool- isolated code/file execution (Daytona today; more providers planned), provisioned only when needed. Secrets stay in the harness.Human checkpoints- tool approval, ask-user-questions, and Generative UI in chat.** Context engineering**- subagents, deferred tool , Code Mode, large-result off, and compaction.** Chat UI + SDK**- use the bundled UI, automate with@truefoundry/trueforge-sdk
, or embed@truefoundry/trueforge-ui
.
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.
| Mode | Best for | Storage | Extra infra | How to run |
|---|---|---|---|---|
| Local | Personal use, trying it out | SQLite | None | npx @truefoundry/trueforge |
| Hosted | Teams, multi-replica | Postgres | Postgres + Redis | Docker Compose or Helm |
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 |
|---|---|
QuickstartInitial SetupCreate an AgentHarness CapabilitiesSetup LoginBenchmarkingSDKChat UI@truefoundry/trueforge-ui
API ReferenceWe 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](https://discord.com/invite/fHeGRvakb)- Founder emails:
[abhishek@truefoundry.com](mailto:abhishek@truefoundry.com)/[anuraag@truefoundry.com](mailto:anuraag@truefoundry.com)
TrueForge is released under the MIT License.