JotJot 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. Jot is built for developers who want 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. jot add "Fix the test" - done. No project to select, no category to assign, no form to fill out. Metadata like priority, tags, and effort is always optional.

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

Git-native. Like Joy, Jot stores everything as plain files. If you keep your Jot 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

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

Relationship to Joy

Jot shares joy-core with Joy. That means the same storage layer, event model, and configuration system. The item model in Jot extends Joy's base item with personal task features:

  • Recurrence (RRULE) - Define repeating tasks with standard RRULE syntax. "Pay rent on the 1st", "weekly standup every Monday". Jot generates new instances automatically.
  • Due dates - Set deadlines and get warned about overdue items.
  • Simplified status - Open, done, deferred. No review cycle, no gates. Personal tasks do not need governance.

Joy handles project planning. Jot handles personal execution. They are separate tools with a shared foundation, connected through dispatch.

Dispatch Integration

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

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

CalDAV Sync Planned

The terminal is great at a desk. On the go, you need your phone. Jot will sync with CalDAV clients like Apple Reminders, Google Calendar, and any standards-compliant app. Define tasks in the terminal, check them off on your phone. Changes sync back through the Joyint platform or a local CalDAV server.

Part of the Ecosystem

Jot is one of three pillars in the Joyint ecosystem: Joy for planning, Jot for execution, Jon for understanding. When Joy dispatches a task to you personally, it can land in Jot. When a Jot 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 Jot. You do not need the Joyint platform. Jot is a standalone MIT-licensed tool that does one thing well: manage your personal tasks from the command line.