The note command injects shared context into every active worktree's CLAUDE.md file. When one agent makes a cross-cutting change (like renaming a database column), owt note ensures all other agents know about it.
Usage
bash
owt note "message" [OPTIONS]Arguments
| Argument | Description |
|---|---|
"message" | The context to share across all agents |
Options
| Option | Description |
|---|---|
--clear | Clear all shared notes from all worktrees |
Examples
Share a Schema Change
bash
owt note "The users table now has a verified_at column"Share an API Change
bash
owt note "API endpoints moved from /api/v1 to /api/v2"Share a Convention
bash
owt note "Use zod for all input validation, not joi"Clear All Notes
bash
owt note --clearRemoves the shared notes section from all worktrees' CLAUDE.md files.
How It Works
- Finds all active OWT-managed worktrees
- Appends (or updates) a
## Shared Notessection in each worktree's.claude/CLAUDE.md - AI agents reading CLAUDE.md on their next prompt will see the note
Notes accumulate -- each owt note call adds to the existing notes rather than replacing them.
When to Use
- Schema changes -- a migration added/renamed/dropped a column
- API changes -- endpoints moved, renamed, or changed signature
- Convention changes -- switching libraries, patterns, or naming conventions
- Coordination -- telling agents about work other agents have completed
See Also
owt send-- Send a direct message to a specific agentowt send --all-- Broadcast a message to all agents- The Control Plane -- Visual management with broadcast key