-
Notifications
You must be signed in to change notification settings - Fork 232
Description
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 stateProposed 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.