AgentRun Open-Source Platform Lets Agents Self-Improve Across Runs
AgentRun is an open-source platform that layers self-improvement, durable execution and a control plane on top of existing agent harnesses such as Claude Code, Codex, OpenCode and pi. After each run the agent retains notes, skills or workflows so the next run starts from prior results, cutting repeated discovery and token spend. All run state lives in a single store, allowing runs to resume after a server restart.
Full Report
Contents4 sections
Run smarter agents. Use fewer tokens.
Quickstart · Tour · Templates · Deploy · Docs
AgentRun is an open-source platform that supercharges your agents. It adds self-improvement, durable execution and a control plane on top of your favorite agent harness. Your agents become smarter, more fault tolerant and use fewer tokens with every run.
An agent's Learning tab: what it kept, and what changed since. Demo data from the console's recorded fixtures.
Why AgentRun
Agents are great at figuring things out. The problem is they figure out the same things over and over. Give an agent a job it has done a hundred times and it rediscovers the same API, rereads the same docs and rebuilds the same plan, and you pay for every token of it.
Bring your agent on the harness it runs best on: Claude Code, Codex, OpenCode or pi. AgentRun does everything around it:
- It learns the work. After each run, the agent keeps what will help next time: a note, a skill, or a workflow that does the job without the loop. The next run starts from there.
- It never loses a run. Every run lives in one store. Kill the server mid-run, start it again, and the run carries on. Give each agent the computer the job needs: a sandbox, a Linux desktop, an Android phone or a browser.
- You stay in control. Approvals, spend caps and one console for every agent: what needs you, what failed, what's running and what it cost.
You don't build the plumbing: provider integrations, recovery, run tracking and learning are all here. Run it on your laptop with one command, in one container, or as a server with runners. Apache-2.0.
Start in three steps
You need Node 24.22.3 or newer, on macOS or Linux.
- Start it.
npx @parcha/agentrunIt starts the server and one runner on port 7340 (or the next free one), keeps everything in ~/.agentrun, and
opens the console in your browser.
-
Add one model key. In the console, set a password, then add a key under Settings → Model keys. One
OPENROUTER_API_KEYgives every harness a model. An Anthropic key runs pi and Claude Code; an OpenAI key runs pi, Codex and OpenCode. -
Run your first agent. Open Templates, apply KYB due diligence, and start a run with a company's name and website. It needs nothing but your model key. When it finishes, the run's Report tab has a due diligence report with a verdict and every claim cited. Then open the agent's Learning tab to see what it kept for next time.
Rather have your coding agent do it? Tell it: Read agentrun.ai/SKILL.md and set up AgentRun for me.
If Docker is running on your machine, new agents get a Docker sandbox with a shell. Its image builds on first use, which takes a few minutes, and the console says when it's ready. Without Docker, agents still read and write files, but get no shell.
Want your own server with a URL? Deploy it to Render in one click.
</details>Take the tour
Workflows that make the call. A step can ask a fast typed question, see how sure the answer is, and pick a route. Here the model leans approve at 0.61, below the workflow's 0.75 bar, so the case goes to review.
Every agent in one place. Mission Control opens first: what needs you, what failed, what's running and what it cost, by day, by harness and by tool.
Every agent is an API. Start a run from the Playground, then copy the same request into your code.
You stay in control. An agent can stop and ask you, and the run waits until you answer.
Agents that learn the work
Turn it on with "learning": true in an agent's definition. At the end of every run, the agent gets one more turn to
say what it would keep. AgentRun checks it, grades it, and commits the keepers to the agent's own git folder. The next
run starts from there.
- Notes are short markdown files, one fact each, in Claude Code's memory format.
- Skills are how to do a job again, and only a run that finished the job can write one.
- Learned workflows run as one tool call on any harness, under the run's own cap and tool permissions. Once a learned skill has served 3 runs, the next run is asked for that job as a workflow draft, and a draft is dry-run before it's kept: no model is asked and no tool runs.
The agent's Learning tab shows every note, skill and workflow and the log of changes, and each run shows which
notes it was given and opened. Retire anything there, or with npx @parcha/agentrun learning retire and the note's
ETag. Git keeps the history, so a retired note can come back.
Each agent has a learning folder: plain git with one branch, main. A run reads the index of active notes in its
instructions and gets the learned skills beside its own. Code checks every proposal first. An item that breaks a rule of
its own (a size or count limit, its name, its shape) is left out and the rest goes on. A secret or a hidden character
anywhere in the answer, a file outside the folder, a deletion or a full index drops the whole answer, since no item of
it can be trusted. Then one grader judges what it says, and AgentRun commits what passes. A risky rule waits for your
OK. A rule the run found in a page or a pasted email, or a note that holds an account number, is dropped.
Once an agent's notes outgrow the learning budget, each run gets the ones that bear on its first message, whole, and a line for each of the rest. A run that only ran a learned workflow isn't asked what to keep.
</details>(注:更多技术实现细节与完整 API 文档请查阅原项目 README)
作者发帖说明(HN):
We (GREP.AI, YC F26) are open-sourcing AgentRun and turning it into a full managed agents platform. Read more about it in this post: https://agentrun.ai/blog/introducing-agentrun-run-smarter-ag....
It includes what we originally built for our own agent harness:
- Self-improving agents - Web-grounded workflows - A range of sandboxes and computer environments - Thousands of tools and integrations - Detailed analytics on how your agents behave
You can bring your own agent. AgentRun works with Pi, Claude Agents, Codex, OpenCode, and any other harness that supports ACP.
You can self-host it (see 1-click install on Render) with an OpenRouter key, or try the hosted version at console.agentrun.ai.
We’d love feedback, especially on the architecture (see README), or anything we may be missing to make it useful to you.