You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit c9c1e56
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: src/pages/docs/integrations/coding-agents/devin-desktop.mdx
+10-2Lines changed: 10 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ This covers the Cascade agent only. It is not the same as:
24
24
25
25
|||
26
26
| --- | --- |
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)). |
28
28
| Devin docs used |[Cascade Hooks](https://docs.devin.ai/desktop/cascade/hooks), read 2026-10-14 |
29
29
| 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). |
30
30
| 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
113
113
114
114
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.
115
115
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
+
116
121
## Verification status
117
122
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`.
0 commit comments