# Tools

Local tools and utilities we build.

## Built

### search.py
Search workspace files for keywords.
```bash
python3 tools/search.py "query" [max_results]
```

### inbox-processor.py
Show inbox contents and status.
```bash
python3 tools/inbox-processor.py
```

### daily-digest.py
Generate daily activity summary.
```bash
python3 tools/daily-digest.py
```

### web-clipper.py
Save URLs with titles, notes, and tags.
```bash
python3 tools/web-clipper.py add "url" "title" "notes"
python3 tools/web-clipper.py list [limit]
python3 tools/web-clipper.py search "query"
```

### dashboard.py
Web dashboard showing workspace status.
```bash
python3 tools/dashboard.py  # Serves on localhost:8080
```

### briefing.py
Generate morning briefing with tasks, notes, and clips.
```bash
python3 tools/briefing.py
```

### scaffold.py
Create new projects from templates (python, node, script, docs, experiment).
```bash
python3 tools/scaffold.py <name> [template] [description]
python3 tools/scaffold.py --list
```

### watcher.py
Monitor workspace for file changes.
```bash
python3 tools/watcher.py check   # Check once
python3 tools/watcher.py watch   # Monitor continuously
```

### focus.py
Pomodoro-style focus timer with logging.
```bash
python3 tools/focus.py 25 "Task description"
python3 tools/focus.py stats
```

## Planned

- [ ] File indexer with tags
- [ ] Reminder system
