Skip to content

raine/aven

Repository files navigation

aven

aven is a local-first task manager for power users and agents. It gives you one overview across projects, task capture from wherever work appears, first-class agent workflows, workspace isolation, and a polished terminal UI.

It is currently under active development, but already works really well and I use it as my daily driver.

If you've tried aven, feedback is welcome! Please open an issue to share it.

If you find aven useful, consider sharing it with others who might benefit from it.

Docs: https://aven.raine.dev

aven TUI showing the queue view across workspace projects

Why aven?

  • Offline-first, repo-independent storage. Tasks live in a local SQLite database, not in tracked files inside each repo. Task capture and agent updates stay independent from git state, branches, worktrees, and checkouts.

  • Optional self-hosted sync. Keep the local-first workflow and make the same tasks available across laptops, agents, and other devices through a server you control.

  • Projects map to repos. Each repository becomes a project by default, created on demand when you add its first task.

  • Agent-first CLI, human-first TUI. Agents get token-efficient output, stable refs, and commands for capturing follow-up work, updating tasks, and preserving context from AI coding agents. Humans get a polished, keyboard-first TUI with project views, filters, sorting, task detail, undo, mouse support, and command palette.

  • Stable task refs. Stable, unique Jira-style refs like APP-7KQ9 work offline and show the task's project at a glance.

  • Workspaces are first class. Personal and work tasks can share the same tool without sharing the same visible task universe.

  • Markdown-native tasks. Tasks carry Markdown descriptions and append-style notes, so context stays with the task.

  • Fast capture from anywhere. Natural-language task intake, tmux popup capture, and agent-friendly commands make it easy to add tasks.

Inspired by Taskwarrior. See aven and Taskwarrior.

Quick start

Install with the release script:

curl -fsSL https://raw.githubusercontent.com/raine/aven/main/scripts/install | bash

Or install with Homebrew:

brew install raine/aven/aven

Open the TUI:

aven tui

See Getting started for first-run usage.

Documentation

About

A local-first task manager for power users and agents

Resources

License

Stars

12 stars

Watchers

1 watching

Forks

Contributors

Languages