Quick Start

Running jott

Simply run jott in any directory:

jott

You can also add an initial task from the command line:

jott "feed the cats"
jott buy groceries and milk

Tasks are stored in a .jot.json file in the current directory. Each directory maintains its own task list.

Modes

jott operates in two modes:

Quick-Add Mode (Default)

• Start typing immediately to add tasks

• Press Enter to save the task

• Press ESC to switch to Command mode

• Use Up/Down or Ctrl+N/P to navigate tasks

• Use Shift+Up/Down to reorder tasks

• Press Ctrl+X to quit

Command Mode

• Press a to return to Quick-Add mode

• Use single-key commands (see below)

• Navigate and manage tasks

Essential Commands

Task Management

Key	Action
a	Switch to Quick-Add mode
c	Mark task as current
d	Delete task by ID
D	Delete current task (Shift+D)
e	Edit task by ID
E	Edit current task (Shift+E)
M	Move current task to different project (.m in quick-add)
r	Refresh task list
h	Show help
q	Quit

Navigation

Key	Action
Up / Ctrl+P	Previous task
Down / Ctrl+N	Next task
Shift+Up	Move current task up in priority
Shift+Down	Move current task down in priority

Quick-Add Shortcuts

Key	Action
Ctrl+R	Register current project
Ctrl+U	Open URLs from task text
Ctrl+F	Fuzzy search mode
Tab	Cycle through categories
Shift+4	AI-powered task suggestion
*	Highlight color picker (7 colors)
~	Quick highlight toggle (yellow)
Ctrl+L	Assign parent task (subtask link)
. + key	Leader chord (see full list in Features)

Cross-Project Routing

Send tasks to specific projects from anywhere:

# Add task to rubber-ducky-live project
jott rubber-ducky-live 'implement OAuth refresh tokens'

# List all registered projects
jott --list-projects

# View all projects with their tasks
jott --all-projects

# Broadcast to all projects
jott --all "Update dependencies"

Next Steps

• Configuration — Customize keywords, categories, and integrations

• Features — Deep dive into all features