Skip to content
- Setting medium, high, or urgent priority moves inbox tasks to todo, including when creating tasks.
- Fix: Pressing
! for marked tasks uses the same n, l, m, h, and u priority shortcuts as a single task.
aven sync shows a concise summary with readable attachment sizes and remaining work; use --json for exact structured results.
- Choose which TUI task-list columns appear and their order with
tui.table.columns.
- Enable the experimental TUI robot column to spot agent-created tasks, using CLI creation as the indicator. Opt-in and disabled by default.
- Render the TUI status column as icons only with
tui.table.compact_status. Off by default.
- The website and documentation use aventasks.dev.
- Press
! to choose a task’s priority directly from TUI task lists or task details.
- Linked task references in the TUI use their own project’s color, making cross-project relationships easier to recognize.
- Fix: Undoing a note deletion no longer prevents undoing that note’s creation when the changes have not yet synced.
- View and edit custom task metadata in the TUI, with inline editing for short values and external-editor support for multiline values. (#9)
- Customize which TUI sidebar views appear and their order in config.
- Collapse sidebar sections to keep navigation focused on what you need, with preferences remembered across restarts.
- Fix: More reliable sync after offline edits and with large batches of changes. Sync requires updating both the server and clients to this release.
- Fix: Various fixes for task recovery, recurring tasks, project settings, and mouse navigation.
- Perf: Faster browsing and bulk updates for large task collections, including task details, Recent Actions, and recurring-task history. Sync and attachment cleanup also do less background work.
- Fix: Attachment sync and cleanup protect files still used by tasks during deletion, restoration, conflict resolution, and background checks. Cleanup also works when attachment storage spans filesystems.
- Fix: Upcoming keeps tasks in the correct date groups when the TUI stays open past midnight.
- Fix: Task details handle tasks deleted during refresh without displaying incomplete or outdated information.
- Fix: Undoing a task field change restores its previous idle age unless newer activity has updated it.
- Fix:
aven doctor --integrity checks attachment files after its database checks, capturing file changes made while those checks run.
- UX: Epic details show each child’s blockers on one compact line. Open the child task to see all its dependencies.
- Task details include a collapsed activity log for inspecting the changes behind a task’s idle age, with concise values for labels, statuses, notes, and relationships.
- Install the bundled Aven agent skill for Pi with
aven skill install --agent pi.
- CLI help explains every command and argument with concise guidance and examples.
- Use
aven sync status and aven daemon status to inspect sync health, pending work, conflicts, and background service operation in human-readable or JSON output without contacting the server or changing daemon state.
- Open Ready, Blocked, and Overdue views from the TUI sidebar, command palette, keyboard shortcuts, or
aven tui --view.
- The TUI sync status view highlights health and pending work, stays up to date while open, and provides direct actions to sync or review conflicts.
- Inline image previews work automatically in Warp Terminal. (#19)
- Fix:
aven doctor remains available when startup configuration or database checks fail.
- Fix: Sync keeps working when a recurring series projects an occurrence into a deleted project, and deleting a project stops its recurring series while keeping already projected tasks. (#15)
- Fix: Pressing
Enter on a highlighted sidebar row selects that view, project, or workspace again instead of opening the detail of the task selected in the list. (#16)
- Fix: TUI sorting, filtering, and compatible view changes keep the same task selected when it remains visible, with predictable nearby selection when it does not.
- Running
aven with no command opens the TUI directly. Global options such as --db and --workspace still apply.
- Use Columns as a layout for the active task view. Press
v l to switch between Columns and List without changing which tasks are shown.
- UX: The TUI command palette prioritizes actions for the focused task, marked tasks, detail row, or sidebar item and keeps that target through pickers and confirmations.
- UX: Task list selection uses a stable
› cursor so the focused task remains clear across terminal themes, inactive panes, and monochrome output.
- New: With Related tasks, you can link tasks that share context without making one block the other or putting them in the same epic. Links appear on both tasks and can be managed from the CLI or TUI.
- UX: Workspace controls keep workspaces in a stable order, and clicking the header switches directly when only two workspaces are available.
- UX: Undoable TUI changes now offer
u undo in toasts, while the command panel and shortcut help describe the operation and affected task count before it is undone.
- Recurring tasks support every N days, weeks, months, or years, including anchored month-end and leap-day behavior without schedule drift
- The TUI task composer automatically sets prioritized and repeating tasks to todo. Choose a status manually to override it, or pick
Auto to restore the automatic choice.
- Search finds a recurring series by the
RCR- ref shown on its task rows. (#14)
- Fix: Searching a task ref whose project prefix contains digits, such as
0M-XYMT, finds the task, and accepting a search result in the TUI keeps showing it. (#13)
- Fix: A custom TUI command that exits early reports its own exit status instead of an input delivery error, and timed-out commands clean up leftover child processes.
- Configure experimental custom TUI commands to run local programs from the command palette or keybindings and pass selected or marked task context.
- Fix: CJK, emoji, and other wide-character text fits correctly in TUI fields and layouts, and input method composition appears at the active caret. (#10)
- Sync is more reliable on slow or unstable connections, coordinates daemon and manual operations, and downloads only attachments referenced by live tasks.
- Fix: The changelog reader (
:changelog) fetches the latest release notes independently of cached update checks and wraps entries cleanly to the dialog width.
- Task details show the project key and color beside the task reference
- Parent epic rows in child task details include the epic star marker for easier recognition at a glance.
- The bundled Aven agent skill heavily trimmed down from cruft
- Add task metadata with
--metadata KEY=VALUE, exact and presence filters, bulk updates, field listing and renaming, and full text, JSON, and Markdown detail output. Metadata values are opaque strings, and renaming a field preserves its stable identity without rewriting every task.
- The Epics view summarizes child completion, ready, blocked, overdue, and recent activity directly in parent rows, with responsive progress such as
1/5 done and distinct canceled counts.
- Epic detail views show unresolved blockers beneath affected child tasks.
- Open the Recurring Tasks view directly with
aven tui --view recurring.
- Read and update supported non-secret settings with
aven config get and aven config set, including sync, update-check, database-path, and image optimization settings. Updates preserve comments and unrelated settings.
- Fix: Sorting by updated time shows the most recently updated tasks first by default.
- Fix: Task details stay in sync after changes, including status and notes, while preserving the scroll position.
- New: Press
Ctrl-g in the task composer to create a task and immediately start another with the same project, status, priority, and labels.
- Marked tasks open a dedicated bulk-action mode that highlights compatible commands, explains single-task restrictions, and clears all marks with
Esc.
- Copy references, durable IDs, or titles for marked tasks as one value per line in their visible list order.
- Browse command palette results with the arrow keys and
Enter, cycle the full catalog with Tab or Shift-Tab, and track your position with a scrollbar.
- Empty task views explain better why no tasks are shown and suggest relevant actions.
- Blocked tasks are dimmed in lists and Columns, help headings have clearer visual hierarchy, and nested dialogs render with faster, more consistent background dimming.
- Routine view, scope, filter, ordering, and workspace changes avoid redundant success messages when the updated state is already visible.
- New: Create and edit epics in the TUI, or promote an ordinary task when adding its first child.
- New: Click any editable metadata value in task details to change the project, status, priority, labels, availability, or due date.
- New: Multiline editors confirm before discarding changed content, and individual notes can be edited, deleted, and restored with undo.
- New: Create, browse, rename, and delete labels, create and rename workspaces, manage project paths, and create projects from task workflows in the TUI.
- New: Save attachments from task detail with explicit handling for missing data, invalid destinations, and existing files.
- New: Open Upcoming from the shared command catalog, open tasks from Recent Actions, and receive series-specific guidance for task commands in the Recurring view.
- New: TUI mutations wake the sync daemon,
:sync starts a manual sync, and sync-disabled environments preserve local-only operation with clear errors.
- Fix: Task detail commands consistently target the displayed or focused related task, with direct actions for linked tasks and reliable back and sibling navigation.
- Fix: TUI task and label workflows apply their changes atomically and restore labels created by the same operation during undo.
- Fix: Trackpad scrolling stays responsive at list and help boundaries, while modal dialogs and help overlays present clearer visual structure.
- Fix: Consecutively deleted tasks remain visible in the TUI until an explicit refresh.
- Create and manage recurring tasks from the CLI or TUI with flexible schedules, history and lifecycle controls, cross-device sync, and portable backup and export workflows.
- Open release notes with
:changelog, by clicking the version in the header, or inside the update dialog.
- Search within one project with
aven search --project. JSON results include the same task fields as list output.
- Bulk updates include matching tasks scheduled for a future date. If any update fails, no selected tasks are changed.
- Set task status during creation and list open work available now with
aven add --status and aven list --open.
- Perf: Large task lists, recurring-task refreshes, live searches, and TUI rendering stay more responsive.
- Epics start collapsed, selected-task previews show due dates, and active filters remain visible in constrained TUI headers.
- Nested dialogs have clearer visual depth, and task composers stay compact while adapting to longer descriptions and schedule editors.
- Detached natural-language task creation sends a system notification when it finishes after the originating TUI exits.
- Fix: Attachment sync accepts UTC timestamps with fractional seconds.
- Out-of-range
--limit values return clear errors for list, search, and recurrence history.
- Long task titles wrap in the detail pane and remain fully selectable and copyable.
- Natural-language task intake respects an explicitly selected project, keeps directory-based project inference available, and closes the composer after creating a task with an image.
- Press
g . to return to a task after moving it out of the active project.
- Epics show accurate project-scoped counts, support viewing closed items with
f d, and expand or collapse with l or Right.
- Selecting an epic child highlights its visible parent for clearer context.
- Exact command palette matches are selected immediately, and repeated
Tab presses cycle through the other matches.
- Deleted tasks remain visible during background refreshes so they can be reviewed or restored until the view is explicitly refreshed.
- Note discard confirmations render cleanly without overlapping the editor.
- Copy task text from the Linux TUI on Wayland or X11 with
wl-copy or xclip.
- Sync failures include useful server details and specific guidance for authentication, configuration, rate limits, and server errors. Protocol mismatches identify whether the client or server needs an upgrade.
- Task changes and their undo history are saved together, preventing partial updates when a write fails.
- The TUI keeps task lists, detail views, selections, and edit targets consistent when an update fails or needs to be retried.
- Manage epic children from the TUI by adding existing tasks, creating new tasks, removing links, and undoing relationship changes.
- Open linked tasks directly from detail views, including tasks outside the current filter, and return through your detail history with
Esc.
- Edit the project, priority, availability, due date, or labels for marked tasks as a batch while keeping your marks available for follow-up changes.
- Note drafts with meaningful text ask for confirmation before
Esc discards them.
- Task detail help includes navigation shortcuts for moving through tasks, returning to previous views, and revisiting the most recently changed task.
- Status changes keep your place in task lists, Columns, and detail views. If a changed task leaves the current view, press
g . to return to it and then go back.
- Explore Aven with
aven demo, which opens a fresh sample workspace and discards all changes when you exit.
- Task details remain responsive while scrolling through inline image previews, which reappear as soon as scrolling settles.
- Attach images to tasks from the TUI or CLI, sync them between devices, preview and switch between them inline, inspect their metadata, and open them in the system viewer.
- Click task references and timestamps in task details to copy their displayed values.
- Search results and task details mark epics consistently, and child task details show their parent epic for clearer context.
- Navigate epic children from task details with
Tab, j/k or the arrow keys, and Enter.
- Due dates use compact labels in the task list so deadlines fit cleanly in the time column.
- Set task availability to defer work until a date or time, and find deferred tasks in the Upcoming view.
- Add due dates independently of availability, with overdue filtering and deadline-aware queue ordering for visible, actionable tasks.
- The documentation includes a complete CLI command reference and a practical VPN sync setup guide.
- The TUI automatically checks for new releases and offers guided installation, with tailored instructions for package-managed installations.
aven update checks for and installs application updates. Task field changes use aven edit <ref>, a breaking command rename for scripts and agents.
- Task detail views support dragging across rendered titles and descriptions and copying the selected text with
y.
Ctrl-Enter submits task composers and multiline editors, with Ctrl-s as a portable fallback.
- Batch actions clearly indicate when they target marked tasks, and status changes use the status picker.
- Multiline editor controls remain visible as content grows, and note prompts appear only on empty drafts.
- Move selected or marked tasks directly between Columns lanes with keyboard or mouse controls, with batch moves grouped into one undo step.
- Improved the default Columns workflow with lifecycle-based lanes, ordering tailored to each lane, and a toggle for the selected-task preview.
- Task previews render Markdown formatting and clearly indicate truncated text.
- Configured database, workspace, and project paths support
~ for the home directory.
- Added a configurable Columns view for navigating tasks in named status lanes.
- Redesigned the task composer so project, status, priority, labels, title, and description stay visible and are accessible by keyboard or mouse.
- Added task copy shortcuts for refs, titles, descriptions, notes, and combined task text.
- Improved task detail navigation with a shortcut that jumps directly to notes.
- Added a guided Taskwarrior migration workflow to the documentation.
- Improved daemon and server startup in Linux services, containers, and other environments without writable state directories.
- Selecting an epic in the task list highlights its child tasks for easier scanning.
- Task composer labels can be set while creating a task.
- TUI timestamps display in local time across task details, notes, recent actions, and database stats.
- Database diagnostics show sync history size, synced and pending change counts, server sequence range, and payload bytes.
- Task list selection stays visible when queue group headers remain pinned.
- Back navigation from an epic child detail returns to the parent detail view and scroll position.
- Epic detail views list child tasks inline, with mouse hover and click targets for jumping to visible child tasks.
- The queue keeps blocked tasks below actionable groups and gives more weight to tasks that unblock other work.
- The TUI sidebar preserves selection more consistently when switching focus, toggling the sidebar, or applying task changes.
- Crashes are written to the aven log file with panic details for easier troubleshooting.
- Added
aven skill install so Claude Code, OpenCode, and Codex can install the bundled task-management skill into their agent skill directories.
- Added a Recent Actions view in the TUI for reviewing task, project, label, and dependency activity.
- Improved the TUI queue with epic parent and child context, a
SOON band, created-age metadata, tighter task and label column sizing, and consistent metadata spacing.
- Added batch editing in the TUI: mark multiple tasks, then apply one status change or add and remove labels across the selected tasks in a single action.
- Improved TUI navigation and controls with back navigation, footer status hotkeys, mouse-scrolled help overlays, and clearer terminal startup errors.
- Improved task detail and preview panels with epic metadata and parent markers.
- Made natural task creation from the full TUI continue reliably after exiting the interface, while keeping created tasks undoable when the TUI remains open.
- Improved daemon update handling so launchd services use a stable executable path, restart cleanly, and show richer status in
aven doctor.
- Initial release of
aven, a local-first task manager. See Getting started to install it and create your first task.