Agent + Goal on — the chat carries an objective. omp's hidden
goal tool is switched on for this chat, so the objective, its status (active / paused / complete) and its spend are remembered between messages and steer them, instead of every message starting fresh.It does not run by itself. Every turn still starts when you send something — omp only auto-continues goals in its own terminal UI, not here.
Plan is the third mode and cannot be on at the same time: it writes a plan without executing it.
⚙️ One quick install and you're ready
Agent Pi needs its AI engine - pick one below and it installs itself automatically (no terminal, nothing to configure). Not sure? Take the recommended one. You can add or switch engines later in Settings.
⚙️ Preferences
How engines are chosen
⚡ Agent Pi API
One key for everything — no provider signups, no keys to manage.Until then, use Subscriptions for plan logins you already have, API Keys for your own provider keys, or Local Models to run offline.
🔐 Subscription Logins
Sign in to your coding subscriptions via browser OAuth. Tokens are stored in omp's credential vault and used automatically across all engines.🔷 Claude (Pro / Max)
🤖 Codex / OpenAI
🪐 Antigravity / Gemini
🔐 Other Supported Subscriptions (66 Providers)
🔑 Bring Your Own Keys (BYOK)
Enter your personal or organization API keys for direct, unmetered access to providers. Keys are stored encrypted on this machine only.🔐 Key storage security
🖥️ Local Model Runtimes
Connect local AI servers running on your machine via their standard OpenAI-compatible/v1 endpoint. No API key or account needed./v1 API — LM Studio (port 1234), Ollama (port 11434), llama.cpp / llama-server (Unsloth GGUFs, port 8000), vLLM, LocalAI. Give it a port; there is no account and nothing to sign into.🧪 Free WebApp Proxy Gateway · AI WebApp Harness
Unified Web2API proxy utilizing browser session tokens & cookies for free web tiers (DeepSeek, ChatGPT, Claude, Gemini, Grok, Qwen/Kimi/GLM).• Account Ban Risk: Providers actively enforce Terms of Service and may apply temporary rate limits or permanent account bans.
• Best Practice: ALWAYS use dedicated throwaway / burner accounts. Never use primary personal, work, or billing accounts.
• Breaking Changes: Upstream web frontends change without notice. Use the "Sync Upstream Repositories" button below to pull fixes when a provider breaks.
🖥️ Tools & shells the AI can use
These are the apps and shells Agent Pi found on your computer - the AI uses them to run things for you. Just installed something? Click Rescan. Missing something you want? Click Install.
⚡ Performance
Changes require app restart to take full effect.
💾 Conversation cache
Cached conversations open instantly. Old entries are evicted automatically once the cache passes the size cap.
🚀 Server auto-start
When enabled, the Agent Pi server will start automatically when you log into your computer. The server registers the login entry itself - no browser extension required.
🧠 Agent memory & folder search
Gives every saved agent a private long-term memory and its own searchable index of the folder it works in. Nothing leaves your computer - it runs in three local Docker containers. Agents work fine without it; this only adds recall.
📊 Usage & Efficiency
Measured across your recent conversations - tokens, prompt-cache hit rate, how often context is compacted, what tool output costs, and flags for anything that looks wrong.
📡 Integrations
Connect external automation services. Agent Pi holds the credentials server-side (encrypted at rest) so they never appear in prompts.
Tools
⚛ Extensions & MCPs
Installed and switched on. The trigger on each row decides when it actually runs.
🔗 MCP Servers
MCP (Model Context Protocol) servers give the agent access to external tools - databases, browsers, APIs, and more. Enable a server here to make its tools available in all chats. MCPs that require configuration must be set up and validated before they work.
Configure
📝 Custom Prompt
Role & custom instructions are injected at the top of every message the agent receives. (Skills now have their own panel - the 🧩 Skills button.)
📈 Capability usage
🧩 Skills
Install a skill to make it available to the agent. Use the ⚡ Skills menu in the header to activate skills for a specific chat.
⚙ Node
⛓ Run
🤖 Save this chat as an agent
🤖 Edit Agent
👥 New Agent Team
Describe the team in plain words and the AI sets it up. Every setting stays yours to change.
How the Team Runsmode, schedule, limits, lead, stop rule
Drag nodes to arrange · drag the canvas to pan · scroll to zoom.
🔀
🩺 Connection doctor
Sign in to Agent Pi
🧑🤝🧑 Run in parallel
Two ways to work in parallel: let the assistant split big jobs on its own, or list specific tasks to run at the same time. Up to 8 at once.
⚠️ Helpers can run commands on their own in this folder.
🔍 Search
Tags
Select working folder
~/.pi/repos/ and is reused across sessions.You can still type
owner/repo above to clone a public repo.