Home Get started Platforms Docs GitHub
Italiano English
Not Cursor-only

Supported platforms

Issuebeam is not tied to a single IDE. The core is always the same: Python CLI + agent instructions + GitHub Issues. Only the file your tool auto-loads changes.

Full documentation: MkDocs — Platforms

Architecture

1 · Chat

Describe bugs and tasks in natural language — from Cursor, VS Code, terminal, …

2 · Agent

Reads AGENTS.md or the platform-specific file and runs github_issue.py.

3 · GitHub

Official issues with labels, web templates, and close via Fixes #N.

Quick reference

Platform Instruction file Notes
Cursor.cursor/rules/github-issues.mdcBest-tested path · alwaysApply
Claude CodeCLAUDE.md · AGENTS.mdVS Code, CLI, or desktop
GitHub Copilot.github/copilot-instructions.mdVS Code and Visual Studio
Windsurf.windsurfrulesCopy from AGENTS.md
Cline.clinerulesCustom instructions in VS Code
Continue.dev.continue/rulesYAML config or project rules
Gemini CLIGEMINI.mdCopy from AGENTS.md
Codex CLIAGENTS.mdOpenAI convention
AiderAGENTS.md / CONVENTIONS.md/read AGENTS.md on start
Manual—CLI only, no AI agent

Per-platform setup

Cursor

  1. Clone issuebeam or run adopt.py into your repo.
  2. Configure GITHUB_TOKEN and tracker/github_repo.
  3. Open the folder in Cursor — github-issues.mdc is already active.

VS Code + Claude Code

  1. Adopt issuebeam — copies CLAUDE.md and AGENTS.md.
  2. Open the repository root in VS Code (not a subfolder).
  3. Install Claude Code and ask: "Open an issue for…" — it should run the Python script.

GitHub Copilot (VS Code / Visual Studio)

  1. Adopt issuebeam — includes .github/copilot-instructions.md.
  2. Enable Copilot Chat with agent/terminal permissions.
  3. Ask to track a bug using the project CLI.

Other platforms

For Windsurf, Cline, Continue, Gemini CLI, Codex CLI, and Aider: copy AGENTS.md into the format your tool expects (see table above). Requirements are always the same: Python, token, repo slug, shell access.

5-minute setup MkDocs platforms guide