Skip to content

Add Windsurf Cascade agent support (preview) #496

@d4rk8l1tz

Description

@d4rk8l1tz

Problem or use case

Entire currently supports Claude Code, Gemini CLI, OpenCode, and Cursor, but not Windsurf Cascade.

For teams that use Windsurf as their primary coding agent, this means Entire cannot capture session transcripts/checkpoints from Windsurf workflows. As a result, users lose rewind/resume traceability for that agent and cannot keep a consistent workflow across tools.

https://docs.windsurf.com/windsurf/cascade/hooks

End goal: use Entire with Windsurf in the same way users can with other supported agents.

Desired behavior

# Enable Windsurf hooks
entire enable --agent windsurf

# Entire installs hooks in:
# .windsurf/hooks.json (nested "hooks" config)

# During Windsurf usage:
# - pre_user_prompt starts a turn
# - post_write_code records modified files
# - post_cascade_response ends a turn/checkpoint

entire rewind --list
# shows checkpoints created from Windsurf sessions

entire status
# shows active/restorable Windsurf session state

Proposed solution

Add Windsurf as a first-class agent integration in Entire (initially preview), including:

  • Agent registration and detection in the agent registry
  • Hook installation/uninstallation in .windsurf/hooks.json
  • Canonical Windsurf config format support with top-level "hooks" object
  • Lifecycle mapping from Windsurf hook events to Entire turn lifecycle
  • Transcript parsing (JSONL) for prompts, modified files, summary extraction, and offsets
  • Strategy integration so checkpoints and condensation work like other agents
  • README + integration tests for setup, hook flow, rewind, and metadata behaviour

Alternatives or workarounds

Current workaround is manual checkpointing/logging outside Windsurf integration, which is error-prone and misses session fidelity.

Another workaround is switching to a different supported agent, which is not practical for teams standardised on Windsurf.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions