Every agent works with the same project: your files, the text prepared from difficult formats, search, and bounded file operations. You choose where the agent runs.
In the app: Chat
The agent picker in the Chat composer offers four agents.
| Runtime | Needs | Account |
|---|---|---|
| Default Agent | Nothing to install; fallback when you cannot use Claude Code, Codex or Antigravity | StashBase sign-in; free credits that refresh every month |
| Claude Code | The Claude Code CLI | Your Anthropic subscription or API key |
| Codex | The Codex CLI | Your ChatGPT sign-in |
| Antigravity | The Antigravity CLI | Your Google account |
Use Default Agent as a fallback if you cannot use Claude Code, Codex or Antigravity. It sends prompts and necessary context through StashBase’s hosted model gateway. Its credits do not cover search by meaning, which requires your own OpenAI or OpenRouter key.
For more Default Agent credits, open Settings → Agents → Plans and billing or visit Pricing. Sign in on the website with the same StashBase account as the app. Stripe handles checkout and subscription management. Paid plans renew monthly, and their credits refresh with each renewal, without rollover. Pro includes ten times the credits of Plus. The first time you add a card, your first month of Plus is free. Changing plans preserves usage in the current billing period. Cancel in Manage subscription to keep paid access through the paid period.
Claude Code, Codex and Antigravity use your existing provider account. When one is not connected yet, StashBase shows Connect Claude, Connect Codex or Connect Antigravity, sets it up and opens its sign-in if it needs one. StashBase wires their MCP connection during that setup, so nothing needs to be pasted. Settings → Agents shows each installed runtime’s version and an Update button. Antigravity asks before changing files or running commands, like the others, and offers Auto, Ask, Edit and Plan.
Scope and instructions
- Each chat belongs to one project, and its agent works within that project. Wiki work is optional and runs only when you ask for it.
- Type
@to insert a file or folder path. - Persona in the composer sets who the agent is when it talks and
writes in that chat. How the agent works belongs in your own
AGENTS.mdorCLAUDE.md; StashBase never creates or rewrites them. - Tool calls and file edits show in the Chat for review.
External MCP clients
Any MCP-capable client can use your projects while StashBase is running. Open Settings → Advanced → External apps (MCP), copy the JSON configuration from the Command tab, and register it in the client:
- Claude Desktop: paste the JSON snippet into its config file and restart.
- Claude Code in a terminal:
claude mcp add stashbase -- ~/.stashbase/bin/stashbase-mcp(%USERPROFILE%\.stashbase\bin\stashbase-mcp.cmdon Windows). - Codex CLI: add the same command under
[mcp_servers.stashbase]in~/.codex/config.toml. - Antigravity CLI: add the same command under
mcpServers.stashbasein~/.gemini/config/mcp_config.json. - Server-side clients that cannot launch a local command: the URL tab in the same settings shows a Streamable HTTP URL and bearer token.
The client gets list_projects, search_project, reindex, and file
helpers that work only inside the projects you opened in StashBase. MCP is
not a general filesystem interface. The
MCP configuration reference
covers Docker access, ports, and token rotation.
Which one?
- Drafting, revising and building a Wiki from inside the app: Claude Code, Codex or Antigravity with your existing provider account; Default Agent is a fallback.
- Coding in a terminal with your projects as extra context: Claude Code, Codex or Antigravity with the MCP server added.
- Chatting in Claude Desktop or another app: connect it over MCP. Your files stay where they are.
Frequently asked questions
Do I need a Claude or ChatGPT subscription to use StashBase?
No. If you have neither, sign in to StashBase and use the built-in Default Agent, which comes with free credits that refresh every month. Browsing, editing and keyword search need no account at all.
Does StashBase charge extra for Claude Code, Codex or Antigravity?
No. They run on the Anthropic, ChatGPT or Google account you already have, and StashBase adds no fee on top. Your plan's usage limits, or your API pricing, still apply.
Can I use Antigravity in StashBase?
Yes. Choose Antigravity in the agent picker and sign in with your Google account. Like Claude Code and Codex, it asks before changing files or running commands, and it offers Auto, Ask, Edit and Plan.
Can an agent read files outside the folders I opened?
No. Agent file operations are limited to the project the chat belongs to, and an external MCP client reaches only the project you select and authorize. MCP in StashBase is not a general filesystem interface.
Can I use Cursor or another MCP client?
Yes. Any MCP-capable client can use your projects while StashBase is running. Copy the JSON configuration from Settings → Advanced → External apps (MCP) and register it in the client.