Settings

Theme

Show HN: Issy – AI-native issue tracking stored as Markdown files in your repo

mike.gg

1 points by miketromba 3 months ago · 0 comments · 1 min read

Reader

Hey HN, I built issy, a lightweight issue tracker that stores issues as markdown files in a `.issues/` directory in your repo.

The idea is simple: issues should live with your code. They show up in diffs, travel with branches, and don't require accounts, databases, or external services. They're just markdown files with YAML frontmatter.

It's built for AI coding assistants. You can tell Cursor/Claude/Codex (or any AI agent) things like "create a bug for the login redirect issue, high priority" and it handles the rest — creating, searching, updating, and closing issues through natural language. There's a Cursor skill you can install with `npx skills add miketromba/issy`.

It also comes with a CLI for filtering/searching and a local web UI at localhost:1554 for when you want a visual overview.

Key points: - Zero infrastructure — no DB, no accounts, no SaaS - Issues are git-native — visible in PRs, blame-able, branch-able - Fuzzy search with typo tolerance - Monorepo-aware (walks up the directory tree to find .issues/) - Works offline

Blog Post: https://mike.gg/issy

GitHub: https://github.com/miketromba/issy

No comments yet.

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection