Get Started with Agents
Choose Busabase Cloud or Desktop, connect your agent with the right guide, and add MCP only when you need it.
Copy this prompt into your agent to open this workspace's onboarding skill (SETUP_SKILL.md). It reuses a connected Busabase MCP integration when available; otherwise it signs in. It then installs the permanent Busabase skills.
Use this page as the universal starting point for Codex, Claude Code, Cursor, Gemini CLI, or another coding agent. You only need to make three decisions: where Busabase runs, which agent setup matches your client, and whether you want the optional MCP connection.
You decide what your agent may merge
Your agent writes through Change Requests, so every change carries a message, a diff, and an undo. Whether a given write lands immediately or waits for you is set by the key's permission level — issue a changeRequest-scoped key and nothing it writes goes live until you approve it. Either way, it must not approve, merge, or close a proposal unless you explicitly ask it to make that review decision.
Choose Busabase Cloud or Desktop
Choose Busabase Cloud when the workspace must be reachable from multiple devices, teammates, hosted agents, or web chat products. Cloud connections use browser OAuth and the hosted origin https://busabase.com.
Open your workspace, then use Dashboard → Agent Skills when you want a prompt already targeted to the currently selected space.
Set up your agent
Choose your agent from the horizontal tabs, then choose the Busabase edition from the dropdown on the right. The edition stays selected while you compare agent setup paths.
Use the dedicated Codex plugin guide. The plugin bundles the Busabase skills and hosted OAuth MCP profile, so it is the most convenient Cloud setup.
Give this prompt to your agent
Read https://busabase.com/docs/codex-plugin and complete the Busabase plugin installation and environment initialization for Codex. Verify the Busabase connection when finished.Optionally add MCP
MCP is useful when your agent or IDE should call Busabase tools directly. Skip this step when the Cloud Codex or Claude Code plugin is already installed—those plugins bundle the correct MCP server.
Set up the client
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase --scopes mcp
codex mcp listConnect
Complete browser OAuth, then open /mcp and confirm the tools are enabled.
Verify the workspace
Ask the agent to run auth_verify. If it returns multiple spaces, ask which space to use, then run bases_list with that targetSpaceId.
What to read next
Bring Your Own Agent
Understand the canonical prompt, permanent skill, and daily change-request workflow.
Codex Plugin
Install the dedicated Busabase Cloud plugin for Codex.
Claude Code Plugin
Install and verify the dedicated Busabase Cloud plugin for Claude Code.
MCP + OAuth
Configure direct MCP access for supported agents and chat clients.