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.
Install the prebuilt binary.
macOS / Linux:
curl -fsSL get.joyint.com/joy | shWindows (PowerShell):
irm get.joyint.com/joy.ps1 | iexBoth 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-cliThen:
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-0002If 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 integrationjoy init detects the existing project and switches to onboarding mode - it installs the commit-msg hook and sets core.hooksPath without touching project data.
- 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
- Tutorial - getting started with an example project
- VISION.md - product vision and data model
- ARCHITECTURE.md - technical overview
- CONTRIBUTING.md - conventions, testing, release
- Plugins - writing
joy-<name>plugins (joy-bi is the reference)
Architecture decisions are tracked as Joy decision items in this repository; run joy ls -D to list them.
Early development. Joy is built and managed with itself (dogfooding).
MIT. See LICENSE.