# Windsurf / Codeium Cascade — Chat History & Data Archive

> Central index of all Windsurf IDE data on this machine.
> Most entries are **symlinks** to the original locations — data stays in place, this folder provides a single access point.

---

## Folder Structure

```
WINDSURF/
├── cascade_conversations/    → ~/.codeium/windsurf/cascade/          (symlink)
├── memories/                 → ~/.codeium/windsurf/memories/          (symlink)
├── implicit_context/         → ~/.codeium/windsurf/implicit/          (symlink)
├── code_tracker/             → ~/.codeium/windsurf/code_tracker/      (symlink)
├── codemaps/                 → ~/.codeium/windsurf/codemaps/          (symlink)
├── database/                 → ~/.codeium/windsurf/database/          (symlink)
├── app_data/                 → ~/Library/Application Support/Windsurf/          (symlink)
├── file_edit_history/        → ~/Library/Application Support/Windsurf/User/History/          (symlink)
├── workspace_storage/        → ~/Library/Application Support/Windsurf/User/workspaceStorage/  (symlink)
├── global_storage/           → ~/Library/Application Support/Windsurf/User/globalStorage/     (symlink)
├── user_settings.pb          → ~/.codeium/windsurf/user_settings.pb   (symlink)
├── installation_id           → ~/.codeium/windsurf/installation_id    (symlink)
├── repo_docs/                (copies of docs/WINDSURF/ from each repo)
│   ├── learning_voice_ai_agent/
│   ├── learning_multimodal_memory_agents/
│   └── learning_ai_common_plat/
├── repo_workflows/           (copies of .windsurf/workflows/ from each repo)
│   ├── learning_voice_ai_agent/
│   ├── learning_multimodal_memory_agents/
│   ├── learning_ai_common_plat/
│   └── learning_agent_monitoring_fx/
└── README.md                 (this file)
```

---

## Data Inventory

### 1. Cascade Conversations (`cascade_conversations/`)

| Detail          | Value                                                                                                                                              |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Source**      | `~/.codeium/windsurf/cascade/`                                                                                                                     |
| **Format**      | Protobuf (`.pb`)                                                                                                                                   |
| **Count**       | ~50 conversations                                                                                                                                  |
| **Size**        | ~569 MB                                                                                                                                            |
| **Description** | Full Cascade chat history — every conversation with tool calls, code edits, and responses. Each `.pb` file is one conversation identified by UUID. |

### 2. Memories (`memories/`)

| Detail          | Value                                                                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Source**      | `~/.codeium/windsurf/memories/`                                                                                                                              |
| **Format**      | Protobuf (`.pb`)                                                                                                                                             |
| **Count**       | ~40 memory entries + `global_rules.md`                                                                                                                       |
| **Description** | Persistent memories created by Cascade across conversations. Each UUID file is one memory. Includes user preferences, project facts, architecture decisions. |

### 3. Implicit Context (`implicit_context/`)

| Detail          | Value                                                                                                                 |
| --------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Source**      | `~/.codeium/windsurf/implicit/`                                                                                       |
| **Format**      | Protobuf (`.pb`)                                                                                                      |
| **Count**       | ~20 entries                                                                                                           |
| **Description** | Automatically captured user activity context (file edits, navigation). Used by Cascade for context-aware suggestions. |

### 4. Code Tracker (`code_tracker/`)

| Detail          | Value                                                                                                                                                     |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Source**      | `~/.codeium/windsurf/code_tracker/`                                                                                                                       |
| **Subdirs**     | `active/` (~152 dirs), `history/` (empty)                                                                                                                 |
| **Description** | Tracks code changes per repo per commit. Folders named `{repo}_{commit_hash}/`. Covers all repos including work repos (`sara_apm0046660-ats-abs-agents`). |

**Repos tracked:**

- `learning_ai_common_plat` (6 entries)
- `learning_multimodal_memory_agents` (~100 entries)
- `learning_voice_ai_agent` (~11 entries)
- `learning_ai_magic_clipboard_mgr` (~8 entries)
- `learning_magic_terminal` (1 entry)
- `sara_apm0046660-ats-abs-agents` (~27 entries, work repo)
- `no_repo` (1 entry)

### 5. App Data (`app_data/`)

| Detail          | Value                                                                                 |
| --------------- | ------------------------------------------------------------------------------------- |
| **Source**      | `~/Library/Application Support/Windsurf/`                                             |
| **Description** | VS Code-based app data: caches, cookies, preferences, local storage, service workers. |

### 6. File Edit History (`file_edit_history/`)

| Detail          | Value                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Source**      | `~/Library/Application Support/Windsurf/User/History/`                                                             |
| **Count**       | ~1,701 entries                                                                                                     |
| **Description** | VS Code-style local file edit history. Each subfolder (hash-named) contains timestamped snapshots of edited files. |

### 7. Workspace Storage (`workspace_storage/`)

| Detail          | Value                                                           |
| --------------- | --------------------------------------------------------------- |
| **Source**      | `~/Library/Application Support/Windsurf/User/workspaceStorage/` |
| **Count**       | ~26 workspaces                                                  |
| **Description** | Per-workspace extension state, settings, and cached data.       |

### 8. Global Storage (`global_storage/`)

| Detail          | Value                                                         |
| --------------- | ------------------------------------------------------------- |
| **Source**      | `~/Library/Application Support/Windsurf/User/globalStorage/`  |
| **Files**       | `state.vscdb` (~570 KB), `storage.json` (~86 KB)              |
| **Description** | Global VS Code state database (SQLite) and extension storage. |

### 9. Codemaps (`codemaps/`)

| Detail          | Value                                                                   |
| --------------- | ----------------------------------------------------------------------- |
| **Source**      | `~/.codeium/windsurf/codemaps/`                                         |
| **Files**       | `codemapindex.json`                                                     |
| **Description** | Code structure maps used by Codeium for intelligent code understanding. |

### 10. Database (`database/`)

| Detail          | Value                                                                      |
| --------------- | -------------------------------------------------------------------------- |
| **Source**      | `~/.codeium/windsurf/database/`                                            |
| **Description** | Internal Codeium database (one subfolder with hash name, currently empty). |

---

## Repo Docs (`repo_docs/`)

Copies of `docs/WINDSURF/` session summaries and design docs from each repo:

### learning_voice_ai_agent (LysnrAI)

- `CODEX_SESSION_SUMMARY_AND_PLAYBOOK.md`

### learning_multimodal_memory_agents (MindLyst)

- `BETA_LAUNCH_READINESS.md`
- `CODEX_SESSION_SUMMARY_AND_PLAYBOOK.md`
- `ENV_AUDIT_LYSNRAI.md`
- `USAGE.png`, `USAGE_REVIEW.md`
- `WEB_ABUSE_CONTROLS.md`

### learning_ai_common_plat (Common Platform)

- `AI_SECURITY_AUDIT_REPORT.md`
- `CLIENT_TELEMETRY_DESIGN.md`
- `CODEX_SESSION_SUMMARY_AND_PLAYBOOK.md`
- `PLATFORM_COMPONENTS_ROADMAP.md`
- `SERVICE_CONSOLIDATION_ROADMAP.md`
- `TELEMETRY_ROADMAP.md`

---

## Repo Workflows (`repo_workflows/`)

Copies of `.windsurf/workflows/` (Cascade slash-command definitions) from each repo:

### learning_voice_ai_agent (13 workflows)

- `debug-service.md`, `docker-compose.md`, `generate-store-assets.md`
- `mobile-code-quality.md`, `production-readiness.md`
- `release-desktop.md`, `release-testflight.md`
- `repo_push-repos.md`, `repo_update-agent-docs.md`
- `start-all-services.md`, `test-coverage.md`
- `test-desktop-app.md`, `test-ios-app.md`

### learning_multimodal_memory_agents (3 workflows)

- `mobile-code-quality.md`
- `release-testflight-mindlyst.md`
- `repo_scan-repo-and-update-windsurf-context.md`

### learning_ai_common_plat (5 workflows)

- `repo_backup-and-push.md`, `repo_backup-main-branch.md`
- `repo_commit-workspace.md`, `repo_push-repos.md`, `repo_sync-repos.md`

### learning_agent_monitoring_fx (1 workflow)

- `build-agent.md`

---

## Original Source Locations

| Data         | Path                                                |
| ------------ | --------------------------------------------------- |
| Codeium root | `~/.codeium/windsurf/`                              |
| App Support  | `~/Library/Application Support/Windsurf/`           |
| HTTP Storage | `~/Library/HTTPStorages/com.exafunction.windsurf/`  |
| Caches       | `~/Library/Caches/com.exafunction.windsurf/`        |
| ShipIt       | `~/Library/Caches/com.exafunction.windsurf.ShipIt/` |

---

## Auto-Refresh

This archive stays up to date automatically via three mechanisms:

### 1. Scheduled (launchd — daily at 11 PM)

A macOS LaunchAgent runs `refresh.sh --quiet` every night at 11 PM.

```bash
# Check status
launchctl list | grep windsurf-archive

# Force run now
launchctl start com.sd9235.windsurf-archive-refresh

# Stop / Start
launchctl unload ~/Library/LaunchAgents/com.sd9235.windsurf-archive-refresh.plist
launchctl load  ~/Library/LaunchAgents/com.sd9235.windsurf-archive-refresh.plist
```

Plist: `~/Library/LaunchAgents/com.sd9235.windsurf-archive-refresh.plist`
Source: `./com.sd9235.windsurf-archive-refresh.plist` (copy kept here)

### 2. Manual (CLI)

```bash
./refresh.sh              # normal (verbose)
./refresh.sh --quiet      # suppress output
./refresh.sh --dry-run    # preview without changes
```

### 3. Windsurf workflow (`/refresh-chat-history`)

Run `/refresh-chat-history` in any Windsurf Cascade conversation.

### What refresh does

- Re-creates all symlinks (idempotent)
- **Auto-discovers new repos** under `/Users/sd9235/code/mygh/` that have `docs/WINDSURF/` or `.windsurf/workflows/`
- Re-copies all repo docs and workflows
- Cleans up stale entries for removed repos
- Writes stats to `.last-refresh.log`

### Logs

| File                  | Contents                                       |
| --------------------- | ---------------------------------------------- |
| `.last-refresh.log`   | Stats from last run (counts, sizes, timestamp) |
| `.launchd-stdout.log` | stdout from scheduled runs                     |
| `.launchd-stderr.log` | stderr from scheduled runs                     |

---

## Notes

- **Protobuf files** (`.pb`) are binary — not human-readable. They require protobuf deserialization tooling to inspect.
- **Symlinks** point to live data. Changes in the source are immediately visible here.
- **Repo docs/workflows** are copies (not symlinks) — run `./refresh.sh` to update them after changes.
- Created: 2026-02-27
