Clause 0.3.0 · macOS · Open source
See what your coding agents decided.
A floating board for notes, todos, warnings and decisions. Keep context beside your terminal, grouped by workspace and pane in herdr, or by project folder when you work outside it.
Version 0.3.0 · macOS 14+ · Apple Silicon and Intel · 4.97 MB · Free, MIT licensed.
One board, across your agents
Agents send short headlines through MCP. Read them on the board, ask an agent about a reference such as D-12, then mark the decision as decided. Add your own notes and private memos from the panel.
What changes in 0.3.0
-
Resume a project after a restart
Outside herdr, agents list and edit the project folder's notes across session restarts. Workspaces use the full folder path, so two folders with the same name stay separate.
-
Hand a reference to another pane
Look up a ref such as
D-12or mark it decided from any pane in the same workspace. Deleting and clearing remain limited to the session that posted the note. -
Act directly on a row
Mark a decision decided, return it to sent, or delete it using the row controls. Both the delete icon and the context menu ask for confirmation.
-
Reconnect automatically
The MCP server launches Clause when it is not running and reconnects on the next call after an app restart. Large responses and slow readers no longer stall the board.
-
Know when a note is saved
An agent receives a reference only after the note is saved to disk. If saving fails, the tool returns an error and the window displays a red banner with the reason.
-
Install the app and MCP server together
One universal download includes
Clause.appandclause-mcp. Connect Claude Code or Codex to the binary inside the app.
Install
Requires macOS 14 Sonoma or later. The download runs on Apple Silicon and Intel; no Xcode or source build is needed.
- Download Clause-0.3.0-macos.zip, unzip it and move
Clause.appto/Applications. - The app is ad-hoc signed and not notarized. On first launch, right-click the app and choose Open.
- Add the MCP configuration below to your agent's existing config, then restart agent sessions so they start the bundled
clause-mcp.
Claude Code
Merge into ~/.claude.json.
{
"mcpServers": {
"clause": {
"command": "/Applications/Clause.app/Contents/MacOS/clause-mcp"
}
}
}
Codex
Add to ~/.codex/config.toml. Forward the herdr environment variables so the board can identify the workspace and pane.
[mcp_servers.clause]
command = "/Applications/Clause.app/Contents/MacOS/clause-mcp"
env_vars = ["HERDR_WORKSPACE_ID", "HERDR_PANE_ID", "HERDR_SOCKET_PATH"]
Upgrading from 0.1.x? Quit Clause, replace the app and update any config pointing at a separate clause-mcp binary to the bundled path above. Restart agent sessions to use the current socket protocol.
Tell your agents when to post using the README's agent rule snippet. The README also covers building from source and troubleshooting first launch.
MCP tools
Five tools connect your agent to the board. Inside herdr, the default scope is the current pane. Outside herdr, listing and editing span the project folder's sessions.
| Tool | What it does |
|---|---|
add_note | Add a note, todo, warning or decision. Decisions use sent or decided; the response includes a short ref. |
list_notes | List this pane's notes, or this folder's notes outside herdr. Pass ref to look up a note from any pane in the same workspace. |
edit_note | Update a note within the default scope by UUID, or use a ref to update one from any pane in the workspace, including marking a decision decided. |
delete_note | Remove one of the current session's notes by UUID or ref. |
clear_notes | Clear the current session's notes. |
After an agent restarts outside herdr, it can still list and edit the folder's older notes. Use the panel to delete notes belonging to a previous session.
A scratchpad, not an archive
Each pane keeps its five most recent decided decisions. Older ones drop off the board, along with any private memo attached to them. Keep durable records in your own tracker.
Clause is free and open source under the MIT license. Read the source and README for the current behavior and configuration.