Skip to content

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.

Download for macOS Release notes

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.

Demo: two herdr panes post decisions to a shared board. Notes are grouped by workspace and pane; one decision receives a private memo and is marked decided. Private memos are visible in the panel only, never to agents.

What changes in 0.3.0

Install

Requires macOS 14 Sonoma or later. The download runs on Apple Silicon and Intel; no Xcode or source build is needed.

  1. Download Clause-0.3.0-macos.zip, unzip it and move Clause.app to /Applications.
  2. The app is ad-hoc signed and not notarized. On first launch, right-click the app and choose Open.
  3. 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.

ToolWhat it does
add_noteAdd a note, todo, warning or decision. Decisions use sent or decided; the response includes a short ref.
list_notesList 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_noteUpdate 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_noteRemove one of the current session's notes by UUID or ref.
clear_notesClear 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.