Get started — Issuebeam

01

GitHub token

Create a Personal Access Token with Issues: read & write on the target repository.

Set GITHUB_TOKEN in your environment — see the token guide for Windows, macOS, and Linux. Alternatives: .env (gitignored) or .secrets/github_token (one line).

                        # Verify (after setting the token)

                        python -c "import os; print('OK' if os.environ.get('GITHUB_TOKEN') else 'MISSING')"

02

Repository slug

Tell the CLI which GitHub repo to use (owner/name).

                        python -c "from pathlib import Path; Path('tracker/github_repo').write_text('myorg/my-app\n')"

                        # or in .env

                        GITHUB_REPO=myorg/my-app

03

Adopt into another project (optional)

Copy the skeleton into an existing repo with one command.

python scripts/adopt.py --target ../my-repo --repo myorg/my-app

04

Labels

Apply labels from tracker/labels.yml to the GitHub repo.

python scripts/github_issue.py labels --apply

05

First issue + AI agent

Test the CLI, then open the project in your agent (Cursor, Claude Code, Copilot, …) — instructions are already in the repo.

                        python scripts/github_issue.py create "[Bug] Setup test" --labels bug

                        python scripts/github_issue.py list