English Français العربية

BugMojo

السجل الرسمي الذكاء الاصطناعي والوكلاء

Bug tracking for AI agents: session replay, console/network logs, repro packs, test plans, evidence.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http bugmojo 'https://www.bugmojo.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bugmojo": {
            "type": "http",
            "url": "https://www.bugmojo.com/api/mcp"
        }
    }
}
NPM package @bugmojo/mcp-server
Claude Code 
claude 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • BUGMOJO_API_KEY إلزامي سري BugMojo API key (bm_key_ prefix). Generate at Settings > API Keys.
  • BUGMOJO_API_URL Base URL of your BugMojo instance. Defaults to https://www.bugmojo.com. Only set this for self-hosted or local instances.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. BugMojo SDKs and agent plugins
  2. Agent plugins
  3. Packages
  4. Quick start
  5. Support & issues
  6. License

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.

ClientInstallDocs
Claude Code/plugin marketplace add viveksinra/bugmojo-sdk then /plugin install bugmojo@bugmojoREADME
Codexcodex plugin marketplace add viveksinra/bugmojo-sdk then codex plugin add bugmojoREADME
CursorOne-click deeplink in the plugin README, or Settings → MCP → Add server https://www.bugmojo.com/api/mcp?mode=qa (Cursor 3.13+)README
Gemini CLIgemini extensions install https://github.com/viveksinra/bugmojo-sdk --path packages/gemini-extensionREADME

Each plugin ships the same nine skills (setup, plan-tests, generate-tests, run, assign, report, fix-bug, triage-bugs, bugmojo-conventions).

Packages

PackageInstallWhat it does
@bugmojo/widgetnpm i @bugmojo/widgetFramework-agnostic on-site feedback + capture widget core (rrweb session replay, console/network capture, PII redaction). Docs
@bugmojo/reactnpm i @bugmojo/reactReact / Next.js SDK — drop-in provider, error boundary with component-stack capture, and programmatic reporting. Docs
@bugmojo/react-nativenpx expo install @bugmojo/react-nativeReact Native + Expo SDK — shake-to-report, masked screenshot replay, on-device PII redaction. Docs
@bugmojo/mcp-servernpx -y @bugmojo/mcp-serverMCP server (stdio) connecting AI coding agents (Claude Code, Cursor, VS Code) to BugMojo with an API key. Docs
@bugmojo/clinpx @bugmojo/cliPull 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-reporternpm i -D @bugmojo/playwright-reporterRecords every Playwright run in BugMojo with traces, videos and screenshots, mapped to test cases. Docs
@bugmojo/codemapnpx -y @bugmojo/cli mapDeterministic, 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

License

All packages and plugins are published under the MIT License © 2026 Softech Infra.

الأسئلة الشائعة

ما هو BugMojo؟

Bug tracking for AI agents: session replay, console/network logs, repro packs, test plans, evidence.

كيف أثبّت BugMojo؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http bugmojo 'https://www.bugmojo.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج BugMojo إلى مفتاح API؟

نعم. يتطلب BUGMOJO_API_KEY، وتضبطها في إعداداته.

هل BugMojo مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون BugMojo؟

ينشره viveksinra. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.