Windsurf

Windsurf (by Codeium) telemetry is captured via editor hook scripts that the CLI installs.

Automatic Setup

flowstate-telemetry install --tool windsurf

This installs a hook script into ~/.windsurf/hooks/ and configures ~/.codeium/windsurf/hooks.json to capture session events.

Manual Setup

The CLI creates hook scripts and a JSON configuration file. Manual setup is not recommended for Windsurf — use the CLI instead.

If you need to configure manually, the CLI writes to:

• ~/.windsurf/hooks/flowstate.sh — hook script
• ~/.codeium/windsurf/hooks.json — hook event configuration

The hooks capture events on: pre_user_prompt, post_cascade_response_with_transcript, post_write_code, post_run_command, post_mcp_tool_use.

What Gets Captured

Event	Data Collected
User prompts	Prompt text, session ID
Cascade responses	Transcript content, model, tokens
File operations	Files modified, lines changed
Shell commands	Command execution events
MCP tool use	Tool name, success/failure

TIP

Prompt capture is always on for Windsurf — the hook scripts capture prompt content and cascade transcripts by default. There is no opt-in flag.

Limitations

• Autocomplete suggestions are not tracked