Getting Started

issy is an AI-native issue tracking system. It gives your AI coding assistant the ability to manage issues using natural language. Issues are stored as markdown files in .issy/issues/ — readable, diffable, and committed with your code.

No database. No accounts. No vendor lock-in.

How it works

Teach your AI assistant to run issy learn for issue work, then talk naturally:

“Create a bug for the login redirect issue, high priority”

“What issues are open?”

“Close the auth bug, it’s fixed”

“What should I work on next?”

Your assistant creates, searches, updates, and closes issues for you. Everything is stored as plain markdown files in your repository.

Quick start

1. Install issy globally:

npm install issy --global

2. Initialize issues in your project:

issy init --seed

3. Teach your AI assistant:

issy learn

Add the AGENTS.md snippet from AI Agents, or install the bootstrap skill with issy skill install.

That’s it. Your AI assistant can now manage issues in any repo. Head to the Installation page for more options, or learn about AI Agents to understand how agent setup works.

What you get

AI agent guidance — Versioned natural language issue management via issy learn
CLI — Full terminal workflow for creating, listing, searching, and managing issues
Web UI — Local browser interface for browsing and filtering issues
Roadmap Ordering — Dependency-aware prioritization with fractional indexing
Hooks — Post-action reminders injected into AI agent context
Monorepo Support — Automatic directory resolution from any subdirectory