Agents · Orca

What Orca leaves on your Mac.

Orca's workspaces are git worktrees. Devbroom assesses each one on its own with git itself, and shows the ones Orca already removed and half-finished setups separately.

What it looks at

Every folder has its own rule.

Devbroom handles every place the way Orca itself behaves. What the agent cleans itself it leaves to the agent; what has its own command it leaves to that command.

AssessedEach item is checked on its own; if it comes out Ready you can clean it.

Workspaces

Git worktrees; each one is assessed on its own.

~/orca/workspaces
Assessed

Removed workspaces

Workspaces Orca already removed, inside each repository.

<repo>/.orca-worktree-trash
Assessed

Workspaces being set up

A setup that stopped halfway can leave files here; look inside.

~/orca/workspaces/.orca-preparing
Assessed
Worktrees

Recognizes Orca's worktrees by their traces.

It tells a worktree belongs to Orca from these traces; the stronger the trace, the more certain the ownership it shows.

  • CertainAn orca/ folder in git metadata
  • LikelyA git admin name in Orca's <number>-<uuid> form
  • LikelyInside the ~/orca/workspaces folder
  • Blocked if it holds unsaved work. git won't remove such a worktree without --force; Devbroom never uses --force.
  • Blocked if a session runs in it or in its parent folder.
  • Review if it has ignored files: git worktree remove deletes them without asking.
Compatibility

Checks Orca's files first.

Before trusting an agent's data, Devbroom checks that its files are in the expected format. If they aren't, that data is only read; none of it counts as ready to clean.

Tested versions1.4.0 - 1.4.221

A version outside this range still works if the format holds, and shows as “not tested yet”.

Format checkgit itself

Only git worktrees are used, read with git itself; nothing relies on a file format of Orca's own.

Your versiondevbroom compat

Shows which version is installed on this Mac and whether it has been tested.

Let Orca work. Devbroom cleans up after it.