🚀 Five-minute start
Download, open, add one task. That's the whole tutorial — everything else on this page is optional.
- Install. Grab the latest build from the Releases page.
- Open it. Smart lists on the left, tasks on the right — no account, nothing to configure.
- Add a task. Type it with a plain-language due date and press Enter.
- Finish it. Click the circle; the banner undoes mistakes in one click.
Expected result: saved tasks remain available after reopening.
⚡️ Scheduling shortcuts
Type a task, then add a scheduling modifier at the end. Taskly extracts the modifier, parses it into a date and time, and leaves the rest as the task text. No calendars to scroll, no dials to turn.
There are two modifiers: + for relative time, and @ for an exact time of day. You can use one or both.
➕ Relative time
A + followed by a number and a unit means "that much time from now."
| Syntax | Unit | Example | Meaning |
|---|---|---|---|
+10m | minutes | +30m | 30 minutes from now |
+2h | hours | +2h | 2 hours from now |
+1d | days | +1d | 1 day from now |
+1w | weeks | +2w | 2 weeks from now |
+1M | months (30 days) | +6M | 6 months from now |
m = minutes, uppercase M = months. h = hours, d = days, w = weeks. The number may be omitted (e.g. +d means 1 day).
Updates replace application files, never the data directory. On failure, reinstall the previous trusted build using the same installation shape; do not bypass a failed signature check.
⏰ Exact time
A @ followed by a time sets a specific moment today. You can pin it to tomorrow or a weekday.
| Syntax | Example | Meaning |
|---|---|---|
@10am | @9am | 10:00 today |
@10:30pm | @10:30pm | 22:30 today |
@22:30 | @22:30 | 24-hour time |
@now | @now | This exact moment |
@10am tomorrow | @8am tmw | tomorrow at that time (tmw works too) |
@8pm mon | @6pm fri | next Monday/Friday at that time |
Weekday abbreviations: mon, tue, wed, thu, fri, sat, sun.
📅 Absolute dates
In the inline editor or with the CLI --due flag, you can type a full date instead of a modifier. These always set the date with no time.
| Format | Example |
|---|---|
yyyy-MM-dd | 2026-08-07 |
yyyy/MM/dd | 2026/08/07 |
MM/dd/yyyy | 08/07/2026 |
dd/MM/yyyy | 07/08/2026 |
✨ Putting it together
The modifier lives at the end of the task text. Anything before it becomes the task title.
🗓 Smart lists
The four tiles at the top of the sidebar are automatic views, built from every list:
Today
Tasks due today or overdue.
Planned
Everything with a future date or time.
All
Every task, grouped by list.
Completed
Finished tasks, kept for review.
Each tile shows a count badge. Click any tile to filter the task pane.
📂 Custom lists
Below the smart tiles, create your own lists to separate Work, Life, Ideas, and so on. Each list gets an emoji icon and a color.
Create
Click the + next to "My Lists." A default emoji (📋) and blue color are applied if you skip them.
Edit
Double-click a list to rename it or change its icon/color.
Move a task
Right-click a task → "Move to list" → pick the target.
Delete a list
Deleting a list removes all tasks in it (cascade).
✏️ Editing tasks
Taskly edits a task in place, so its identity and list context stay visible.
Inline editing
Complete / uncomplete
Click the round checkbox. Instant, no mode.
Edit text + date + notes
Double-click the task row. Press Enter to save, Esc to cancel.
Task details layer (ⓘ)
Open
macOS preview: click ⓘ on a task row. The layer carries completion, title, date, time, priority, tags, subtasks, notes, URL and list membership.
Autosave
Every change saves as it is made; closing never discards. A failed save anchors an actionable error to its field.
Close
Esc, clicking outside, or the Done action. The layer also closes when its task leaves the current view.
Inline editing (title click / double-click / Enter)
Open
Click the task title, double-click the row, or select it and press Enter.
Fields
Task text, notes, date, and time — all editable.
Date & time
Click the date/time buttons to open pickers. Clear to remove.
Save or cancel
Enter or clicking another row saves the complete draft. Escape cancels every changed field.
Deleting one or several tasks hides them for about six seconds. Undo restores the original task IDs and metadata; after timeout the delete is committed.
Keyboard: Command/Ctrl+1…4 switches smart views, Command/Ctrl+N focuses quick add, Command/Ctrl+F focuses search, and Command/Ctrl+Shift+C toggles completed tasks.
⌘ Command-line interface
The source tree includes a developer CLI with stable JSON output. Desktop release packages do not yet include a standalone CLI binary.
From a source checkout with Racket installed:
| Command | What it does |
|---|---|
list | List tasks (filter by list/view/status) |
lists | List all task lists |
add "<text>" | Add a task (--list, --due, --time, --notes) |
update <id> | Edit a task |
done / undone | Set complete/incomplete (idempotent) |
rm <id> | Delete a task |
search "<kw>" | Fuzzy search tasks |
mklist / rmlist | Create / delete a list |
The --due flag uses the same scheduling syntax as the GUI:
Exit codes: 0 success · 1 generic error · 2 validation failed · 3 not found · 4 database error.
🔄 Backup and migration
Taskly stores tasks in a local SQLite database. Quit every process before backing up or moving the complete data directory; verify restoration on a copy.