Files
homelab-agents/WORKFLOW.md
Homelab Automation 43770a7895 Add simple workflow guide for homelab agents
Added WORKFLOW.md with streamlined instructions for:
- One-line VPS setup via curl bootstrap script
- Simple 3-step project workflow
- Key rules for where to run finish-up agent
- Quick reference table

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-28 22:44:44 +00:00

1.5 KiB

Homelab Agents Workflow

Simple workflow for using agents across multiple VPS instances.


Setup New VPS (One Time)

# 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

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: {project-name}-{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