docs(agents): add Prime Agent page - #335
Open
OndrejDrapalik wants to merge 1 commit into
Open
Conversation
Document running Prime Agent (PrimeIntellect-ai/prime-agent) in an E2B sandbox via the pre-built `prime` template: CLI, headless `-p` runs, cloned-repo example, `--mode json` event stream, session management, and building a custom template on top. Adds the Prime Intellect mark as images/icons/prime.svg and the nav entry after docs/agents/pi.
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
OndrejDrapalik
marked this pull request as ready for review
August 6, 2026 18:57
matthewlouisbrockman
approved these changes
Aug 6, 2026
matthewlouisbrockman
left a comment
matthewlouisbrockman
left a comment
Contributor
There was a problem hiding this comment.
lgtm - think that someone pointed out that the /agents in the docs section is getting big, we're gonna need to figure out how to chunk that up but outside the scope of this PR
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a docs page for Prime Agent, Prime Intellect's open-source coding and research agent (MIT, persistent IPython kernel + recursive subagents).
docs/agents/prime.mdx— new pageimages/icons/prime.svg— Prime Intellect mark, dark rounded-square treatment matchingpi.svgdocs.json— nav entry afterdocs/agents/piPage follows the
grok.mdx/amp.mdxshape exactly: intro → CLI → Run headless (+ sandbox-isolation<Note>) → cloned-repo example → Streaming JSON → Session management → Build a custom template → Related guides.Why
Prime Agent has no approval prompts and no auto-approve flag — it executes model-generated Python and project commands with the permissions of the user it runs as. Upstream's README says this outright and recommends running it in an external sandbox, so E2B is the vendor-endorsed way to run it unattended. The
<Note>is adapted from grok/amp accordingly (they describe an auto-approve flag, which Prime Agent doesn't have).Slug choice
agents/prime, title "Prime Agent". Sibling pages are named after the template (grok,amp,pi), and the template isprime.Template status
primetemplate is currently org-internal (US prod). The public naked alias lands with the customer-starter-templates PR + Orbit promotion — separate track. This page should not be merged until the template is public, hence draft.Verified against upstream (
PrimeIntellect-ai/prime-agent@main)-p,--print= "Print response and exit" (docs/usage.md, Modes table)--mode json/--mode rpc; JSONL event names and shapes (toolName,message.role,agent_end.messages, leading{"type":"session",...}header) —docs/json.md--provider <name>,--model <pattern>—docs/usage.md, Model Options-c/--continue,-r/--resume [path|id],prime-agent agents,attach <agent>—docs/usage.md, Session Options + Shell CommandsANTHROPIC_API_KEY,OPENAI_API_KEY,GEMINI_API_KEY,XAI_API_KEY,OPENROUTER_API_KEY,PRIME_API_KEY—docs/providers.md/loginfirst-run flow (Claude Pro/Max, ChatGPT Plus/Pro, GitHub Copilot) —docs/quickstart.mdNot yet verified — please flag if you disagree
prime-agent -c -p "..."in the Session management example. Both flags are documented, but upstream never shows them combined. Should be confirmed with a live run; fallback is-r <id> -p "...".--mode jsonwith a positional prompt undercd /home/user/repo— upstream showsprime-agent --mode json "prompt"; the example prependscd, same as the amp page. Worth one live run.