Welcome

Jyn is a fast personal todo tool that lives in your terminal. It stores tasks as plain files, which you can keep in a Git repo, and works entirely offline. Anyone comfortable on the command line can use it. Sync to the apps on your phone is planned.

Part of the Joyint Ecosystem

Jyn is the personal todo tool in the Joyint ecosystem, built on the same plain-text, terminal-first foundation as its sister tool Joy:

Key Features

• Fast capture - Add a task in seconds, right from your terminal
• Plain files - Tasks are YAML files you can version in Git alongside your notes or code
• Tags and priorities - Organize and filter without overhead
• Standalone - Works on its own, next to Joy or without it

Quick Start

Install the prebuilt binary:

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

On Windows: winget install -s winget joyint.jyn. Alternatives: cargo install jyn-cli (build from source) or download a binary from GitHub Releases. Tip: wary of the curl ... | sh pattern? Pipe through less first (curl -fsSL get.joyint.com/jyn | less) to read the script, then re-run with | sh when you are comfortable.

Then just start adding tasks; jyn creates its .jyn/ store in the current directory on the first add (and finds it again from any subdirectory below):

jyn add "Review pull request JOY-00D3" --tag work
jyn add "Call Lisa" --tag personal --prio high
jyn ls

New to the CLI? Run jyn tutorial for a guided walk-through.

What These Docs Cover

• Vision - Why Jyn exists and where it is heading
• Applications - The CLI today, and what is planned
• Use Cases - How people use Jyn in practice
• Features - What you can do today and what is planned