Vibeissue¶

← Main website (vibeissue.github.io) · Documentation

Vibeissue wires AI coding agents to GitHub Issues with a stdlib Python CLI and repository instruction files. Works on Windows, macOS, and Linux with Cursor, Claude Code, GitHub Copilot, and more.

Bilingual documentation

This site is also available in Italiano. Use the language selector in the top navigation bar.

What it does¶

Layer	Description
CLI	`vibeissue` (PyPI) — create, list, comment, close, import issues
Agent rules	`AGENTS.md`, Cursor rule, Copilot instructions, `CLAUDE.md`, …
GitHub	Official backlog with labels, web templates, `Fixes #N` in PRs

Who this is for¶

You ship with vibe coding (LLMs, fast iteration) and lose track of bugs and tasks buried in chat. Vibeissue moves operational status to GitHub Issues — not scattered markdown files.

Not Cursor-only. The same CLI runs everywhere; only the instruction file path changes per IDE.

Quick start¶

pip install vibeissue
vibeissue-adopt --target ../my-repo --repo myorg/my-app
cd ../my-repo
vibeissue labels --apply
vibeissue create "Setup test" --labels task
vibeissue list

Details: Overview · Token · Platforms

Adopt into your repo¶

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

Copies CLI, labels, templates, and agent instruction files for multiple platforms.

Documentation map¶

Section	Content
Getting started	Problem, architecture, setup
Platforms	Cursor, Claude Code, Copilot, others
CLI reference	All commands
Agent workflow	Natural language phrases
Reference	FAQ, security, troubleshooting

Build docs locally¶

pip install -r docs/requirements.txt
mkdocs serve

Preview at http://127.0.0.1:8000 — publish with python scripts/publish_docs.py, then git push in sibling repo vibeissue.github.io. No GitHub Actions.