Quick Start
===========

Running jott
------------

Simply run ``jott`` in any directory:

.. code-block:: bash

   jott

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

.. code-block:: bash

   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
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 15 85

   * - 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
~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 15 85

   * - 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
~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 15 85

   * - 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:

.. code-block:: bash

   # 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
----------

- :doc:`configuration` — Customize keywords, categories, and integrations
- :doc:`features` — Deep dive into all features