Varde — AI skill for Claude Code

varde

[](https://github.com/Smebbs/varde/actions/workflows/ci.yml)

Task management and memory for AI coding agents.

varde runs Claude Code and pi sessions as tasks. A board shows which one needs you, each task can have its own git worktree, and what a task's sessions learn is kept in a short *cairn* that is handed to the next session. It is one binary and one SQLite file, with no daemon.

https://github.com/user-attachments/assets/d5fac05b-9988-48e3-a141-94d1a7908e46

Install

You need git, and Claude Code or pi. tmux is recommended.

brew install smebbs/tap/varde
# or: cargo install --locked --git https://github.com/Smebbs/varde varde

Binaries are on the [releases page](https://github.com/Smebbs/varde/releases/latest). Then add the hooks in Claude Code (for pi, see [the guide](docs/guide.md#install)):

/plugin marketplace add Smebbs/varde
/plugin install varde@varde

`varde doctor` checks the setup.

Usage

varde                         # the board (outside tmux: tmux new -s varde varde)
varde new Fix the login bug   # a task in this checkout
varde attach k3m9             # start it, resume it, or go to it
varde recall login            # what earlier tasks learned

On the board: `n` makes a task, `RET` goes to its session, `Tab` goes to the next task that needs you, `v` shows its cairn, `/` recalls, `d` marks it done. `?` lists every key.

Emacs

[org-varde](docs/emacs.md) is the Emacs client: the same board, and tasks linked from your org notes.

https://github.com/user-attachments/assets/80103eeb-6ef8-4eb9-ac8f-90af5d60b13e

Documentation

• Guide: commands, the board, cairns, configuration
• org-varde: the Emacs client
• Writing a client: the --json contract
• Design: why varde is built this way
• Changelog · Contributing

License