JoyJoy Docs

Welcome

Terminal-native product management that lives in your Git repo.

Joy is a product management tool that lives in your terminal and stores everything in your Git repo. Epics, stories, tasks, dependencies, milestones, releases - all as plain YAML files, versioned alongside your code.

New to Joy?

Visit the homepage for a quick overview of what Joy does, who it is for, and why it exists. The source is on GitHub.

Part of the Joyint Ecosystem

Joy is the product management tool in the Joyint ecosystem, built on the same Git-native, terminal-first foundation as its sister tool Jot and the Joyint platform:

Jot

Personal todo CLI for developers. Fast capture, tags, priorities. Standalone or alongside Joy.

Joyint

The platform: sync, collaboration, AI governance, web interface. Ties Joy and Jot together.

Key Features

  • Git-native - Your backlog is code. Branch it, diff it, merge it, review it.
  • Terminal-first - No browser, no context switch. Ten commands cover 95% of daily use.
  • AI-ready - AI tools are first-class members with identity, capabilities, and accountability.
  • Zero dependencies - Single binary, works offline, no database, no cloud required.

Quick Start

joy init
joy add story "User login" --priority high
joy start CB-0001
joy close CB-0001

What These Docs Cover

  • Vision - Why Joy exists and where it is heading
  • Applications - CLI, TUI, App, and Web
  • Use Cases - How teams use Joy in practice
  • Features - Detailed feature list with examples
  • Tutorial - Step-by-step walkthrough of a complete project