feat(windsurf): add Windsurf (Codeium) integration via MCP - #2358
Merged
Conversation
Config-only CLI that wires the Hindsight MCP server into Windsurf's ~/.codeium/windsurf/mcp_config.json (mcpServers, remote serverUrl + auth header) and writes an always-on recall/retain rule to .windsurf/rules/hindsight.md (trigger: always_on). Cascade then has recall/retain/reflect and uses them automatically. - hindsight_windsurf: config, mcp_config (strict-JSON parse-or-print), rules (dedicated sentinel-marked file), cli (init/status/uninstall) - 25 unit tests + gated live-MCP-endpoint E2E - CI job, release + changelog registries, docs page, icon, README row Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
lint.sh runs 'ruff format'; collapse the --rules-path add_argument to one line so verify-generated-files passes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the placeholder abstract mark with the official Windsurf logo (simple-icons, CC0), matching the real-brand-logo convention used by the other integration icons. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…tion # Conflicts: # hindsight-integrations/README.md # scripts/release-integration.sh
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a first-party Windsurf (Codeium) integration: a config-only CLI (
hindsight-windsurf) that gives Cascade persistent long-term memory through the Hindsight MCP server — mirroring the MCP-convergence pattern of the Zed / Continue / OpenHands / GitHub Copilot integrations.hindsight-windsurf init:~/.codeium/windsurf/mcp_config.jsonundermcpServersas a remote server (serverUrl+ optionalAuthorization: Bearerheader — Windsurf connects to the HTTP endpoint directly, no bridge)..windsurf/rules/hindsight.md(trigger: always_onfrontmatter), a dedicated sentinel-marked file so update/uninstall never touch the user's other rules.Both config formats were verified against Windsurf's current live docs.
Package (
hindsight_windsurf)config.py— layered defaults →~/.hindsight/windsurf.json→ env (HINDSIGHT_WINDSURF_BANK_ID), bank defaults towindsurfmcp_config.py—mcpServers.hindsightwriter; strict-JSON parse-or-print fallback (never rewrites a file it can't round-trip)rules.py— dedicated.windsurf/rules/hindsight.mdwithalways_onfrontmattercli.py—init/status/uninstall(+--print-only)Meets the merge checklist
requires_real_llm)test-windsurf-integrationadded totest.yml(detect-changes filter, output decl, aggregation list)release-integration.shVALID_INTEGRATIONSandgenerate_changelog.pyINTEGRATIONSintegrations.jsonentry (strict JSON;check-integrations.mjspasses),docs-integrations/windsurf.md, icon, README rowValidation
pytest -m 'not requires_real_llm'→ 25 passed; ruff (repo-root config) clean;uv build+uv.lockcommittedinitwrote the correctmcp_config.json+always_onrule file, and a live MCP handshake (initialize → tools/list → recall) against that exact endpoint returned all seeded facts — same validation depth as Zed/OpenCode.🤖 Generated with Claude Code