Home Get started Platforms Docs GitHub
Italiano English
Quick setup

Get started

Three steps for the CLI. One more if you want the AI agent to open issues from chat. Works on Windows, macOS, and Linux — see also Platforms.

01

Install from PyPI

Package: pypi.org/project/vibeissue.

pip install vibeissue
02

Create a GitHub token

Personal Access Token with Issues: read & write on the target repo. OS details: token guide.

03

Put token and repo in .env

In the folder where you run commands (your project). Keep .env gitignored.

GITHUB_TOKEN=github_pat_…
GITHUB_REPO=myorg/my-app

Try it:

vibeissue list

Optional — full path (AI agents)

+

Adopt + open your agent

Copies skeleton, labels, templates, and agent rules (AGENTS.md, Cursor, Copilot, Claude). Then open the project in Cursor / Claude Code / Copilot and say: "Open an issue for…".

vibeissue-adopt --target ../my-repo --repo myorg/my-app
cd ../my-repo
vibeissue labels --apply

Without this step the CLI works; the agent does not yet know to run vibeissue.

Platforms guide MkDocs documentation