Introducing Joy

Joy is a terminal-native product management tool. It brings epics, stories, tasks, milestones, and dependencies to your command line - with everything stored as YAML files in your Git repo.

How it works

Run joy init in any Git repository and you get a .joy/ directory with your project data. No database, no cloud service, no browser tabs. Your project plan is plain text, versioned alongside your code.

mkdir my-project && cd my-project && git init
joy init
joy add epic "User Authentication"
joy add story "Login form" --parent MP-0001 --priority high
joy start MP-0002

Filter, search, and track progress from the terminal:

joy ls --status open --priority high
joy roadmap
joy log --since 7d

AI integration

Joy has built-in support for AI coding tools. Register AI members in your project, define their capabilities, and let them manage backlog items alongside human team members. Joy's trust model provides governance - from solo developer with full autonomy to enterprise teams with gates, cost limits, and audit trails.

Supported tools include Claude Code, GitHub Copilot, Mistral Vibe, and Qwen Code.

Current status

Joy is in beta and MIT-licensed. We use it daily to build itself, and it is stable enough for real projects. Expect rough edges and rapid improvement.

Check out the documentation and tutorial to get started, or visit the GitHub repository for the source code.