JynJyn Docs

Vision

Simple personal task management that respects your workflow.

Your Todos, Your Way

Personal task management should be simple, fast, and invisible when you do not need it. Jyn is built for anyone who wants to capture tasks without leaving the terminal and without depending on a cloud service.

Design Philosophy

Minimal ceremony. Adding a task should take less time than thinking about whether to add it. jyn add "Fix the test" - done. No project to select, no category to assign, no form to fill out. Metadata like priority, tags, and due dates is always optional.

Fast capture. The moment between "I need to remember this" and "it is captured" should be as short as possible. Jyn optimizes for that moment. Everything else - organizing, filtering, reviewing - can happen later.

Git-native. Like Joy, Jyn stores everything as plain files. If you keep your Jyn data in a Git repo, you get versioning, backup, and sync for free. If you do not care about versioning, a plain directory works too.

No Cloud Required

Jyn stores everything locally in plain files. No account, no sync, no internet connection needed. Your tasks live on your machine, in a Git repo if you want versioning, or in a plain directory if you do not.

What Jyn Adds

Jyn keeps the same simple, file-based model as Joy and layers on what a personal todo list needs:

  • Due dates - Set deadlines and list by what is due. Available today.
  • Simplified status - Open, done, deferred. No review cycle, no gates; personal tasks do not need governance. Available today.
  • Recurrence - Repeating tasks captured in plain language (every Monday, monthly on the 1st, every 2 weeks). Stored as iCalendar RRULE so they round-trip through CalDAV and Microsoft To Do later. Available today.
  • Reminders - Time-based nudges for tasks with a due date. Planned.

Joy handles project planning, Jyn handles personal execution. They are separate tools that share a common foundation; for how that foundation fits together, see the architecture.

Dispatch Integration Planned

When a Joy item reaches a status gate, it will be able to create a Jyn task for the assigned person automatically. A reviewer gets assigned feedback to address - it lands in Jyn. A milestone deadline triggers a reminder - it lands in Jyn. An AI agent identifies a follow-up for a specific person - it lands in Jyn.

Dispatch bridges the gap between team planning and individual execution. Your Jyn becomes the inbox for actionable work that flows from the team's backlog.

Sync & Integrations Planned

The terminal is great at a desk. On the go, you need your phone. Define tasks in the terminal, check them off anywhere, and let the changes sync back. Two routes are planned, both running through the Joyint platform:

  • CalDAV - Apple Reminders, Google Calendar, Thunderbird, and any standards-compliant client.
  • Microsoft 365 - Many teams live in Microsoft, and Outlook does not speak CalDAV. A Microsoft Graph adapter syncs Jyn tasks to Microsoft To Do (which surfaces them in Outlook and the To Do app), with optional Teams notifications.

Your Jyn data stays the source of truth; the integrations mirror it outward.

Part of the Ecosystem

Jyn is one of three pillars in the Joyint ecosystem: Joy for planning, Jyn for execution, Jon for understanding. When Joy dispatches a task to you personally, it can land in Jyn. When a Jyn task grows into a project item, it can promote to Joy. The tools are separate but connected.

Works Standalone

You do not need Joy to use Jyn. You do not need the Joyint platform. Jyn is a standalone MIT-licensed tool that does one thing well: manage your personal tasks from the command line.