Skip to content

docs: say what Devin CLI actually carries #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dsaad68 merged 1 commit into from
Aug 24, 2026
Merged

docs: say what Devin CLI actually carries #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 21 additions & 8 deletions docs/agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,14 +154,23 @@ no agents in it looks exactly as it did before any of this existed.
The second line is what the agent is actually doing, taken from the hook payload
that set the state. Not every event carries one:

| State | From | Message |
|---|---|---|
| `busy` | `UserPromptSubmit` | the prompt you gave it |
| `perm` | `PermissionRequest` | the tool and its argument — `Bash: git push` |
| `done` | `Stop` | the reply that ended the turn |
| `err` | `StopFailure` | the error type |
| `busy` | going quiet | a `busy` record untouched for 30 minutes reads as `no activity` — every hook event refreshes the timestamp, so one this old has not made a tool call in half an hour |
| `ask` | `Elicitation` | the question an MCP server is asking |
| State | Message, and where it comes from | Claude Code | Devin CLI |
|---|---|---|---|
| `busy` | the prompt you gave it — `UserPromptSubmit.prompt` | yes | yes |
| `perm` | the tool and its argument — `PermissionRequest`, e.g. `Bash: git push` | yes | yes |
| `done` | the reply that ended the turn — `Stop.last_assistant_message` | yes | **no** |
| `err` | the error type — `StopFailure.error_type` | yes | — |
| `ask` | the question — `Elicitation` | yes | — |

Devin CLI carries a message for the two states that matter most — what it is
working on, and what it wants to run — but not for `done`: its `Stop` payload
reports `stop_hook_active` and no reply text, so a finished Devin turn shows the
state and the age with no line under them. `err` and `ask` never arise at all,
since Devin has neither `StopFailure` nor `Elicitation`.

Separately from any of this, a `busy` record untouched for 30 minutes reads as
`no activity`. Every hook event refreshes the timestamp, so one that old has not
made a tool call in half an hour.

Only the **first line that says something** is kept. An assistant reply is a
whole markdown document — headings, code blocks, sometimes a rendered box of its
Expand Down Expand Up @@ -215,6 +224,10 @@ nothing.
set -g @kaku-tab-agent-notify 'on'
```

Fires for both CLIs — it keys on the state, not on which agent reached it, so a
Devin session blocked on a permission request notifies exactly like a Claude
Code one.

Fires on the **transition** into a state that wants you, and never on the
repeats — a turn of tool calls does not re-notify you about the permission you
already granted. Off by default: a tmux plugin has no business raising system
Expand Down
Loading