---
name: workspace-tools
description: Tools for managing the OpenClaw workspace. Use for searching files, checking inbox, generating daily digests, creating projects, and workspace organization tasks.
---

# Workspace Tools

Tools for managing this workspace.

## Available Tools

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

### Inbox (`tools/inbox-processor.py`)
Show inbox contents and pending items.
```bash
python3 $WORKSPACE/tools/inbox-processor.py
```

### Daily Digest (`tools/daily-digest.py`)
Generate activity summary.
```bash
python3 $WORKSPACE/tools/daily-digest.py
```

### New Project (`scripts/new-project.sh`)
Create a new project from template.
```bash
$WORKSPACE/scripts/new-project.sh project-name
```

## Shell Aliases

If sourced from bashrc, these aliases are available:
- `ws` - cd to workspace
- `proj` - cd to projects
- `tasks` - show TASKS.md
- `today` - show today's notes
- `note "text"` - add timestamped note to today's log
- `search "query"` - search workspace
- `digest` - run daily digest

## Workspace Structure

```
workspace/
├── projects/    - Active work
├── docs/        - Reference materials
├── inbox/       - Items to process
├── archive/     - Completed work
├── memory/      - Daily notes (YYYY-MM-DD.md)
├── templates/   - Project/note templates
├── scripts/     - Shell scripts
├── tools/       - Python utilities
└── skills/      - Custom skills
```

## Conventions

- File names: lowercase, hyphens, no spaces
- Dates: YYYY-MM-DD format
- Projects: one folder per project in projects/
- Archive completed work, don't delete