This is the full developer documentation for aven # Work with agents > Connect coding agents and other AI integrations to Aven. Aven gives AI agents access to the same local task system you use in the TUI. Coding agents can inspect project context, find ready or blocked work, create and edit tasks, manage status, schedules, and relationships, and leave durable handoff notes. Chat integrations can turn messages or transcripts into tasks through the CLI and sync them to your other devices. ## Install the aven skill [Section titled “Install the aven skill”](#install-the-aven-skill) ```sh aven skill install ``` `aven skill install` writes the bundled skill to every detected coding-agent skill directory. Detection checks Claude Code, OpenCode, Codex, and Pi user directories, plus matching agent config directories in the current workspace. Use `--agent` to choose explicit targets: ```sh aven skill install --agent claude aven skill install --agent opencode aven skill install --agent codex aven skill install --agent pi ``` The user skill locations are: * Claude Code: `~/.claude/skills/aven/SKILL.md` * OpenCode: `~/.config/opencode/skills/aven/SKILL.md` * Codex: `~/.codex/skills/aven/SKILL.md` * Pi: `~/.pi/agent/skills/aven/SKILL.md` Explicit targets are installed even when the agent directory is absent. The command reports a clear error when no supported agent is detected and no target is provided. ## Set up automatic priming [Section titled “Set up automatic priming”](#set-up-automatic-priming) Run `aven prime` automatically when an agent session starts so its output is available to the agent from the first model turn. ### Claude Code [Section titled “Claude Code”](#claude-code) Add a `SessionStart` hook to `~/.claude/settings.json`: ```json { "hooks": { "SessionStart": [ { "matcher": "", "hooks": [ { "type": "command", "command": "aven prime" } ] } ] } } ``` ### Pi [Section titled “Pi”](#pi) [Pi](https://pi.dev) extensions in `~/.pi/agent/extensions/` apply globally. Create the directory, then add `~/.pi/agent/extensions/aven-prime.ts`: ```sh mkdir -p ~/.pi/agent/extensions ``` ```typescript import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; export default function (pi: ExtensionAPI) { let primeOutput: string | undefined; let delivered = false; pi.on("session_start", async (event, ctx) => { if (event.reason === "reload") return; primeOutput = undefined; delivered = false; const result = await pi.exec("aven", ["prime"], { cwd: ctx.cwd, timeout: 30_000, }); if (result.code !== 0) { ctx.ui.notify( `aven prime failed: ${result.stderr.trim() || `exit code ${result.code}`}`, "error", ); return; } primeOutput = result.stdout.trim(); }); pi.on("before_agent_start", async () => { if (delivered || !primeOutput) return; delivered = true; return { message: { customType: "aven-prime", content: primeOutput, display: false, }, }; }); } ``` The extension uses two lifecycle events because they serve different purposes. `session_start` runs `aven prime` once in the session working directory and caches its output. `before_agent_start` is the point where Pi accepts context for a model turn, so it injects the cached output as a hidden message on the first turn only. Reload events are skipped to avoid injecting a second copy into the same session. Pi profiles can share the same extension source. For a profile rooted at `~/.pi-epic`, link its extension directory to the default profile: ```sh mkdir -p ~/.pi-epic/agent ln -s ~/.pi/agent/extensions ~/.pi-epic/agent/extensions ``` Both profiles then discover `aven-prime.ts` through their global extension directory. Run `/reload` in an open Pi session after editing the extension. Other agent environments can use the same pattern: run `aven prime` at session start and include its output in the agent context. ## Project context [Section titled “Project context”](#project-context) aven infers the active workspace and project from the current directory. Start an agent from a repository directory and automatic priming loads the matching project context. Use [Configuration](/configuration/) when directory names, workspace routes, or project path mappings need to be explicit. Use `aven doctor` from the same directory to inspect the active database, workspace, project, and routing decisions. ## Work on tasks with coding agents [Section titled “Work on tasks with coding agents”](#work-on-tasks-with-coding-agents) A typical workflow looks like this: 1. Capture or triage work in aven. 2. Start your agent from the repository directory. 3. Let the startup hook load aven context. 4. Ask the agent to work on a specific ref, or to choose ready work. 5. Review the code change and the task note the agent leaves behind. Example prompts: ```txt Work on APP-7KQ9. Use aven for status and handoff notes. ``` ```txt Pick a ready docs task and complete it. ``` ## Durable handoff [Section titled “Durable handoff”](#durable-handoff) Descriptions hold the main task context: problem statement, scope, acceptance criteria, and links. Notes hold durable handoff context: implementation decisions, blockers, partial progress, and review findings. Agent notes survive chat sessions, branch switches, worktrees, and machine restarts. Protect durable context Keep secrets out of titles, descriptions, labels, projects, notes, and logs. ## Skill or prime? [Section titled “Skill or prime?”](#skill-or-prime) Use the installed skill and priming for different levels of commitment: | Setup | What the agent receives | Choose it when | | --------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Installed skill | Reusable aven instructions loaded on demand | You want the agent to know how to find tasks, update status, and leave handoff context when the request calls for task management, without adding open-task context to every session. | | `aven prime` | Aven instructions plus live active, ready, and blocked work for the current project | You want the agent to see current task context as part of session startup. | | Both | On-demand aven knowledge everywhere, and live task context in selected sessions | Aven is part of your workflow, but only some projects need automatic task context. | `aven prime` includes the same guidance as the installed skill. A prime hook is the best fit for projects where the agent should connect the current work to active, ready, or blocked tasks without being asked to run a command first. Installing the skill is the best fit for agent sessions where task-management requests should load aven guidance on demand, while live task context can be loaded only when useful. A common setup is to install the skill globally, then add a project-local prime hook only in repositories tracked in aven. That keeps agents aware of aven everywhere and gives them open-task context where it is useful. ## What prime includes [Section titled “What prime includes”](#what-prime-includes) `aven prime` is the agent bootstrap command. It prints the aven skill plus open work for the inferred project. The open work is grouped by pickability: | Group | Meaning | | ------- | -------------------------------------------- | | Active | Work already in progress | | Ready | Open work with dependencies resolved | | Blocked | Open work waiting on unresolved dependencies | A prime output includes the full skill first. The open-task part looks like this: ```txt ## Local Conventions Project: aven Open issue sample: 5 Use sentence case for task titles: capitalize the first word and proper nouns, not every significant word. Common statuses: active=2, inbox=3. Common labels: keybindings=1, ux=1. ## Open Issues Summary: total=5 active=2 ready=3 blocked=0 Top blockers: none. ### Active AVN-RQ4N status=active title="Investigate task dependencies or epics" AVN-F74G status=active title="Add full mouse support to the tui" ### Ready AVN-Z55V status=inbox priority=high title="Add due dates or scheduling" AVN-CDEQ status=inbox title="Documentation site" AVN-12YM status=inbox labels=keybindings,ux title="Resolve Ctrl+P keybinding conflict" ### Blocked (none) ``` ## The aven skill [Section titled “The aven skill”](#the-aven-skill) ```sh aven skill ``` `aven skill` emits the reusable agent-facing guidance for operating aven. It teaches agents how to use refs, inspect tasks, update status, create follow-up work, leave notes, handle long Markdown, and avoid unsafe task mutations. The separate command is useful for debugging or custom agent integrations. The source guidance lives in [`src/skill.md`](https://github.com/raine/aven/blob/main/src/skill.md). ## Connect MCP clients [Section titled “Connect MCP clients”](#connect-mcp-clients) Claude Desktop, ChatGPT, and other MCP clients can work with your tasks through `aven mcp`. See [MCP server](/mcp/). ## Connect chat integrations [Section titled “Connect chat integrations”](#connect-chat-integrations) OpenClaw and similar AI assistants can turn chat messages or voice notes into Aven tasks. This is useful for recording ideas as they come up, especially when you’re on the go. Include the output of `aven skill` in the agent’s instructions, then have it call `aven add` with an explicit workspace and project. If the agent runs on another machine, `aven sync` shares the created tasks with your other devices. ![Telegram voice message transcribed into an Aven task](/telegram-voice-task-light.webp) ![Telegram voice message transcribed into an Aven task](/telegram-voice-task-dark.webp) A Telegram voice message is transcribed into a project-scoped Aven task. # Back up and restore > Preserve, restore, or move Aven data safely. Choose the command that matches what you need to preserve: | Goal | Commands | Image files included? | | ------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------- | | Preserve or move all local Aven data | `aven backup` and `aven backup restore` | Yes, for images available on this device when the backup is created | | Move task data through JSON from a database that doesn’t sync | `aven export` and `aven import` | No | ## Create and restore a complete backup [Section titled “Create and restore a complete backup”](#create-and-restore-a-complete-backup) ```sh aven backup aven backup --output backup.aven-backup.tar.zst aven backup restore backup.aven-backup.tar.zst --yes ``` Without `--output`, Aven writes a timestamped backup beside the active database. Use `--output` when you need a specific destination. A backup archive contains the local data from a consistent SQLite snapshot and every attachment image available on the device. Recurring schedules, future-task settings, completed, skipped, and missed history, pauses, conflicts, task fields, notes, and attachments remain intact. Sync bindings, enrollment state, and encryption keys are excluded, so a restored copy is local only. Images that have not downloaded cannot be included. Run `aven sync` first when the sync server may have files this device lacks. Restore checks the archive and images before replacing local data. Local data replacement Restore replaces local data and requires confirmation with `--yes`. Aven creates a safety backup first and preserves the previous attachment directory. ## Recover data used with sync [Section titled “Recover data used with sync”](#recover-data-used-with-sync) A database that has set up or joined end-to-end encrypted sync can create a backup, including while setup or joining is incomplete. It still refuses restore and import because replacing data in a database that takes part in sync is unsafe. The CLI directs you to restore or import into a fresh database path instead of printing the internal refusal chain. If one device is lost or broken, use a surviving device instead of a backup: run `aven sync invite` there, then run `aven sync join` on an empty database on the replacement device. If every syncing device is lost, restore the backup to a fresh database path: ```sh aven --db /path/to/recovered.sqlite backup restore backup.aven-backup.tar.zst --yes ``` The restored data works locally immediately. To sync again, prepare a new server data path with `aven server setup`, serve that storage, and run `aven sync setup` against the restored database. Do not reuse the previous sync’s server storage. Other devices must join the new sync from empty databases. Changes made after the backup and never synced are not carried into the new sync. Check any old database you can still access before discarding it. See [Recover from device loss](/sync/setup/#recover-from-device-loss) for the complete command sequence. ## Export and import portable JSON [Section titled “Export and import portable JSON”](#export-and-import-portable-json) ```sh aven export --output tasks.json aven import tasks.json --yes ``` A JSON export includes tasks, recurring schedules, future-task settings, history, pauses, conflicts, and attachment information. It sets `blobs_included: false` and leaves out image files. An export from a database that has set up or joined sync can’t be imported, including into a new database. Use [`aven backup`](#create-and-restore-a-complete-backup) to preserve or move synced data. Import validates recurring schedules, generated tasks, history, and recurring state before replacing local data. Older task-only exports import every task as nonrecurring data. Import keeps this installation’s client identity and resets the sync cursor and established compatibility behavior. When the export contains history already accepted by a sync server, import retains that server binding so Aven cannot silently treat the history as belonging to a different server. Imported history must fit the maintained baseline; incompatible records are rejected before local data is replaced. A SQLite backup preserves the database relationship and its established behavior together. Local data replacement Import replaces local data and requires confirmation with `--yes`. Aven creates a safety backup first. ## Restore attachment images [Section titled “Restore attachment images”](#restore-attachment-images) After importing JSON, attachment labels remain visible while the TUI shows unavailable-image placeholders, and [`attachment get --output`](/command-reference/#aven-attachment) cannot save the image. Sync does not restore these images: Aven does not publish them because the JSON lacks the image bytes. Use a backup archive instead when moving images. Restoring that archive replaces the database and restores the included image files together. A complete backup includes only images available locally when it is created. If you synchronize attachments, confirm that sync is complete before creating the archive. See [Image attachments during sync](/sync/setup/#image-attachments-during-sync). See [Data safety commands](/command-reference/#data-safety-commands) for every backup, restore, export, and import option. # Changelog > Release notes for aven. [CLI & TUI](/changelog/)[iPhone](/changelog/ios/)[Android](/changelog/android/) November 6, 2026Latest ## v0.1.55 [Section titled “v0.1.55”](#v0-1-55) Improved * Agents file “up next” and “top priority” requests as todo tasks with medium or high priority, and “someday” requests as backlog. Run `aven skill install` again to update installed skills. Fixes * Joining encrypted sync works on Linux filesystems that limit filenames to 143 bytes, such as eCryptfs, instead of failing with `protected-key-storage-unavailable`. ([#48](https://github.com/raine/aven/issues/48)) November 3, 2026 ## v0.1.54 [Section titled “v0.1.54”](#v0-1-54) New * `aven mcp --http` serves MCP Streamable HTTP with a bearer token from `AVEN_MCP_TOKEN`, and `--sync` runs sync inside that process, so an agent in another container needs only a URL and token. See [HTTP and containers](https://aventasks.dev/mcp/#http-and-containers). ([#35](https://github.com/raine/aven/issues/35)) Fixes * Clear the TUI sync error once a sync restores Keychain access. * Keep the same task’s details open after changing its status, even when it moves in the list or leaves the current filter. ([#44](https://github.com/raine/aven/issues/44)) November 2, 2026 ## v0.1.53 [Section titled “v0.1.53”](#v0-1-53) New * Self-hosted sync servers can now power [Tell Aven](https://aventasks.dev/mobile-app/#tell-aven) on iPhone and Android. Run `aven server ai setup` to choose a provider and model, and `aven ai check` to test the running server. See [Server configuration](https://aventasks.dev/server-configuration/#ai-for-tell-aven). Fixes * Refuse project path conflicts instead of silently evicting the existing owner. Use `aven project path add --move` to explicitly reassign a managed mapping. ([#40](https://github.com/raine/aven/issues/40)) October 31, 2026 ## v0.1.52 [Section titled “v0.1.52”](#v0-1-52) Breaking * `aven server` uses a separate `server.yaml` instead of the client configuration. See the [migration guide](https://aventasks.dev/migration-guide/#move-server-settings-to-serveryaml). New * `aven mcp` serves your tasks to Claude Code, Codex, Claude Desktop, and other MCP clients over stdio, and to ChatGPT through OpenAI’s tunnel. It can list, search, count, create, update, note, and delete tasks and manage recurring series. See [MCP server](https://aventasks.dev/mcp/). Improved * Bare HTTP(S) URLs in TUI task descriptions and notes are clickable without Markdown link syntax. * Browse long TUI sidebars with page and half-page keys or the mouse wheel without changing the active view until you press `Enter`. Scrolling focuses the pane under the pointer, and clicking blank task-pane space returns focus to tasks. Thanks [@pnaaberi](https://github.com/pnaaberi). ([#38](https://github.com/raine/aven/pull/38)) * TUI priority icons use one, two, or three signal bars for low, medium, and high, and an alert box for urgent. The icons require a Nerd Font and appear in priority pickers and recurring task views too. Performance * Optimize PNG attachments faster, with a small trade-off in compressed file size. Fixes * Refuse edits to symlinked or read-only config files instead of replacing them, with instructions for making changes through your [config manager](https://aventasks.dev/configuration/#externally-managed-configuration). * Print ambiguous task ref matches to standard error with the rest of the error, instead of to standard output. * Explicitly choosing Inbox keeps a task in Inbox even with medium, high, or urgent priority. Omitting the status still promotes these tasks to Todo. October 21, 2026 ## v0.1.51 [Section titled “v0.1.51”](#v0-1-51) New * Switch workspaces from the TUI sidebar, with available open task counts for each workspace. ([#35](https://github.com/raine/aven/issues/35)) * Changed: `aven`, `aven list`, and `aven search` default to the current directory’s project. Use `--all-projects` (`-A`) or set `scope: workspace` for all projects; TUI search follows the active scope, with `Ctrl+S` to widen it. Improved * Type directly in TUI priority pickers and label filters without pressing `/`, with clearer selection highlights and colored priority icons. * Set custom project prefixes with `aven project create --prefix` or the TUI’s two-field rename dialog (`p r`, `Tab` to switch fields). ([#35](https://github.com/raine/aven/issues/35)) Fixes * Remove the TUI sidebar’s static Filters section and give Backlog a distinct icon. ([#35](https://github.com/raine/aven/issues/35)) * Create labels in the TUI even when their names are substrings of existing labels. ([#35](https://github.com/raine/aven/issues/35)) October 18, 2026 ## v0.1.50 [Section titled “v0.1.50”](#v0-1-50) * Aven for [iPhone](https://apps.apple.com/app/aven-tasks/id6811171767) and [Android](https://play.google.com/store/apps/details?id=fi.zendit.aven) is now available. Jot a task down on your phone and it lands in your terminal queue. See [the mobile apps](https://aventasks.dev/mobile/). * [Aven Cloud](https://cloud.aventasks.dev/), hosted sync for people who don’t want to run their own server. It’s end-to-end encrypted, same as self-hosted. It’s free during the preview. Paid plans may come later, and they’ll be a way to support the project. * Aven is now on X at [@aventasksdev](https://x.com/aventasksdev). I’ll be posting updates there now and then. * macOS installations from Homebrew or the install script show [notifications](https://aventasks.dev/notifications/) with Aven’s name and icon, and identify the background daemon as Aven in Login Items. * Get [reminders](https://aventasks.dev/notifications/#reminders) from the background daemon: a daily digest of tasks due today or overdue, and a notification when a deferred task becomes available. Turn them on with `aven config set reminders.enabled true`. * New [triage mode](https://aventasks.dev/tui/#triage-mode) in the TUI: run `:triage` to go through inbox tasks and stale active or todo work one card at a time and decide what happens to each. October 13, 2026 ## v0.1.49 [Section titled “v0.1.49”](#v0-1-49) * Install the prebuilt binary with Nix, without compiling: `nix profile install https://github.com/raine/aven/releases/latest/download/aven-nix.tar.gz`. October 12, 2026 ## v0.1.48 [Section titled “v0.1.48”](#v0-1-48) * New light mode for the TUI, with automatic light or dark theme selection to match your terminal background. Thanks [@grncdr](https://github.com/grncdr)! ([#31](https://github.com/raine/aven/pull/31)) * New terminal-native mode uses your terminal’s own text and background colors with ANSI-colored accents, following your terminal color scheme. * Set your preferred theme with [`tui.appearance`](https://aventasks.dev/configuration/#tui-appearance), or switch for the current session with `:theme light`, `:theme dark`, or `:theme terminal`. * The Sync dialog offers **Show invitation** to reopen an existing pairing QR code, and `:add-device` points to `:sync` when setup is needed. October 11, 2026 ## v0.1.47 [Section titled “v0.1.47”](#v0-1-47) New * Generate [shell completions](https://aventasks.dev/command-reference/#aven-completions) with `aven completions `; Homebrew installs them automatically. ([#35](https://github.com/raine/aven/issues/35)) * Docker images now accept full aven commands (`server setup` or `server --bind …`), with clearer storage errors and [setup and recovery guidance](https://aventasks.dev/sync/setup/#run-with-docker). Custom image commands must now include `server`. ([#35](https://github.com/raine/aven/issues/35)) * [`aven context`](https://aventasks.dev/command-reference/#aven-context) keeps task descriptions and metadata complete while shortening long note histories. Read omitted notes with `aven note-show`, or use `--full` for every note. Fixes * Rerunning `aven sync setup` can resume an interrupted setup without the original invitation once the server has accepted it. * Undo works after changes have been prepared for encrypted sync, even while offline, and can undo note, project, and label creation after syncing. * CLI and TUI commands no longer fail when log files can’t be written, and storage errors include clearer explanations. ([#35](https://github.com/raine/aven/issues/35)) * TUI shortcut help wraps descriptions instead of clipping them, uses one column on narrow terminals, and lists only commands with hotkeys. ([#33](https://github.com/raine/aven/issues/33)) October 5, 2026 ## v0.1.46 [Section titled “v0.1.46”](#v0-1-46) * A sync-server Docker image is now available at `ghcr.io/raine/aven` for Linux amd64 and arm64. Run it with [Docker or Docker Compose](https://aventasks.dev/sync/setup/#run-with-docker), or build from source. ([#32](https://github.com/raine/aven/issues/32)) October 4, 2026 ## v0.1.45 [Section titled “v0.1.45”](#v0-1-45) Breaking * Unencrypted sync is removed, and servers refuse storage from earlier releases. Sync every device before upgrading, then follow [Upgrade from unencrypted sync](https://aventasks.dev/sync/setup/#upgrade-from-unencrypted-sync) to move to new server storage. New * Sync is now [end-to-end encrypted](https://aventasks.dev/sync/setup/). Devices encrypt tasks, history and images before upload, so the sync server cannot read your tasks or images. It still sees [some metadata](https://aventasks.dev/sync/setup/#what-encryption-protects), such as IDs, sizes and timing. * Start a sync with a one-time setup invitation from [`aven server setup`](https://aventasks.dev/sync/setup/#start-a-server), and [add devices](https://aventasks.dev/sync/setup/#add-a-device) by scanning a QR code or pasting an invitation from a device that already syncs. * [List and remove devices](https://aventasks.dev/sync/setup/#manage-devices) with `aven sync device` or **Manage devices** in the TUI Sync dialog. Removing a device rotates the keys for future changes. * [`aven sync reset`](https://aventasks.dev/sync/setup/#rebuilding-sync) returns a database to local-only use, keeping its tasks and images. * Move tasks to a project in another workspace with [`aven move`](https://aventasks.dev/command-reference/#aven-move). Notes, labels, metadata, attachments, epic subtrees and internal relationships move with them, and refs keep their suffix. * On Linux, [`aven daemon install`](https://aventasks.dev/sync/setup/#automate-sync-with-the-daemon) and the other daemon subcommands manage a systemd user service. * `aven server` and `aven server setup` store data in a standard location by default, so `--data` is optional. Fixes * The daemon restarts on the new version after `brew upgrade` instead of running the old one until Homebrew cleans it up. * Databases, backups, restore staging and log files are created readable only by you. * The TUI shows availability times in recent actions and conflicts in local time. September 26, 2026 ## v0.1.44 [Section titled “v0.1.44”](#v0-1-44) Fixes * Opening a [search](https://aventasks.dev/tui/#search-filter-and-order) result with `Enter` keeps the typed query as the committed search view, so closing the task detail returns to the full result list instead of a single-task view scoped to that task’s reference. ([#21](https://github.com/raine/aven/pull/21)) September 26, 2026 ## v0.1.43 [Section titled “v0.1.43”](#v0-1-43) Fixes * Moving tasks or recurring schedules to a project now requires that project to exist in the selected workspace, preventing accidental duplicate projects. ([#29](https://github.com/raine/aven/issues/29)) September 24, 2026 ## v0.1.42 [Section titled “v0.1.42”](#v0-1-42) New * Navigate TUI task lists by page with Page Up/Page Down and by half-page with Ctrl-U/Ctrl-D. Fixes * Ctrl-U clears the current line in task inputs instead of opening the schedule editor. September 22, 2026 ## v0.1.41 [Section titled “v0.1.41”](#v0-1-41) New * Navigate from a task to its blocker with `g B`, choosing from a picker when it has multiple blockers. ([#27](https://github.com/raine/aven/issues/27)) * Add an optional dedicated [due-date column](https://aventasks.dev/configuration/#tui-table-columns) to TUI task lists. ([#25](https://github.com/raine/aven/issues/25)) * Newer apps can keep syncing with older supported servers, while preserving offline edits when an update is required. * Aven warns before installing an update that could interrupt sync and recommends updating the sync server first when needed. Fixes * More reliable sync for recurring tasks, JSON imports, attachments, and server errors, preventing false conflicts, lost history, and unnecessary retries. * The TUI Ref column label aligns with the task refs beneath it. September 19, 2026 ## v0.1.40 [Section titled “v0.1.40”](#v0-1-40) New * New landing page: * TUI text fields support word-wise cursor movement with Ctrl/Alt arrows and deletion with Alt-Backspace. * The TUI shows note timestamps without a redundant author label. * Setting medium, high, or urgent priority moves inbox tasks to todo, including when creating tasks. * Choose which [TUI task-list columns](https://aventasks.dev/configuration/#tui-table-columns) appear and their order with `tui.table.columns`. * Render the [TUI status column](https://aventasks.dev/configuration/#compact-status-column) as icons only with `tui.table.compact_status`. Off by default. Fixes * Undoing a newly created task preserves notes and relationships added afterward. * Multiline text pasted into TUI editors keeps its line breaks in terminals using CSI-u keyboard encoding. * Pressing `!` for marked tasks uses the same `n`, `l`, `m`, `h`, and `u` priority shortcuts as a single task. September 10, 2026 ## v0.1.39 [Section titled “v0.1.39”](#v0-1-39) * Press `!` to choose a task’s priority directly from TUI task lists or task details. September 9, 2026 ## v0.1.38 [Section titled “v0.1.38”](#v0-1-38) New * Linked task references in the TUI use their own project’s color, making cross-project relationships easier to recognize. Fixes * Undoing a note deletion no longer prevents undoing that note’s creation when the changes have not yet synced. September 7, 2026 ## v0.1.37 [Section titled “v0.1.37”](#v0-1-37) New * View and edit [custom task metadata in the TUI](https://aventasks.dev/tui/#custom-metadata), with inline editing for short values and external-editor support for multiline values. ([#9](https://github.com/raine/aven/issues/9)) * Customize which [TUI sidebar views](https://aventasks.dev/configuration/#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. Fixes * More reliable sync after offline edits and with large batches of changes. **Sync requires updating both the server and clients to this release.** * Various fixes for task recovery, recurring tasks, project settings, and mouse navigation. September 5, 2026 ## v0.1.36 [Section titled “v0.1.36”](#v0-1-36) Improved * Epic details show each child’s blockers on one compact line. Open the child task to see all its dependencies. Performance * 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. Fixes * 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. * Upcoming keeps tasks in the correct date groups when the TUI stays open past midnight. * Task details handle tasks deleted during refresh without displaying incomplete or outdated information. * Undoing a task field change restores its previous idle age unless newer activity has updated it. * `aven doctor --integrity` checks attachment files after its database checks, capturing file changes made while those checks run. August 28, 2026 ## v0.1.35 [Section titled “v0.1.35”](#v0-1-35) New * 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`](https://aventasks.dev/agents/#install-the-aven-skill). * CLI help explains every command and argument with concise guidance and examples. * Use [`aven sync status`](https://aventasks.dev/command-reference/#aven-sync-status) and [`aven daemon status`](https://aventasks.dev/command-reference/#aven-daemon) 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](https://github.com/raine/aven/pull/19)) Fixes * [`aven doctor`](https://aventasks.dev/command-reference/#aven-doctor) remains available when startup configuration or database checks fail. August 26, 2026 ## v0.1.34 [Section titled “v0.1.34”](#v0-1-34) * Drag task cards between status lanes in the [Columns layout](https://aventasks.dev/tui/#columns). August 25, 2026 ## v0.1.33 [Section titled “v0.1.33”](#v0-1-33) Fixes * 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](https://github.com/raine/aven/issues/15)) * Pressing `Enter` on a highlighted [sidebar](https://aventasks.dev/tui/) row selects that view, project, or workspace again instead of opening the detail of the task selected in the list. ([#16](https://github.com/raine/aven/pull/16)) * [TUI sorting, filtering, and compatible view changes](https://aventasks.dev/tui/#search-filter-and-order) keep the same task selected when it remains visible, with predictable nearby selection when it does not. August 24, 2026 ## v0.1.32 [Section titled “v0.1.32”](#v0-1-32) New * Running `aven` with no command opens the [TUI](https://aventasks.dev/tui/) directly. Global options such as `--db` and `--workspace` still apply. * Use [Columns](https://aventasks.dev/tui/#columns) as a layout for the active task view. Press `v l` to switch between Columns and List without changing which tasks are shown. Improved * The [TUI command palette](https://aventasks.dev/tui/#discover-commands) prioritizes actions for the focused task, marked tasks, detail row, or sidebar item and keeps that target through pickers and confirmations. * [Task list](https://aventasks.dev/tui/#find-work) selection uses a stable `›` cursor so the focused task remains clear across terminal themes, inactive panes, and monochrome output. August 23, 2026 ## v0.1.31 [Section titled “v0.1.31”](#v0-1-31) New * With [Related tasks](https://aventasks.dev/organize-tasks/#connect-context-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. Improved * Workspace controls keep workspaces in a stable order, and clicking the header switches directly when only two workspaces are available. * 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. August 19, 2026 ## v0.1.30 [Section titled “v0.1.30”](#v0-1-30) New * [Recurring tasks](https://aventasks.dev/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](https://aventasks.dev/tui/#capture-tasks) automatically sets prioritized and repeating tasks to todo. Choose a status manually to override it, or pick `Auto` to restore the automatic choice. * [Search](https://aventasks.dev/tui/#search-filter-and-order) finds a recurring series by the `RCR-` ref shown on its task rows. ([#14](https://github.com/raine/aven/pull/14)) Fixes * 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](https://github.com/raine/aven/pull/13)) * A [custom TUI command](https://aventasks.dev/custom-commands/) that exits early reports its own exit status instead of an input delivery error, and timed-out commands clean up leftover child processes. August 12, 2026 ## v0.1.29 [Section titled “v0.1.29”](#v0-1-29) New * Configure experimental [custom TUI commands](https://aventasks.dev/custom-commands/) to run local programs from the command palette or keybindings and pass selected or marked task context. Fixes * CJK, emoji, and other wide-character text fits correctly in TUI fields and layouts, and input method composition appears at the active caret. ([#10](https://github.com/raine/aven/pull/10)) August 10, 2026 ## v0.1.28 [Section titled “v0.1.28”](#v0-1-28) New * Sync is more reliable on slow or unstable connections, coordinates daemon and manual operations, and downloads only attachments referenced by live tasks. Fixes * The changelog reader (`:changelog`) fetches the latest release notes independently of cached update checks and wraps entries cleanly to the dialog width. August 9, 2026 ## v0.1.27 [Section titled “v0.1.27”](#v0-1-27) * 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](https://github.com/raine/aven/blob/main/src/skill.md) heavily trimmed down from cruft August 9, 2026 ## v0.1.26 [Section titled “v0.1.26”](#v0-1-26) * Add [task metadata](https://aventasks.dev/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](https://aventasks.dev/organize-tasks/#group-an-outcome-with-an-epic) 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](https://aventasks.dev/organize-tasks/#put-work-in-order-with-dependencies) 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. August 7, 2026 ## v0.1.25 [Section titled “v0.1.25”](#v0-1-25) Fixes * [Sorting](https://aventasks.dev/tui/#search-filter-and-order) by updated time shows the most recently updated tasks first by default. * [Task details](https://aventasks.dev/tui/#task-detail) stay in sync after changes, including status and notes, while preserving the scroll position. August 5, 2026 ## v0.1.24 [Section titled “v0.1.24”](#v0-1-24) * Press `Ctrl-g` in the [task composer](https://aventasks.dev/tui/#capture-tasks) to create a task and immediately start another with the same project, status, priority, and labels. * [Marked tasks](https://aventasks.dev/tui/#mark-and-change-several-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](https://aventasks.dev/tui/#copy-task-information) for marked tasks as one value per line in their visible list order. * Browse [command palette](https://aventasks.dev/tui/#discover-commands) 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. August 4, 2026 ## v0.1.23 [Section titled “v0.1.23”](#v0-1-23) * [Copy a complete task report as Markdown](https://aventasks.dev/tui/#copy-task-information) with `y m`, or [publish it as a secret GitHub gist](https://aventasks.dev/tui/#publish-a-task-report-as-a-github-gist) with `t g` and copy the resulting link. * Click web links in task descriptions and notes to open them in the default browser, while link labels remain compact and readable. * Navigate forward after going back with `g ]`, with list selection, scroll position, and task detail state preserved. * [Disable automatic release checks](https://aventasks.dev/configuration/#automatic-update-checks) and update badges with `update.automatic_checks: false` or `AVEN_NO_UPDATE_CHECK=1`; manual update commands remain available. * Type immediately in [project and workspace pickers](https://aventasks.dev/tui/#scope) to filter options, then use the arrow keys and `Enter` to select one. August 3, 2026 ## v0.1.22 [Section titled “v0.1.22”](#v0-1-22) * 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. August 1, 2026 ## v0.1.21 [Section titled “v0.1.21”](#v0-1-21) New * Create and edit epics in the TUI, or promote an ordinary task when adding its first child. * Click any editable metadata value in task details to change the project, status, priority, labels, availability, or due date. * Multiline editors confirm before discarding changed content, and individual notes can be edited, deleted, and restored with undo. * Create, browse, rename, and delete labels, create and rename workspaces, manage project paths, and create projects from task workflows in the TUI. * Save attachments from task detail with explicit handling for missing data, invalid destinations, and existing files. * Open Upcoming from the shared command catalog, open tasks from Recent Actions, and receive series-specific guidance for task commands in the Recurring view. * TUI mutations wake the sync daemon, `:sync` starts a manual sync, and sync-disabled environments preserve local-only operation with clear errors. Fixes * Task detail commands consistently target the displayed or focused related task, with direct actions for linked tasks and reliable back and sibling navigation. * TUI task and label workflows apply their changes atomically and restore labels created by the same operation during undo. * Trackpad scrolling stays responsive at list and help boundaries, while modal dialogs and help overlays present clearer visual structure. * Consecutively deleted tasks remain visible in the TUI until an explicit refresh. July 31, 2026 ## v0.1.20 [Section titled “v0.1.20”](#v0-1-20) New * [Create and manage recurring tasks](https://aventasks.dev/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](https://aventasks.dev/command-reference/#aven-search) with `aven search --project`. JSON results include the same task fields as list output. * [Bulk updates](https://aventasks.dev/command-reference/#aven-bulk-update) 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`](https://aventasks.dev/command-reference/#aven-add) and [`aven list --open`](https://aventasks.dev/command-reference/#aven-list). * [Epics](https://aventasks.dev/concepts/#dependencies-and-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](https://aventasks.dev/tui/#create-with-ai) sends a system notification when it finishes after the originating TUI exits. * Out-of-range `--limit` values return clear errors for list, search, and [recurrence history](https://aventasks.dev/command-reference/#recur-history). Performance * Large task lists, recurring-task refreshes, live searches, and TUI rendering stay more responsive. Fixes * [Attachment sync](https://aventasks.dev/sync/setup/#image-attachments-during-sync) accepts UTC timestamps with fractional seconds. July 28, 2026 ## v0.1.19 [Section titled “v0.1.19”](#v0-1-19) * 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. July 27, 2026 ## v0.1.18 [Section titled “v0.1.18”](#v0-1-18) * 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. July 25, 2026 ## v0.1.17 [Section titled “v0.1.17”](#v0-1-17) * 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. July 23, 2026 ## v0.1.16 [Section titled “v0.1.16”](#v0-1-16) * Task detail help includes navigation shortcuts for moving through tasks, returning to previous views, and revisiting the most recently changed task. July 23, 2026 ## v0.1.15 [Section titled “v0.1.15”](#v0-1-15) * 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. July 23, 2026 ## v0.1.14 [Section titled “v0.1.14”](#v0-1-14) * 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. July 21, 2026 ## v0.1.13 [Section titled “v0.1.13”](#v0-1-13) * [Attach images to tasks](https://aventasks.dev/concepts/#image-attachments) 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. July 17, 2026 ## v0.1.12 [Section titled “v0.1.12”](#v0-1-12) * 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`. July 16, 2026 ## v0.1.11 [Section titled “v0.1.11”](#v0-1-11) * Due dates use compact labels in the task list so deadlines fit cleanly in the time column. July 16, 2026 ## v0.1.10 [Section titled “v0.1.10”](#v0-1-10) * 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. July 15, 2026 ## v0.1.9 [Section titled “v0.1.9”](#v0-1-9) * 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 `, a breaking command rename for scripts and agents. July 15, 2026 ## v0.1.8 [Section titled “v0.1.8”](#v0-1-8) * [Task detail views](https://aventasks.dev/tui/#copy-task-information) support dragging across rendered titles and descriptions and copying the selected text with `y`. * [`Ctrl-Enter`](https://aventasks.dev/tips/#use-ctrl-enter-in-alacritty-and-tmux) submits task composers and multiline editors, with `Ctrl-s` as a portable fallback. * [Batch actions](https://aventasks.dev/tui/#triage-and-edit-tasks) clearly indicate when they target marked tasks, and status changes use the status picker. * [Multiline editor controls](https://aventasks.dev/tui/#capture-tasks) remain visible as content grows, and note prompts appear only on empty drafts. July 15, 2026 ## v0.1.7 [Section titled “v0.1.7”](#v0-1-7) * Move selected or marked tasks directly between [Columns lanes](https://aventasks.dev/tui/#columns) with keyboard or mouse controls, with batch moves grouped into one undo step. * Improved the default [Columns workflow](https://aventasks.dev/tui/#columns) 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](https://aventasks.dev/configuration/) support `~` for the home directory. July 14, 2026 ## v0.1.6 [Section titled “v0.1.6”](#v0-1-6) * Added a configurable [Columns view](https://aventasks.dev/tui/#columns) for navigating tasks in named status lanes. * Redesigned the [task composer](https://aventasks.dev/tui/#capture-tasks) 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](https://aventasks.dev/tui/#task-detail) with a shortcut that jumps directly to notes. * Added a guided [Taskwarrior migration workflow](https://aventasks.dev/taskwarrior/#migrate-from-taskwarrior) to the documentation. * Improved [daemon and server startup](https://aventasks.dev/sync/setup/) in Linux services, containers, and other environments without writable state directories. July 12, 2026 ## v0.1.5 [Section titled “v0.1.5”](#v0-1-5) * Selecting an [epic](https://aventasks.dev/concepts/#dependencies-and-epics) in the task list highlights its child tasks for easier scanning. July 9, 2026 ## v0.1.4 [Section titled “v0.1.4”](#v0-1-4) * [Task composer](https://aventasks.dev/tui/#capture-tasks) 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](https://aventasks.dev/sync/setup/#diagnose-sync-state) show sync history size, synced and pending change counts, server sequence range, and payload bytes. * [Task list](https://aventasks.dev/tui/#find-work) selection stays visible when queue group headers remain pinned. * Back navigation from an [epic child detail](https://aventasks.dev/tui/#projects-and-relationships) returns to the parent detail view and scroll position. July 7, 2026 ## v0.1.3 [Section titled “v0.1.3”](#v0-1-3) * [Epic detail views](https://aventasks.dev/tui/#projects-and-relationships) list child tasks inline, with mouse hover and click targets for jumping to visible child tasks. * The [queue](https://aventasks.dev/concepts/#queue) keeps blocked tasks below actionable groups and gives more weight to tasks that unblock other work. * The [TUI sidebar](https://aventasks.dev/tui/#find-work) 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. July 5, 2026 ## v0.1.2 [Section titled “v0.1.2”](#v0-1-2) * Added [`aven skill install`](https://aventasks.dev/agents/#install-the-aven-skill) so Claude Code, OpenCode, and Codex can install the bundled task-management skill into their agent skill directories. * Added a [Recent Actions view](https://aventasks.dev/tui/#find-work) in the TUI for reviewing task, project, label, and dependency activity. * Improved the [TUI queue](https://aventasks.dev/concepts/#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](https://aventasks.dev/tui/#triage-and-edit-tasks) 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](https://aventasks.dev/tui/#discover-commands) with back navigation, footer status hotkeys, mouse-scrolled help overlays, and clearer terminal startup errors. * Improved [task detail and preview panels](https://aventasks.dev/tui/#task-detail) with epic metadata and parent markers. July 3, 2026 ## v0.1.1 [Section titled “v0.1.1”](#v0-1-1) * Made natural task creation from the [full TUI](https://aventasks.dev/tui/#capture-tasks) continue reliably after exiting the interface, while keeping created tasks undoable when the TUI remains open. * Improved [daemon update handling](https://aventasks.dev/sync/setup/#automate-sync-with-the-daemon) so launchd services use a stable executable path, restart cleanly, and show richer status in `aven doctor`. July 2, 2026 ## v0.1.0 [Section titled “v0.1.0”](#v0-1-0) * Initial release of `aven`, a local-first task manager. See [Getting started](https://aventasks.dev/getting-started/) to install it and create your first task. # Android changelog > Release notes for Aven for Android. [CLI & TUI](/changelog/)[iPhone](/changelog/ios/)[Android](/changelog/android/) October 31, 2026Latest ## 0.3.0 [Section titled “0.3.0”](#v0-3-0) New * **Tell Aven** turns a typed or spoken request into task drafts you review before anything changes. It can search and answer questions about your tasks, use a photo as context, and open from task detail with that task attached. Chats stay on your phone. * Voice input in Tell Aven offers on-device and alternative transcription providers, with a choice in Settings. * Add notes to a task from task detail. * Create new labels from the label picker’s search and while editing a task. * Task priority is drawn as signal bars. * Task lists follow to another workspace when the one you’re viewing is deleted on another device. * Sync retries brief failures before showing them. Fixes * Dialogs keep their side margins. * The sync headline stays centered as its status changes. * The undo toast stays at full size while it is shown. October 16, 2026 ## 0.2.0 [Section titled “0.2.0”](#v0-2-0) New * Capture suggests one-tap label chips while typing, prioritizing labels named in the title and frequently used in the project. Reuse the labels from the project’s latest labelled task, or open the full picker with **…**. * The label picker keeps selected labels visible as removable chips and offers frequently used labels. Capture and edit show selected labels as chips instead of a count. * The capture title stays beside Close while the details scroll, replacing the separate **New task** heading. * **All tasks** shows open tasks by default. **Open tasks** and **All statuses** shortcuts preserve other filters; priority and label choices have their own menu pages, and the filter button stays in place while selecting. * Search focuses automatically the first time its tab opens, without reopening the keyboard when returning from a task. * Settings has a **Suggest an improvement** link for bugs, ideas, and clunky workflows. * Sort, filter and search **All tasks** in a project: sort by date added, last updated, priority, due date or title; filter by status, priority and label; and pull down to search. The Tasks tab gets the same **All tasks** view for the whole workspace, next to Queue and Epics. * Swipe tasks in **All tasks** like in the Queue: right to mark done, left to snooze until tomorrow, with Undo. * With an empty query, the Search tab shows the five most recently added tasks, with **Show all** to see the rest. * Long-press a task to set its due date or snooze it with quick picks such as Tomorrow, Next week or Weekend, with Undo. The editor’s Availability field is now called **Available from**. * Create projects on Android: type a new name in the capture project picker or the Projects tab filter and choose **Create ”…”**. * Capturing a task in a workspace with no projects creates an **Inbox** project when you save, instead of asking you to sync a project first. * Choose the default project for new tasks in Settings: the last one used (the default), none, or a specific project. Each device remembers it per workspace. * Project colors match the terminal app, using 14 colors tuned for light and dark mode. * Join sync hosted by Aven Cloud or your own Aven server. Pairing and Settings show which one the phone uses. * When sync has been deleted on the server, the app says so, stops syncing automatically, and offers **Disconnect to pair again**. **Sync now** still checks. * Joining with an invitation for a deleted sync explains that sync must be set up again on the computer, instead of reporting an expired invitation. * Leaving a pairing that can still be retried asks before discarding it. * Clearer sync errors: connection problems give advice that fits Aven Cloud or a self-hosted server, an app too old for its server says to update, hosting refusals (paused, storage limit, unavailable) explain what to do, and a reverse proxy that rejects large requests suggests raising its body limit to at least 8 MB. * The capture dialog has more room while typing: the note under the Capture button is gone. Performance * **All tasks** opens smoothly with around a thousand tasks, and returning from a task no longer reloads the list. Fixes * Capture ignores whitespace-only changes when asking to discard a draft, and changing only its project now asks for confirmation. * Done and canceled tasks are no longer shown as overdue. With the due date sort, they appear under **Earlier** with their due date. * An invitation with an unusable server address asks for a new invitation instead of suggesting a network check. October 8, 2026 ## 0.1.0 [Section titled “0.1.0”](#v0-1-0) * Initial release of Aven for Android, a companion to the [aven](https://aventasks.dev/) task manager. Capture tasks, work through the queue and epics, browse projects, search, and edit tasks with Markdown descriptions, notes, relationships and attachments. * End-to-end encrypted sync with Aven on your computer: pair by scanning a QR code or pasting an invitation. Tasks stay available offline. * Delete and restore tasks, with Undo. * Open-source license notices are available offline, and Contact support opens Aven’s support page. * The app collects no data. # iPhone changelog > Release notes for Aven for iPhone. [CLI & TUI](/changelog/)[iPhone](/changelog/ios/)[Android](/changelog/android/) November 8, 2026Latest ## 1.0.7 [Section titled “1.0.7”](#v1-0-7) * Updated encryption compliance for distribution in France. November 3, 2026 ## 1.0.6 [Section titled “1.0.6”](#v1-0-6) New * Swiping down in Tell Aven now hides the keyboard smoothly. Swipe again to close the chat. Fixes * Resending a request after a Tell Aven cloud failure no longer sends it twice. * Tell Aven messages fade out under the project pill instead of being cut off. November 2, 2026 ## 1.0.5 [Section titled “1.0.5”](#v1-0-5) New * Tell Aven has a Hide keyboard button next to the microphone. * Update cards in Tell Aven show only the fields that change. * Settings can prepare AI diagnostics for you to share. They stay on your iPhone until you share them and contain no prompts, answers, or task content. * The photo quality prompt explains what each option does. Fixes * Linked tasks open from a task reached through Tell Aven, and the whole row responds to taps. * Saved chats open for reading without bringing up the keyboard. * The search header no longer overlaps the list when the keyboard opens. * The undo toast stays at full size while it is shown. November 2, 2026 ## 1.0.4 [Section titled “1.0.4”](#v1-0-4) New * **Tell Aven** turns a typed or spoken request into task drafts you review before anything changes. It can search and answer questions about your tasks, take a photo or screenshot as context, and open from task detail with that task attached. Chats stay on your iPhone. * Voice input in Tell Aven offers on-device and alternative transcription providers, with a choice in Settings. * Add notes to a task from task detail. * Create new labels from the Add Task label picker and while editing a task. * Task priority is drawn as signal bars. * Aven runs on iOS 18 again. * Sync retries brief failures before showing them. Fixes * Switching tabs no longer flashes the screen. * The add image tile lays out correctly in the task form. October 28, 2026 ## 1.0.3 [Section titled “1.0.3”](#v1-0-3) Fixes * HTTP sync connections to self-hosted servers over a trusted VPN, including Netbird, are no longer blocked for VPN addresses such as `100.100.20.30`. October 17, 2026 ## 1.0.2 [Section titled “1.0.2”](#v1-0-2) New * Capture suggests labels as one-tap chips beside the Capture button. Labels matching words in the title come first, a chip reapplies the labels of the project’s latest labelled task, and **…** opens the full label picker. * The capture sheet has more room while typing: the title field replaces the “New task” heading, and the note under the Capture button is gone. Next to the label chips, the Capture button is a larger capsule that is easier to spot and tap. * The label picker keeps selected labels visible as removable chips below the search field, and a **Frequent** section offers the project’s most used labels. The edit form shows a task’s labels as chips instead of a count. * A **Feedback** section in Settings links to Aven’s GitHub issues for suggestions and problem reports. * **All tasks** shows open tasks by default. The status filter adds **Open tasks** and **All statuses** shortcuts, and priority and label filters move into submenus. Fixes * Closing a capture you haven’t changed no longer asks to discard it. * The **All tasks** search field stays in place and visible while the keyboard is open, and scrolling back to the top shows search and filters again. October 15, 2026 ## 1.0.1 [Section titled “1.0.1”](#v1-0-1) New * Sort, filter and search **All tasks** in a project: sort by date added, last updated, priority, due date or title; filter by status, priority and label; and pull down to search. The Tasks tab gets the same **All tasks** view for the whole workspace, next to Queue and Epics. * Swipe tasks in **All tasks** like in the Queue: right to mark done, left to snooze until tomorrow, with Undo. * With an empty query, the Search tab shows the five most recently added tasks, with **Show all** to see the rest. * Long-press a task to set its due date or snooze it with quick picks such as Tomorrow, Next week or Weekend, with Undo. The editor’s Availability field is now called **Available from**. * Create projects on iPhone: type a new name in the capture project picker or the Projects tab filter and choose **Create ”…”**. * Capturing a task in a workspace with no projects creates an **Inbox** project when you save, instead of asking you to sync a project first. * Choose the default project for new tasks in Settings: the last one used (the default), none, or a specific project. Each device remembers it per workspace. * Project colors match the terminal app, using 14 colors tuned for light and dark mode. The Projects list shows filled folder icons in each project’s color. * Join sync hosted by Aven Cloud or your own Aven server. Pairing and Settings show which one the phone uses. * When sync has been deleted on the server, the app says so, stops syncing automatically, and shows how to disconnect and pair again. **Sync now** still checks. * Joining with an invitation for a deleted sync explains that sync must be set up again on the computer, instead of reporting an expired invitation. * Leaving a pairing that can still be retried asks before discarding it. * Clearer sync errors: connection problems give advice that fits Aven Cloud or a self-hosted server, an app too old for its server says to update, hosting refusals (paused, storage limit, unavailable) explain what to do, and a reverse proxy that rejects large requests suggests raising its body limit to at least 8 MB. Performance * **All tasks** opens smoothly with around a thousand tasks, and returning from a task no longer reloads the list. Fixes * Done and canceled tasks are no longer shown as overdue. With the due date sort, they appear under **Earlier** with their due date. * An invitation with an unusable server address asks for a new invitation instead of suggesting a network check. * Swiping right on a task in a project marks it done instead of going back. October 14, 2026 ## 1.0 [Section titled “1.0”](#v1-0) * Initial release of Aven for iPhone, a companion to the [aven](https://aventasks.dev/) task manager. Capture tasks, work through the queue and epics, browse projects, search, and edit tasks with Markdown descriptions, notes, relationships and attachments. * End-to-end encrypted sync with Aven on your computer: pair by scanning a QR code or pasting an invitation. Tasks stay available offline. * Delete and restore tasks, with Undo. * Open-source license notices are available offline, and Contact support opens Aven’s support page. * The app collects no data. Crash reports are only sent if you choose to email them. # Command reference > Complete syntax, arguments, options, behavior, and examples for the aven CLI. This page documents every user-facing `aven` command. The command line accepts global options before or after a subcommand. ## Global syntax [Section titled “Global syntax”](#global-syntax) ```sh aven [--db ] [--workspace ] aven help [...] aven --version ``` | Option | Description | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `--db ` | Use a specific SQLite database. This takes precedence over `AVEN_DB`, `local.db_path`, and the default state directory. | | `--workspace ` | Use a specific workspace instead of directory routing or the configured default. | | `-h`, `--help` | Print help for the selected command. | | `-V`, `--version` | Print the installed aven version. | `aven help ` and `aven --help` show the same command-specific help. Nested help accepts the full command path, such as `aven help project path add`. ## Common values and behavior [Section titled “Common values and behavior”](#common-values-and-behavior) ### Task references [Section titled “Task references”](#task-references) Commands accept the qualified references printed by aven, such as `APP-7KQ9`, or an unambiguous bare suffix such as `7KQ9`. Typed suffixes must contain at least three characters. Aven lengthens displayed suffixes when needed to keep them unambiguous. `O` is treated as `0`, and `I` or `L` is treated as `1` when resolving a reference. ### Statuses and priorities [Section titled “Statuses and priorities”](#statuses-and-priorities) Valid statuses are `inbox`, `backlog`, `todo`, `active`, `done`, and `canceled`. Valid priorities are `none`, `low`, `medium`, `high`, and `urgent`. ### Task metadata [Section titled “Task metadata”](#task-metadata) Custom task metadata uses repeatable `KEY=VALUE` assignments. Keys are normalized workspace field names, and values are opaque UTF-8 strings. An empty value is present metadata, while `--remove-metadata KEY` removes the value. See [Task metadata](/task-metadata/) for field rules, filtering, recurrence behavior, and sync semantics. ### Text input [Section titled “Text input”](#text-input) Commands that accept long text provide mutually exclusive inline, file, and standard-input forms. Pass only one source for a field. For example: ```sh aven add "Document recovery" --description "Short description" aven add "Document recovery" --description-file ./description.md aven add "Document recovery" --description-stdin <<'EOF' Explain the recovery workflow. Include a verification step. EOF ``` ### Structured output [Section titled “Structured output”](#structured-output) The `--json` option is available on `context`, `show`, `list`, `search`, `recur list`, `recur show`, `recur history`, `attachment add`, `attachment list`, `attachment get`, `attachment delete`, `attachment prune`, `dep list`, `related list`, `epic list`, `prime`, `label list`, `metadata list`, `metadata show`, `project list`, `conflict list`, `conflict show`, and `doctor`. JSON task objects from `list`, `show`, and `search` include scheduling in `available_at` and `due_on`, epic membership in `is_epic`, `epic_parent`, and `epic_children`, dependency counts in `blocked_by` and `blocks`, conflict state in `has_conflict`, and `created_at` and `updated_at` timestamps. Search results add `score`, `matched_field`, and `snippet` to this task shape. `context --json` and `show --full --json` expose custom task metadata as a key-value object and as detailed records with stable field IDs. They also expose related tasks and attachment metadata without bytes, including deleted attachment tombstones. Consumers must inspect each attachment’s `deleted` field. An empty `available_at` means immediate availability. An empty `due_on` means no deadline. ## Temporal input [Section titled “Temporal input”](#temporal-input) ### Availability input [Section titled “Availability input”](#availability-input) Availability controls when a task becomes eligible for attention and enters normal task lists and queue groups. It is not a deadline or due date. An empty `available_at` value means the task is immediately available. `aven add --available-at`, `aven edit --available-at`, natural task intake, and the TUI task composer use the same expressions: | Expression | Local-calendar meaning | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `today` | Today at local midnight. | | `tomorrow` | Tomorrow at local midnight. | | `Nd`, `Nw` | Local midnight after `N` calendar days or weeks, such as `2d` or `3w`. | | `in N days` | Local midnight after `N` calendar days. Singular `day` is accepted. | | `in N weeks` | Local midnight after `N * 7` calendar days. Singular `week` is accepted. | | `in N months` | The same local day after `N` calendar months. End-of-month dates clamp to the last valid day. Singular `month` is accepted. | | `next week` | The next Monday strictly after today at local midnight. | | `next monday` | The named weekday strictly after today at local midnight. Full names and common abbreviations such as `mon`, `tues`, and `thurs` are accepted. If today is that weekday, this means seven days later. | | ` at