Files
homelab-agents/WORKFLOW.md
Homelab Automation 9673641de9 Simplify session summary filename format
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>
2025-11-28 22:57:11 +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: {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