Welcome

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.

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 Jyn and the Joyint platform:

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

Install the prebuilt binary.

macOS / Linux:

curl -fsSL get.joyint.com/joy | sh

Windows (PowerShell):

irm get.joyint.com/joy.ps1 | iex

Both installers drop the binary into ~/.local/bin. The Windows installer also adds that directory to your user PATH (no administrator rights required); on macOS / Linux add it yourself if it isn't already (export PATH="$HOME/.local/bin:$PATH" in your shell rc).

Alternatives: cargo install joy-cli (build from source) or download a binary from GitHub Releases. Tip: wary of the pipe-to-shell pattern? Read the script first (curl -fsSL get.joyint.com/joy | less or irm get.joyint.com/joy.ps1 on Windows), then re-run when you are comfortable.

Then:

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