track today and vice versa. The app is installable to your phone’s home screen or desktop, and it loads offline so it opens even without a network connection.
Logging in
When you open the app for the first time, you’ll see a sign-in form. Enter your username and password — the credentials created when your account was set up withtrack user add <name>. You can also sign in with a passkey if you have one registered. Your session is stored in localStorage, so you only sign in once per browser.
You can create and delete additional per-device API keys from Settings → api keys. If a key is compromised, delete it there or via the CLI. You can also register hardware security keys and platform authenticators (Face ID, Touch ID, Windows Hello) under Settings → passkeys.
Navigation lenses
The tab strip across the top of the app is driven by a set of lenses — each one is a pre-filtered view of your items:| Lens | What you see |
|---|---|
| today | Items due today or tomorrow, bucketed by day |
| all | Every open item, bucketed by due date |
| shop | Shopping, gifts, and groceries grouped by kind |
| chores | All chores, grouped by recurrence interval |
| projects | The project directory (features, requirements, tasks) |
Expanding items
Click any row to expand it inline. The expanded panel shows all fields and gives you snooze shortcuts:Pick a snooze duration
Tap 1d, 3d, or 1w to push the due date out by that interval immediately. The item’s due date updates and the row re-sorts.
Completed toggle
The today and all lenses have a “completed” toggle at the bottom of the list. Turn it on to reveal finished items, grouped by when they were completed:- today — completed since midnight
- yesterday — completed the previous calendar day
- earlier this week — completed within the past seven days
- earlier this month — completed within the past thirty days
- earlier — anything older than thirty days
Mobile gestures
On a phone or tablet the app responds to touch gestures directly on list rows:- Swipe right — mark the item complete (equivalent to
track done <id>) - Swipe left — delete the item
Keyboard shortcuts
Press ? anywhere in the app to open the keyboard shortcut reference overlay. Common shortcuts:- / — focus the omnibar and enter command mode
- ↑ / ↓ — move focus between rows
- ⌘↵ / Ctrl↵ — create a new item from the omnibar text
- Esc — clear the omnibar or collapse the focused row
Adding items
The omnibar at the top of every lens doubles as a quick-add bar. Type a title and press ⌘↵ (Mac) or Ctrl↵ (Windows/Linux) to create a new item of the current lens’s kind. You can also prefix your text with a slash command —/todo, /chore, /buy, /grocery, /gift — to add a specific kind from any lens. Token shortcuts work in the title:
#tag— attach a tag!p2— set priority to 2@project-slug— attach to a project (tasks only)
track edit <id> from the CLI.
Omnibar
Full slash-command reference: navigate, create, export, and snooze without touching the mouse.
Settings
Share lists, subscribe your calendar app, and export or import a JSON backup.