Documentation
Give the brief. Sign it off.
Cavvy is the IDE and the control room for your coding agents. Tasks begin here, you see what every agent does and needs, and nothing reaches your main branch without you. Your editor stays where it is: every task is a plain folder.
A working day
How the parts fit together, from the morning brief to the next morning.
- Once
Set up
Install and sign in your agents in Settings → Agents, put your repositories into projects and tell each repository how it is set up and what Done Means.
- Morning
Give a task
New Task… (⌘N): project, repositories, brief, agent. The agent gets its own branch and worktree, set up before it starts.
- Late morning
Work across repositories
For a change to app, API and website, choose all three in New Task…, or let the agent take in what it needs. Each repository appears in the list at once.
- Afternoon
Watch the control room
Needs You comes first. Questions stand above the terminal, ⌥⌘↓ takes you to the next session waiting for you.
- Late afternoon
Check
Done Means runs your tests when an agent is done, a Second Opinion reads the change, and you review it in the window (⇧⌘D).
- Evening
Sign off
Finish… merges, opens a merge request, parks or deletes. It always asks; merging has no shortcut.
- Overnight
Let it run
Close the window or the lid. Sessions keep running, on a server even without your Mac. In the morning, Since you last looked tells you what happened.
Three roles, one window
IDE
Tasks begin here, and changes are checked and taken in here. The agents type; you brief, review and sign off.
- Tasks Give an agent a brief; it works on a branch of its own, in a worktree that is set up first.
- Tasks across repositories Choose several repositories, or let the agent take in what it needs, and see each one join.
- Done Means Your repository’s commands, such as make test, run by themselves when an agent is done.
- Second Opinion A second agent reads the change without touching it and lists findings by severity.
- Reviewing changes The review window, Viewed marks, Overview, line comments and Return….
- Finishing a task Merge, open a merge request, park or delete: Finish… is the one way, and it has no shortcut.
Control room
See at any time what each agent does, what it changed and what it needs from you, and step in.
Home
Sessions keep running, on your Mac and on your servers, with a keychain that works. Everything else rests on this.