Folder Index
Maintain a lightweight index at ~/.config/folder-index.json to know where important things are without rescanning.
{
"folders": [
{"path": "/Users/alex/projects/webapp", "type": "project", "note": "Main client project"}
]
}
When user asks "where is X" or "find my project Y", check the index first. If not found, do targeted discovery then offer to add the result.
Discovery
When asked to find or index folders:
- Scan likely locations: ~/projects, ~/Documents, ~/code, ~/dev, ~/work
- Detect projects by markers: .git, package.json, pubspec.yaml, Cargo.toml, go.mod, pyproject.toml, *.sln
- Stop at first marker (don't recurse into node_modules, vendor, build)
- Propose what was found, don't auto-add: "Found 8 projects in ~/code. Add to index?"
Path Security
- Canonicalize paths (resolve
~, .., symlinks) before any operation
- Reject system paths: /, /etc, /var, /usr, /System, /Library, C:\Windows, C:\Program Files
- Skip symlinks during traversal, report them separately
Destructive Operations
- Use OS trash instead of permanent delete
- State recoverability: "node_modules: recoverable with npm install"
- Build artifacts safe to delete: node_modules, pycache, .gradle, build/, target/, Pods/, .next/
Platform Quirks
- macOS: .DS_Store alone = effectively empty. Treat .app as single item.
- Windows: Paths >260 chars need
\\?\ prefix.
- Network drives: Warn before bulk ops — may be slow or offline.
1---2name: folders3description: Index important directories and perform safe folder operations with proper security checks.4---56## Folder Index78Maintain a lightweight index at `~/.config/folder-index.json` to know where important things are without rescanning.910```json11{12 "folders": [13 {"path": "/Users/alex/projects/webapp", "type": "project", "note": "Main client project"}14 ]15}16```1718When user asks "where is X" or "find my project Y", check the index first. If not found, do targeted discovery then offer to add the result.1920## Discovery2122When asked to find or index folders:23- Scan likely locations: ~/projects, ~/Documents, ~/code, ~/dev, ~/work24- Detect projects by markers: .git, package.json, pubspec.yaml, Cargo.toml, go.mod, pyproject.toml, *.sln25- Stop at first marker (don't recurse into node_modules, vendor, build)26- Propose what was found, don't auto-add: "Found 8 projects in ~/code. Add to index?"2728## Path Security2930- Canonicalize paths (resolve `~`, `..`, symlinks) before any operation31- Reject system paths: /, /etc, /var, /usr, /System, /Library, C:\Windows, C:\Program Files32- Skip symlinks during traversal, report them separately3334## Destructive Operations3536- Use OS trash instead of permanent delete37- State recoverability: "node_modules: recoverable with npm install"38- Build artifacts safe to delete: node_modules, __pycache__, .gradle, build/, target/, Pods/, .next/3940## Platform Quirks4142- **macOS:** .DS_Store alone = effectively empty. Treat .app as single item.43- **Windows:** Paths >260 chars need `\\?\` prefix.44- **Network drives:** Warn before bulk ops — may be slow or offline.
dvcrn