workbuddy-fs-managerlisted
Install: claude install-skill Ldxs001/workbuddy-skills
# WorkBuddy File System Manager
Cross-platform tool for managing WorkBuddy workspace directories, database
consistency, and session jsonl files. Three independent modules:
- **Archive** — Move inactive workspace dirs to an archive folder
- **DB Sync** — Fix stale entries in workbuddy.db
- **Task Clean** — Remove ghost TaskCreate/TaskUpdate/TaskList from jsonl
## Quick Start
Run the bundled script with all modules:
```bash
python scripts/workbuddy_fs_manager.py
```
Dry-run to preview changes:
```bash
python scripts/workbuddy_fs_manager.py --dry-run
```
Check environment status:
```bash
python scripts/workbuddy_fs_manager.py --status
```
## Module Details
### 1. Workspace Archiver (`--archive`)
Scans the WorkBuddy root directory for inactive workspace directories and moves
them to an `archive/` subfolder.
**Default archive patterns** (directories matching any of these are archived):
| Pattern | Matches |
|---------|---------|
| `automation-*` | `automation-claw-2026-05-12-task-25` |
| `202*-` | `2026-05-12-my-project` |
| `*-task-*` | `anything-task-1` |
**Protected directories** (never archived):
- `archive/` — the archive folder itself
- Current working directory — wherever the agent is running
- **Active session directories** — any directory used by a `working` session (sub-agents are protected)
- Directories specified via `--keep` flag
**Custom patterns:**
```bash
# Add extra pattern
python scripts/workbuddy_fs_manager.py --archive --pattern "temp-*"
# Pro