--- title: "Prime Agent Overview" type: concept tags: [overview, rlm, foundational, well-established, user] created: 2026-08-06 updated: 2026-08-06 sources: ["raw/github_doc-readme-md.md", "raw/github_doc-packages-coding-agent-docs-index-md.md", "raw/github_doc-agents-md.md"] confidence: high prime_agent_version: "v0.7.0" --- ## Definition Prime Agent is Prime Intellect's open-source coding and research agent, subtitled in its own README "A Self-Improving RLM Agent." It is "an open-source coding and research agent for general and long-running work," distributed as a terminal coding agent with a TUI, an embeddable SDK, and a daemon-backed background-worker model. The project began as a hard fork of [pi-mono](https://github.com/badlogic/pi-mono) but, per its documentation index, "Prime Agent is now the product, CLI, install source, and development repository," and it sits alongside Prime Intellect's other RL-research projects — Verifiers, PRIME-RL, and pi-mono — as part of the same ecosystem. ## How It Works The README states Prime Agent "is designed around two core abstractions": - The **Recursive Language Model (RLM)** — "treats context as variables (*prompt-as-a-variable*) and tools like recursive subagents as function calls (*programmatic tool /sub-agent calling*) inside a persistent REPL." See [[concepts/rlm]]. - The **Continual Harness** (arXiv:2605.09998) — "stores supplemental prompts, memories, skill descriptions, and reusable subagent specifications as durable state that Prime Agent can refine through small, evidence-backed updates, local to the session by default." "Prime Agent combines a persistent Python control environment with durable harness state, so useful working context and reusable operating patterns can outlive a single chat window." The "self-improving" framing comes from the harness side of this pair: `/refine` "reviews the current trajectory and can apply small, evidence-backed updates to supplemental harness state. It never rewrites the immutable base system prompt, and recorded snapshots support rollback." This is refinement of durable *operating state* (prompts, memories, skill descriptions, subagent specs), not retraining of the underlying model. The README's condensed summary of the design: - "Everything is programmatic:" persistent IPython is the built-in model tool; file operations, shell commands, tool use, subagents, and context management happen through code. - "Subagents are built in:" `rlm(...)` spawns real child agents for parallel or background work and returns their results programmatically. - "The harness can improve:" `/refine` applies small, evidence-backed updates to supplemental harness state. - "Skills are executable:" skills are importable Python packages, and a built-in skill creator can turn recurring workflows into skills. - "Sessions run in the background:" daemon-backed agents keep running when the terminal disconnects and can be reattached later. - "Agents communicate directly:" running agents can exchange messages and orchestrate one another. - "Long tasks keep moving:" automatic compaction, persistent goals, heartbeats, schedules, autonomous mode, and retained subagents preserve progress across turns and terminal sessions. The documentation index describes Prime Agent as "an RLM-native coding and research harness built around a persistent IPython kernel, recursive subagents, durable sessions, and a multi-process local runtime." ## Key Parameters - Documented current stable release: `v0.7.0` (this wiki's `prime_agent_version`). - Single built-in model tool: `ipython`. - License: MIT (`LICENSE`, README "License" section). - Built on top of `pi` (earendil-works/pi); the README's Acknowledgements section states "Our agent and TUI is built on top of [`pi`]... We thank the authors of `pi` for their valuable work." - Ecosystem links given directly in the README header: [Verifiers](https://github.com/PrimeIntellect-ai/verifiers), [PRIME-RL](https://github.com/PrimeIntellect-ai/prime-rl), [pi-mono](https://github.com/badlogic/pi-mono). - `AGENTS.md` (development rules) organizes issues with `pkg:*` labels for the monorepo's packages: `pkg:agent`, `pkg:ai`, `pkg:coding-agent`, `pkg:tui` — corresponding to the four core packages covered in [[concepts/architecture]]. ## When To Use Per the README's "Built for Long-Running Work" section, Prime Agent "is built for long-running work, especially for evaluations in research." It is intended for both interactive, everyday coding assistance (terminal TUI) and for unattended or long-horizon work via its daemon-backed sessions, goals, heartbeats, schedules, and bounded autonomous mode. See [[concepts/long-running-agents]] and [[concepts/quickstart-and-usage]]. ## Risks & Pitfalls The README carries an explicit warning: "Prime Agent executes model-generated Python and project commands with your user permissions. Its worker and kernel processes improve lifecycle isolation and recovery; they are **not** a security sandbox. Review changes and use trusted repositories, instructions, skills, and extensions only. Run untrusted code or instructions in an external sandbox or restricted environment." The README also recommends using "a disposable clone, clean worktree, or another checkpoint you can inspect and restore" before letting Prime Agent modify a working directory. ## Related Concepts - [[concepts/rlm]] — the Recursive Language Model programming model that Prime Agent is built around. - [[concepts/rlm-runtime]] — the concrete runtime that executes the RLM loop. - [[concepts/architecture]] — the packages/monorepo layout and system topology. - [[concepts/quickstart-and-usage]] — install, first run, and the day-to-day usage loop. - [[concepts/long-running-agents]] — the daemon-backed model for long/autonomous tasks. ## Sources - raw/github_doc-readme-md.md - raw/github_doc-packages-coding-agent-docs-index-md.md - raw/github_doc-agents-md.md