wikis / Prime Agent / wiki / concepts / prime-agent-overview.md view as markdown report a mistake

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 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 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, PRIME-RL, 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 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 long running agents and 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

• rlm — the Recursive Language Model programming model that Prime Agent is built around.
• rlm runtime — the concrete runtime that executes the RLM loop.
• architecture — the packages/monorepo layout and system topology.
• quickstart and usage — install, first run, and the day-to-day usage loop.
• 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