Windsurf (unsupported)¶
Windsurf is catalogued so readers can see that agentgrep looked for the backend and why it does not appear in normal search. Its Cascade transcript files are opaque encrypted protobuf blobs, so the backend remains documented but unsupported.
Base path: ~/.codeium/windsurf (Codeium’s Windsurf “Cascade” agent).
observed_version: Windsurf Cascade (observed 2026-06-21).
Warning
Windsurf is documented but unsupported. Its per-session Cascade
conversation transcripts (cascade/, implicit/, chat_state/,
memories/ as .pb) are high-entropy, apparently-encrypted binary:
the payloads are not gzip/zlib and yield no extractable UTF-8 text, so
agentgrep cannot read them without Codeium’s format and key. agentgrep
catalogues the storage locations for inventory completeness but does
not cover Windsurf — it is excluded from --agent selection and
default search.
Stores¶
- Role:
primary_chat- Format:
protobuf- Coverage:
catalog_only- Adapter:
-
- Role:
supplementary_chat- Format:
protobuf- Coverage:
catalog_only- Adapter:
-
- Role:
supplementary_chat- Format:
protobuf- Coverage:
catalog_only- Adapter:
-
- Role:
persistent_memory- Format:
protobuf- Coverage:
catalog_only- Adapter:
-
- Role:
plan- Format:
md_frontmatter- Coverage:
catalog_only- Adapter:
-
- Role:
instruction- Format:
text- Coverage:
catalog_only- Adapter:
-
windsurf.cascade¶
Per-session Cascade conversation transcript as opaque binary (cascade/<uuid>.pb, often multi-megabyte). The observed payloads are high-entropy with no extractable UTF-8 runs and are not gzip/zlib — they appear encrypted or custom-encoded, so agentgrep cannot read them. Documented location only; Windsurf is unsupported. The top-level ~/.codeium/cascade/ directory mirrors this for the non-Windsurf Codeium install.
- Agent:
Windsurf
- Role:
primary_chat- Format:
protobuf- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/cascade/<session_uuid>.pb- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
windsurf.implicit¶
Implicit/background Cascade context-capture records as opaque, apparently-encrypted binary. Documented location only; unsupported.
- Agent:
Windsurf
- Role:
supplementary_chat- Format:
protobuf- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/implicit/<uuid>.pb- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
windsurf.chat_state¶
Per-file chat state for legacy Codeium chat, opaque apparently-encrypted binary keyed by source file path. Documented location only; unsupported.
- Agent:
Windsurf
- Role:
supplementary_chat- Format:
protobuf- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/chat_state/<name>.pb- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
windsurf.memories¶
Cascade memory entries as opaque, apparently-encrypted binary, one per uuid. Documented location only; unsupported. The companion memories/global_rules.md is readable Markdown (see windsurf.global_rules).
- Agent:
Windsurf
- Role:
persistent_memory- Format:
protobuf- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/memories/<uuid>.pb- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
windsurf.brain¶
Cascade agent-authored implementation plans as Markdown (brain/<uuid>/plan.md). Readable, but documented location only because Windsurf’s conversation transcripts are encrypted and the agent is unsupported; the companion plan_metadata.pbtxt is protobuf-text metadata.
- Agent:
Windsurf
- Role:
plan- Format:
md_frontmatter- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/brain/<uuid>/plan.md- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
windsurf.global_rules¶
User-authored global rules Markdown injected into Cascade sessions — the Windsurf analogue of Claude’s CLAUDE.md. Readable, but documented location only because the agent is unsupported.
- Agent:
Windsurf
- Role:
instruction- Format:
text- Coverage:
catalog_only- Path:
${HOME}/.codeium/windsurf/memories/global_rules.md- Adapter:
-
- Data version:
-- Version strategies:
-- Observed:
Windsurf Cascade (2026-08-08)
- Default search:
no
All rows are catalog-only: agentgrep documents where the data lives but does not parse it.
Record schemas¶
Cascade transcripts¶
windsurf.cascade covers per-session Cascade conversation
transcripts at cascade/<session_uuid>.pb. They are opaque encrypted binary
(often multi-megabyte). No readable text is recoverable; the row documents the
transcript location only. The top-level ~/.codeium/cascade/ directory mirrors
this for the non-Windsurf Codeium install.
Implicit, chat-state, and memory blobs¶
windsurf.implicit, windsurf.chat_state, and
windsurf.memories cover implicit/<uuid>.pb (background context
capture), chat_state/<name>.pb (per-file legacy chat state), and
memories/<uuid>.pb (Cascade memory). They are all opaque encrypted binary,
documented by location only.
Brain plans and global rules¶
windsurf.brain and windsurf.global_rules cover
brain/<uuid>/plan.md (agent-authored plans) and memories/global_rules.md
(user-authored global rules — the Windsurf analogue of CLAUDE.md). They are
readable Markdown, but documented by location only because Windsurf as a whole
is unsupported.