Skip to content

Repository files navigation

tess

Run 10 AI coding agents without losing track of any of them.

Every task gets its own git worktree, its own agent, its own context. One command shows you all of them.

tess claude redis-fix "cut p99 on the cache path"    # spawn a session
tess status                                          # see all of them — BLOCKED first
tess ship redis-fix                                  # tests → push → PR → tear down

Six etched tiles — messages, mail, calendar, music, calls, notes — cabled into a single brass disc engraved tess

Install

git clone https://github.com/cleanmcp/tess.git && cd tess && ./install.sh

Add ~/.local/bin to your PATH, then type tess. macOS. Skip any optional step — nothing breaks.

The 6 commands that matter

Command What it does
tess new <feature> isolated worktree, .env files copied in
tess claude <feature> "<task>" spawn an agent in its own worktree
tess status the whole fleet — blocked sessions first
tess tell <session> -- <msg> steer one mid-flight
tess ship <feature> diff → tests → push → PR
tess the menu — everything else

Terminal showing tess wt listing three feature worktrees across two repos, and tess todo listing three open items

Your agents learn tess automatically

tess wire     # run by the installer

Installs skills into Claude Code, Cursor, Codex, Gemini and opencode, and a hook that blocks raw git worktree and points the agent at tess new instead. Claude Code users can /plugin marketplace add cleanmcp/tess.

How it works

Four machined cards with brass, green and red status beads, cabled into a single brass disc engraved tess

Four sessions running. Two working, one done, one waiting on you.

Sessions & the fleet

It also reaches the rest of your Mac

Messages, Mail, Calendar, Calls, Music, Books, your notes. All local, nothing uploaded, dormant until you call it.

tess messages sarah          tess mail search "invoice"
tess calendar 3              tess music top 20

All 12 connectors

Docs

Sessions & the fleet spawn, monitor, steer, ship, budgets, tess team, orchestration
Worktrees the grammar, multi-repo features, the repo map
The vault your knowledge base: notes, kanban, tasks, bases, wiki links, canvases
Connectors messages, mail, music, calendar, books, notes, voice
Agent integration skills, hooks, the Claude Code plugin
Config every TESS_* var, custom commands, modes

Uninstall

./uninstall.sh

Never touches your repos, worktrees, or notes.


MIT · Contributing · Changelog

About

One CLI for your whole machine: code worktrees, notes/brain, offline local AI, and Mac messages/calls/calendar — for you and your AI agents.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages