Changed filename from [PROJECT_NAME]-[HOSTNAME]-session-summary.md to [HOSTNAME]-session-summary.md Rationale: - Session summary is saved inside project directory - Project name in filename is redundant - Simpler, cleaner filename - No timestamp (overwrites each session) Updated files: - agents/finish-up.md: Updated filename format in Steps 1, 3, and 7 - CLAUDE.md: Updated agent naming convention and session history - WORKFLOW.md: Updated agent behavior description 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
62 lines
1.5 KiB
Markdown
62 lines
1.5 KiB
Markdown
# 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`
|