# Workspace Automations

Agent workspace management for multi-agent operation.

## Scripts

| Script | Source | Purpose |
|--------|--------|---------|
| `agent_workspace.sh` | `../../scripts/agent_workspace.sh` | Manage isolated agent environments |
| `bootstrap.sh` | `../../.kimi/scripts/bootstrap.sh` | One-time Kimi workspace setup |
| `dev.sh` | `../../.kimi/scripts/dev.sh` | Development helper commands |
| `resume.sh` | `../../.kimi/scripts/resume.sh` | Quick status check |

## Agent Workspace Layout

```
/tmp/timmy-agents/
├── hermes/        # Loop orchestrator
├── kimi-0/        # Kimi pane 0
├── kimi-1/        # Kimi pane 1
├── kimi-2/        # Kimi pane 2
├── kimi-3/        # Kimi pane 3
└── smoke/         # Smoke testing environment
```

Each workspace gets:
- Isolated git clone (from Gitea, not local repo)
- Unique port range (8100+, 8200+)
- Separate data directory
- Own TIMMY_HOME

## Usage

```bash
# Initialize all workspaces
bash scripts/agent_workspace.sh init-all

# Reset a specific workspace
bash scripts/agent_workspace.sh reset kimi-0

# Create branch in workspace
bash scripts/agent_workspace.sh branch kimi-0 feature/my-branch

# Bootstrap Kimi workspace
bash .kimi/scripts/bootstrap.sh

# Check status
bash .kimi/scripts/resume.sh
```

## Port Allocation

| Agent | Dashboard | Serve |
|-------|-----------|-------|
| hermes | 8100 | 8200 |
| kimi-0 | 8101 | 8201 |
| kimi-1 | 8102 | 8202 |
| kimi-2 | 8103 | 8203 |
| kimi-3 | 8104 | 8204 |
| smoke | 8109 | 8209 |
