# Homelab Agents Workflow

Simple workflow for using agents across multiple VPS instances.

---

## Setup New VPS (One Time)

```bash
# Install agents from Gitea
source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)
```

Done! Agents are now available in Claude Code.

---

## Working on Projects

### 1. Navigate to Your Project Directory
```bash
cd ~/vps-system-apps
# or
cd ~/my-project
```

### 2. Do Your Work
Edit files, configure systems, write code...

### 3. When Done, Run Finish Up
In Claude Code, say: **"finish up"**

The agent automatically:
- Creates session summary: `{hostname}-session-summary.md`
- Updates CLAUDE.md and README.md
- Commits and pushes to: `http://100.120.125.113:3000/pdm/{project-name}.git`

---

## Key Rules

**✓ DO:** Run `finish-up` from your project directory (~/vps-system-apps)
- Session summary goes to: vps-system-apps repository

**✗ DON'T:** Run `finish-up` from ~/.homelab-agents
- Would go to homelab-agents repository (only for agent updates)

---

## Quick Reference

| Task | Command |
|------|---------|
| Install agents on new VPS | `source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)` |
| Check current directory | `pwd` |
| End work session | "finish up" in Claude Code |
| Update agents | `cd ~/.homelab-agents && git pull` |

**Repository Pattern:**
- Agents: `http://100.120.125.113:3000/pdm/homelab-agents.git`
- Projects: `http://100.120.125.113:3000/pdm/{directory-name}.git`