BugMojoBugMojo
Get started
How-to

Install BugMojo in the Gemini CLI

Install the extension, authenticate once, and get the context file, the shared skills and three slash commands.

Applies toPlans:FreeProBusinessEnterpriseRoles:OwnerAdminDeveloperQaWhere:MCP

Install

Terminal
gemini extensions install https://github.com/viveksinra/bugmojo-sdk --path packages/gemini-extension
text
/mcp auth bugmojo

  1. Run the install command above.

  2. Answer the two settings prompts (below). Accepting both defaults is fine.

  3. Run /mcp auth bugmojo and complete the browser login.

  4. Try /bugmojo:test-context to confirm the connection returns your project's test context.

MCP server only

Terminal
gemini mcp add --transport http bugmojo https://www.bugmojo.com/api/mcp

That connects the tools without the context file, the skills or the commands. Run /mcp and complete the browser prompt to authenticate.

Settings

KeyRequiredDefaultWhat it does
mcp_urlyeshttps://www.bugmojo.com/api/mcp?mode=qaThe endpoint. Append &workspace=<slug> to pin a workspace, or use ?mode=all for every tool.
default_projectno(empty)The project key used when a command does not name one. Empty means "ask me".

What the extension adds

PartWhat it does
GEMINI.mdThe context file, loaded into every session in the repository: what to pull before debugging, how to annotate a spec, and what never to fabricate.
/bugmojo:fix-bugPull the bug with its logs and repro pack, localize, fix, open a PR and link it.
/bugmojo:triage-bugsRank open bugs in the context of the test plan.
/bugmojo:test-contextRead the project's test memory, coverage counts, plan summaries and recent failures.
skills/The same skills the Claude Code plugin ships, kept byte-identical across packages.

Headless machines

If a machine cannot complete a browser login, replace the server block with an API-key header. Create the key in Settings → API keys and give it write permission only if the agent should record runs.

Terminal
BUGMOJO_API_KEY=bm_key_... npx -y @bugmojo/mcp-server

Common questions

Do I have to submit anything to get the extension listed?

No. The Gemini extension gallery lists public repositories carrying the <code>gemini-cli-extension</code> topic automatically — there is no submission form.

Can I point the extension at a different endpoint?

Yes. The server URL comes from the <code>mcp_url</code> setting, so changing the setting re-points it without editing the manifest.

Why does every tool call ask for confirmation?

The manifest sets <code>trust: false</code> deliberately, so each call stays confirmable. That is the safe default for a server that can write.

What if the machine cannot open a browser?

Replace the server block with an API-key header using a <code>bm_key_</code> key from Settings → API keys.

Was this helpful?
Updated Sep 19, 2026 · Still stuck? Contact support

Related articles