BugMojo
Bug tracking for AI agents: session replay, console/network logs, repro packs, test plans, evidence.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http bugmojo 'https://www.bugmojo.com/api/mcp'
{
"mcpServers": {
"bugmojo": {
"type": "http",
"url": "https://www.bugmojo.com/api/mcp"
}
}
}
@bugmojo/mcp-serverclaude mcp add bugmojo -e 'BUGMOJO_API_KEY=<your bugmojo_api_key>' -e 'BUGMOJO_API_URL=<BUGMOJO_API_URL>' -- npx -y @bugmojo/mcp-server@0.2.1
{
"mcpServers": {
"bugmojo": {
"command": "npx",
"args": [
"-y",
"@bugmojo/mcp-server@0.2.1"
],
"env": {
"BUGMOJO_API_KEY": "<your bugmojo_api_key>",
"BUGMOJO_API_URL": "<BUGMOJO_API_URL>"
}
}
}
}
Environment variables
BUGMOJO_API_KEYrequired secret BugMojo API key (bm_key_ prefix). Generate at Settings > API Keys.BUGMOJO_API_URLBase URL of your BugMojo instance. Defaults to https://www.bugmojo.com. Only set this for self-hosted or local instances.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
BugMojo SDKs and agent plugins
Official SDKs, CLI, MCP server and AI-agent plugins for BugMojo — the AI-native bug tracker that captures a full session replay, console + network logs, and environment context in one click, then hands the bug to your AI coding agent to fix and verify.
This repository hosts the documentation, changelogs, and public issue tracker for the published packages, plus the install files for the agent plugins (Claude Code, ChatGPT + Codex, Cursor, Gemini CLI). The npm packages themselves are distributed via npm.
Agent plugins
Every plugin connects to the hosted MCP endpoint (https://www.bugmojo.com/api/mcp)
with a browser login — no API key to paste.
| Client | Install | Docs |
|---|---|---|
| Claude Code | /plugin marketplace add viveksinra/bugmojo-sdk then /plugin install bugmojo@bugmojo | README |
| Codex | codex plugin marketplace add viveksinra/bugmojo-sdk then codex plugin add bugmojo | README |
| Cursor | One-click deeplink in the plugin README, or Settings → MCP → Add server https://www.bugmojo.com/api/mcp?mode=qa (Cursor 3.13+) | README |
| Gemini CLI | gemini extensions install https://github.com/viveksinra/bugmojo-sdk --path packages/gemini-extension | README |
Each plugin ships the same nine skills (setup, plan-tests, generate-tests,
run, assign, report, fix-bug, triage-bugs, bugmojo-conventions).
Packages
| Package | Install | What it does |
|---|---|---|
@bugmojo/widget | npm i @bugmojo/widget | Framework-agnostic on-site feedback + capture widget core (rrweb session replay, console/network capture, PII redaction). Docs |
@bugmojo/react | npm i @bugmojo/react | React / Next.js SDK — drop-in provider, error boundary with component-stack capture, and programmatic reporting. Docs |
@bugmojo/react-native | npx expo install @bugmojo/react-native | React Native + Expo SDK — shake-to-report, masked screenshot replay, on-device PII redaction. Docs |
@bugmojo/mcp-server | npx -y @bugmojo/mcp-server | MCP server (stdio) connecting AI coding agents (Claude Code, Cursor, VS Code) to BugMojo with an API key. Docs |
@bugmojo/cli | npx @bugmojo/cli | Pull a bug's executable Playwright repro, verify a fix locally or in CI, generate agent-ready fix prompts, and init a repo for every agent. Docs |
@bugmojo/playwright-reporter | npm i -D @bugmojo/playwright-reporter | Records every Playwright run in BugMojo with traces, videos and screenshots, mapped to test cases. Docs |
@bugmojo/codemap | npx -y @bugmojo/cli map | Deterministic, offline codebase mapper — routes, APIs, components and forms into a feature map. Docs |
Quick start
The fastest way to see BugMojo in action:
# React / Next.js app
npm install @bugmojo/react
import { BugMojoProvider } from '@bugmojo/react';
<BugMojoProvider projectId="YOUR_PUBLIC_EMBED_TOKEN">
<App />
</BugMojoProvider>
Grab your free embed token at bugmojo.com → Project Settings → Widget.
Prefer no code? Install the BugMojo Chrome extension (it also works in Microsoft Edge).
Support & issues
- 🐛 Bugs / feature requests for any SDK or plugin: open an issue
- 📚 Product docs & help center: bugmojo.com/help
- 🤖 Machine-readable overview for agents: bugmojo.com/llms.txt
- ✉️ Direct support: via the in-app messenger at bugmojo.com
License
All packages and plugins are published under the MIT License © 2026 Softech Infra.
Frequently asked questions
What is BugMojo?
Bug tracking for AI agents: session replay, console/network logs, repro packs, test plans, evidence.
How do I install BugMojo?
It runs as a remote server. In Claude Code: claude mcp add --transport http bugmojo 'https://www.bugmojo.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does BugMojo need an API key?
Yes. It expects BUGMOJO_API_KEY, which you set in its configuration.
Is BugMojo open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains BugMojo?
It is published by viveksinra. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.