Adopt into a project

After pip install vibeissue:

vibeissue-adopt --target ../my-repo --repo myorg/my-app

Or from a cloned repo folder:

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

Use --force to overwrite existing files. Works on Windows, macOS, and Linux.

What it copies

Item	Purpose
scripts/github_issue.py	CLI (also usable without PyPI)
tracker/*	Labels, examples, slug file
.github/ISSUE_TEMPLATE/*	Web forms
.github/copilot-instructions.md	GitHub Copilot
.cursor/rules/github-issues.mdc	Cursor
AGENTS.md, CLAUDE.md	Universal / Claude Code rules

What it creates

• tracker/github_repo with your slug
• tracker/import-manifest.json from example (if missing)
• .secrets/.gitkeep

After adopt

cd ../my-repo
vibeissue labels --apply
vibeissue list

Open the folder in your AI agent:

Platform	Instruction file
Cursor	.cursor/rules/github-issues.mdc
Claude Code	CLAUDE.md + AGENTS.md
Copilot	.github/copilot-instructions.md + AGENTS.md
Other	See Platforms

Full documentation: vibeissue.github.io/docs