---
description: Refresh the Windsurf chat history archive (re-scan all repos, update symlinks, copy docs/workflows)
---

# Refresh Windsurf Chat History Archive

Refreshes the centralized Windsurf chat history archive at `__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/`.
Auto-discovers new repos, updates symlinks, and re-copies docs + workflows.

## Covered Repos (All 13 workspaces)

| Repo                                | Product            | Workflows | Docs |
| ----------------------------------- | ------------------ | --------- | ---- |
| `learning_ai_common_plat`           | Common Platform    | ✅        | ✅   |
| `learning_voice_ai_agent`           | LysnrAI            | ✅        | ✅   |
| `learning_multimodal_memory_agents` | MindLyst           | ✅        | ✅   |
| `learning_ai_clock`                 | ChronoMind         | ✅        | —    |
| `learning_ai_fastgap`               | NomGap             | ✅        | —    |
| `learning_ai_jarvis_jr`             | JarvisJr           | ✅        | —    |
| `learning_ai_peakpulse`             | PeakPulse          | ✅        | —    |
| `learning_ai_notes`                 | NoteLett           | ✅        | —    |
| `learning_ai_flowmonk`              | FlowMonk           | ✅        | —    |
| `learning_ai_trails`                | ActionTrail        | ✅        | —    |
| `learning_ai_auth_app`              | ByteLyst SmartAuth | ✅        | —    |
| `learning_ai_productivity_web`      | Productivity Tools | ✅        | —    |

## Steps

// turbo

1. Run the refresh script:

```bash
/Users/sd9235/code/mygh/learning_ai_common_plat/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/refresh.sh
```

2. Check the refresh log:

```bash
cat /Users/sd9235/code/mygh/learning_ai_common_plat/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log
```

3. Verify symlinks are valid:

```bash
ls -la /Users/sd9235/code/mygh/learning_ai_common_plat/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/ | grep "^l"
```

## Notes

- The script is **idempotent** — safe to run any number of times.
- It auto-discovers repos under `/Users/sd9235/code/mygh/` that have `docs/WINDSURF/` or `.windsurf/workflows/`.
- A **launchd job** runs this daily at 11 PM: `~/Library/LaunchAgents/com.sd9235.windsurf-archive-refresh.plist`.
- Logs: `.last-refresh.log` (stats), `.launchd-stdout.log` / `.launchd-stderr.log` (scheduled run output).
- **See also:** [Workflow Sync Guide](/Users/sd9235/code/mygh/learning_ai_common_plat/docs/guides/WORKFLOW_SYNC.md) — how to keep workflows consistent across repos.

## Manage the scheduled job

```bash
# Check if running
launchctl list | grep windsurf-archive

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

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

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