Skip to content

Commit c9c1e56

Browse files
nik13claude
andcommitted
docs(devin-desktop): how others support Devin Desktop, verification status (TH-8294)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent a0bf68e commit c9c1e56

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

‎src/pages/docs/integrations/coding-agents/devin-desktop.mdx‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This covers the Cascade agent only. It is not the same as:
2424

2525
| | |
2626
| --- | --- |
27-
| Tested with | Devin Desktop 3.8.20 (macOS, Apple silicon). The shipped build was checked for the hook names and input fields below; no signed-in Cascade session was run (see [Verification status](#verification-status)). |
27+
| Tested with | Devin Desktop 3.8.20 (macOS, Apple silicon). The shipped build was checked for the hook names and input fields below; no signed-in Cascade session was run, and nobody has traced one yet (see [Verification status](#verification-status)). |
2828
| Devin docs used | [Cascade Hooks](https://docs.devin.ai/desktop/cascade/hooks), read 2026-10-14 |
2929
| Requires | A Devin account signed in to Devin Desktop. Python 3.9+ on the `PATH`. No packages. macOS and Linux; Windows is not supported or tested (the hook command uses `bash` syntax). |
3030
| Source | [examples/coding-agents/devin-desktop](https://github.com/future-agi/docs/tree/main/examples/coding-agents/devin-desktop) and [hook-to-otlp](https://github.com/future-agi/docs/tree/main/examples/coding-agents/hook-to-otlp) |
@@ -113,9 +113,17 @@ By default only structure and metadata leave your machine: trajectory and execut
113113

114114
To include content, add `FI_HOOK_CAPTURE_CONTENT=1` to the env file. The prompt becomes the turn's `input.value`, the response markdown its `output.value`, and the tool input goes on the tool span: the file path (and edits) for reads and writes, the command line for commands, the MCP arguments and result for MCP tools. With content on, file paths therefore do leave your machine inside the tool input, with the user name in home-directory paths replaced by `<user>` (`/Users/<user>/project/README.md`). While content is on, the per-conversation state file on disk also holds the open turn's prompt and the content of turns closed as incomplete until it is swept; a turn that ends normally leaves no content in it. Each field is capped at 4096 characters and common key formats are replaced with `[REDACTED]`. See [Privacy](/docs/integrations/coding-agents/hook-to-otlp#privacy) for details.
115115

116+
## How other tools support Devin Desktop (Windsurf)
117+
118+
- **Cascade hooks.** The only mechanism a tracing recipe can use is the one documented on [Cascade Hooks](https://docs.devin.ai/desktop/cascade/hooks) (also [Windsurf docs](https://docs.windsurf.com/windsurf/cascade/hooks)). Community tools use it too: KiroGraph registers `post_cascade_response` in `.windsurf/hooks.json` ([KiroGraph](https://github.com/davide-desio-eleva/kirograph/blob/main/docs/guide/integrations.md)).
119+
- **Not found.** Langfuse, Arize Phoenix (its [coding-harness-tracing](https://github.com/Arize-ai/coding-harness-tracing) lists Devin CLI, not Devin Desktop), LangSmith, Datadog, Honeycomb, SigNoz, Laminar, Opik, Helicone, PostHog and AgentOps have no Devin Desktop or Windsurf tracing page. Braintrust documents only an [MCP connection](https://www.braintrust.dev/docs/integrations/developer-tools/devin-desktop), which reads Braintrust data from the agent and does not trace the agent. Devin Local, the other agent in Devin Desktop, has separate [lifecycle hooks](https://docs.devin.ai/cli/extensibility/hooks/lifecycle-hooks).
120+
116121
## Verification status
117122

118-
Devin Desktop 3.8.20 was downloaded and its bundled Cascade language server was checked for the hook names, the `agent_action_name`, `trajectory_id`, `execution_id`, `model_name`, and `tool_info` input fields, and the `hooks.json` locations used here. The adapter was tested end to end with payloads shaped exactly as the Cascade Hooks page documents them, run through the `hooks.json` commands into Future AGI. A signed-in Cascade conversation has not been traced yet: Devin Desktop requires a Devin account before Cascade runs.
123+
Verified 2026-10-20 against a local Future AGI.
124+
125+
- **Real:** the Devin Desktop 3.8.20 build (hook names, input field names, `hooks.json` locations found in the bundled language server); the installer writing `~/.codeium/windsurf/hooks.json` into an isolated home; the installed `hooks.json` commands run with `bash -c` and the Cascade-documented working directory, exit code 0 and empty stdout for every hook; spans stored and shown in Observe.
126+
- **Stand-in:** the hook input. A signed-in Cascade conversation requires a Devin account, which was not created. The inputs are the `tool_info` examples copied from the Cascade Hooks page, with the documented common fields added. Still unverified in a real Cascade run: that Devin Desktop 3.8.20 loads `~/.codeium/windsurf/hooks.json`, the real `post_mcp_tool_use` payload, whether `post_cascade_response` fires for a cancelled turn, and one trace per real `trajectory_id`.
119127

120128
## Troubleshooting
121129

0 commit comments

Comments
 (0)