Joy

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

Joy is a fast, file-based, AI-powered project management CLI for developers who think product management should live where the code lives. Part of the Joyint ecosystem.

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).

Or install from source via cargo:

cargo install joy-cli

Then:

cd my-project && joy init

joy add story "User login" --priority high
joy add task "OAuth flow" --parent MY-0001
joy start MY-0002
joy close MY-0002

Joining an existing project

If you clone a repo that already uses Joy, run joy init to set up your local environment:

git clone <repo-url> && cd <repo>
joy init     # installs commit-msg hook, sets up git hooks path
joy ai init  # optional: configure AI tool integration

joy init detects the existing project and switches to onboarding mode - it installs the commit-msg hook and sets core.hooksPath without touching project data.

Features

• Git-native - all data in .joy/ as YAML, versioned with your code
• AI-powered - estimate, plan, implement, review via pluggable AI tools
• Single binary - one small Rust binary, no runtime dependencies
• Offline-first - no server needed, sync when you want

Documentation

• Tutorial - Getting started with an example project
• Contributing - Joy-specific coding conventions

For product vision, architecture, and ADRs see the umbrella project.

Status

Early development. Joy is built and managed with itself (dogfooding).

License

MIT. See LICENSE.