Windsurf (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 (observed 2026-06-21) (2026-06-21)
- 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 (observed 2026-06-21) (2026-06-21)
- 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 (observed 2026-06-21) (2026-06-21)
- 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 (observed 2026-06-21) (2026-06-21)
- 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 (observed 2026-06-21) (2026-06-21)
- 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 (observed 2026-06-21) (2026-06-21)
- Default search:
no
All rows are catalog-only: agentgrep documents where the data lives but does not parse it.
Record schemas¶
windsurf.cascade¶
cascade/<session_uuid>.pb — per-session Cascade conversation
transcript, 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.
windsurf.implicit, windsurf.chat_state, windsurf.memories¶
implicit/<uuid>.pb (background context capture), chat_state/<name>.pb
(per-file legacy chat state), and memories/<uuid>.pb (Cascade memory)
are all opaque encrypted binary, documented by location only.
windsurf.brain and windsurf.global_rules¶
brain/<uuid>/plan.md (agent-authored plans) and
memories/global_rules.md (user-authored global rules — the Windsurf
analogue of CLAUDE.md) are readable Markdown, but documented by
location only because Windsurf as a whole is unsupported.