{
  "markdown": "# Codegen Bridge\n\nAI-agent plugin and skills pack for delegating implementation plans to [Codegen](https://codegen.com) cloud agents.\n\n## What it does\n\n- **~54 MCP tools** — 49 manual tools + 5 auto-generated from OpenAPI spec + remote proxy\n- **4 agent skills** — delegation, execution, monitoring, and PR management\n- **2 Task agents** — codegen-delegator and pr-reviewer\n- **5 slash commands** — `/codegen`, `/cg-status`, `/cg-logs`, `/cg-merge`, `/cg-settings`\n- **Cross-platform packaging** — Claude, Cursor, Codex, Gemini CLI, and OpenCode install adapters\n\n## Setup\n\n1. Get API key from [codegen.com](https://codegen.com)\n2. Set environment variables:\n\n```bash\nexport CODEGEN_API_KEY=\"your-api-key\"\nexport CODEGEN_ORG_ID=\"your-org-id\"\n```\n\n## Installation By Platform\n\n### Claude Code\n\nInstall local plugin:\n\n```text\n/install-plugin ~/.claude/plugins/codegen-bridge\n```\n\n### Cursor\n\nInstall plugin from repository:\n\n```text\n/add-plugin https://github.com/evgenygurin/codegen-bridge\n```\n\nDetailed guide: [docs/README.cursor.md](docs/README.cursor.md)\n\n### Codex\n\nTell Codex:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/evgenygurin/codegen-bridge/main/.codex/INSTALL.md\n```\n\nDetailed guide: [docs/README.codex.md](docs/README.codex.md)\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/evgenygurin/codegen-bridge\n```\n\nUpdate:\n\n```bash\ngemini extensions update codegen-bridge\n```\n\nDetailed guide: [docs/README.gemini.md](docs/README.gemini.md)\n\n### OpenCode\n\nTell OpenCode:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/evgenygurin/codegen-bridge/main/.opencode/INSTALL.md\n```\n\nDetailed guide: [docs/README.opencode.md](docs/README.opencode.md)\n\n### Verify Installation\n\nStart a new agent session and ask for delegation, for example:\n- `delegate this task to codegen`\n- `show latest codegen runs`\n- `summarize run <id>`\n\nThe assistant should use `codegen_*` tools and `codegen-bridge` skills.\n\n## Usage with Superpowers\n\nWhen `writing-plans` offers execution options, choose **\"Codegen Remote\"** to delegate to cloud agents. The `executing-via-codegen` skill will:\n\n1. Parse the plan into tasks\n2. Create one Codegen agent run per task\n3. Monitor progress (polling every 30s)\n4. Report results with PR links\n5. Handle failures and pauses\n\n## Manual MCP Tools\n\n| Module | Tools | Purpose |\n|--------|-------|---------|\n| `agent` | `create_run`, `get_run`, `list_runs`, `resume_run`, `stop_run`, `ban_run`, `unban_run`, `remove_from_pr`, `get_logs`, `create_and_monitor`, `monitor_run_background`, `bulk_create_runs`, `report_run_result` | Agent run lifecycle, monitoring, bulk ops |\n| `execution` | `start_execution`, `get_execution_context`, `get_agent_rules` | Multi-task execution plans |\n| `pr` | `edit_pr`, `edit_pr_simple` | Pull request management |\n| `setup` | `list_orgs`, `list_repos`, `list_users`, `get_user`, `get_current_user`, `get_organization_settings`, `get_mcp_providers`, `get_oauth_status`, `revoke_oauth`, `get_check_suite_settings`, `update_check_suite_settings`, `generate_setup_commands`, `list_models` | Organization, repo, user setup |\n| `integrations` | `get_integrations`, `get_webhook_config`, `set_webhook_config`, `delete_webhook_config`, `test_webhook`, `analyze_sandbox_logs`, `generate_slack_token`, `check_integration_health` | Webhooks, sandbox, Slack, health |\n| `analytics` | `get_run_analytics` | Run statistics and metrics |\n| `session` | `set_session_preference`, `get_session_preferences`, `clear_session_preferences` | Per-session state management |\n| `settings` | `get_settings`, `update_settings` | Plugin settings management |\n| `sampling` | `summarise_run`, `summarise_execution`, `generate_task_prompt`, `analyse_run_logs` | LLM sampling tools |\n\nAuto-generated tools from the Codegen OpenAPI spec are also available at runtime via the OpenAPI provider.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| `executing-via-codegen` | Orchestrate plan execution task-by-task via cloud agents |\n| `codegen-delegation` | Delegate individual tasks to Codegen agents |\n| `agent-monitoring` | Monitor and track agent run progress |\n| `pr-management` | Manage pull requests created by agents |\n\n## Agents\n\n| Agent | Description |\n|-------|-------------|\n| `codegen-delegator` | Orchestrates multi-task plan execution via cloud agents |\n| `pr-reviewer` | Reviews and manages pull requests from agent runs |\n\n## Hooks\n\nHooks live in the root `hooks/` directory and run automatically:\n\n- **PostToolUse** — auto-extracts run URLs after `codegen_create_run`, auto-formats status after `codegen_get_run`\n- **Stop** — generates a session summary of all Codegen agent runs\n\n## Plugin Structure\n\n```text\ncodegen-bridge/\n├── .codex/\n│   └── INSTALL.md           # Codex bootstrap instructions\n├── .claude-plugin/\n│   ├── plugin.json          # Plugin metadata (name, version, keywords)\n│   ├── settings.json        # Runtime settings (model, polling)\n│   └── marketplace.json     # Marketplace listing\n├── .cursor-plugin/\n│   └── plugin.json          # Cursor plugin manifest\n├── .opencode/\n│   └── INSTALL.md           # OpenCode bootstrap instructions\n├── GEMINI.md                # Gemini context entrypoint\n├── gemini-extension.json    # Gemini extension manifest\n├── hooks/                   # Claude/Cursor hooks\n│   ├── hooks.json\n│   ├── hooks-cursor.json\n│   ├── session-start\n│   └── scripts/\n├── skills/                  # Agent skills (SKILL.md files)\n├── agents/                  # Task agents (markdown definitions)\n├── commands/                # Slash commands (markdown definitions)\n├── bridge/                  # MCP server source code\n│   ├── server.py            # FastMCP server + lifespan\n│   ├── client.py            # Codegen API client\n│   ├── tools/               # Manual tool implementations\n│   ├── resources/           # MCP resources\n│   ├── prompts/             # Prompt templates\n│   ├── providers/           # Custom MCP providers\n│   ├── middleware/          # 9-layer request middleware stack\n│   ├── sampling/            # LLM sampling tools\n│   ├── services/            # Business logic (RunService, ExecutionService)\n│   ├── transforms/          # 4-stage transform chain\n│   ├── telemetry/           # OpenTelemetry integration\n│   └── ...\n├── tests/                   # Test suite\n└── pyproject.toml           # Python project config (v0.6.0)\n```\n\n## Development\n\n```bash\ncd ~/.claude/plugins/codegen-bridge\nuv sync --dev\nuv run pytest -v\nuv run ruff check .\nuv run mypy bridge/\n```\n",
  "bytes": 6552,
  "sha": "3341c5fc270a0418f756a236b6d1310bbf54aaebf3a934ba6e8855ec79ce4ddb",
  "repo_slug": "evgenygurin/codegen-bridge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_evgenygurin_codegen_bridge_abde4201/readme"
}