Cursor

Best-tested path. Issuebeam ships with:

.cursor/rules/github-issues.mdc   # alwaysApply: true

Setup

1. Clone issuebeam or run adopt.py into your repo.
2. Configure token and repository slug.
3. Open the folder in Cursor — the rule is active immediately.

Verify

In chat: "List open GitHub issues" → agent should run python scripts/github_issue.py list.

Notes

• Works in Agent mode and integrated terminal on all OS.
• On Windows, GITHUB_TOKEN from user env can also be read via registry if the IDE shell does not inherit it.
• Italian phrases like «apri issue per…» are documented in the rule file.
• This rule is Cursor-specific; other platforms use AGENTS.md — see overview.

Troubleshooting

Problem	Fix
Agent asks you to paste commands	Point to AGENTS.md: execute script directly
Rule not applied	Check alwaysApply: true in .mdc front matter
Token not found	Restart Cursor after setting GITHUB_TOKEN