43770a7895
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>
Homelab Agents
Central storage for AI agent prompts shared across all VPS instances.
Quick Start
For new VPS instances, run this once:
source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)
This sets up everything you need. See QUICK-START.md for detailed instructions.
Structure
agents/- Agent prompt definitionsscripts/- Helper scripts (bootstrap-agents.sh, init-project, etc.)templates/- Template files for agents and session summaries
Available Agents
- finish-up - Automatically closes and documents dev sessions
- Use at end of sessions to commit and push work
- Generates comprehensive session summaries with VPS hostname
- Handles git workflows automatically via SSH
Usage
First Time on a VPS
source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)
Create a New Project
Step 1: Create repository on Gitea Go to http://100.120.125.113:3000/repo/create
- Repository name:
my-project - Click Create
Step 2: Initialize project locally
init-project my-project
cd my-project
# Start working...
Each project automatically gets:
- Git repo with SSH remote configured (git@100.120.125.113:pdm/my-project.git)
- Agents available at
.claude/agents/ - Git user info set up
Close a Session
Use the summary agent from your project:
.claude/agents/finish-up.md
The agent will:
- Create comprehensive session summary
- Commit all changes
- Push to Gitea via SSH automatically
Documentation
- QUICK-START.md - Fast setup guide for new VPS instances
- scripts/README.md - Documentation for helper scripts
- SSH-SETUP.md - SSH key configuration for git push
- agents/README.md - Information about available agents
Repository Information
- Location: http://100.120.125.113:3000/pdm/homelab-agents
- Access: Internal network only
- Purpose: Centralized AI agent prompts for all homelab VPS instances
Workflow Summary
- Bootstrap VPS:
source <(curl -s ...bootstrap-agents.sh) - Create repo on Gitea: http://100.120.125.113:3000/repo/create
- Init project:
init-project my-project - Work on project
- Close session with agent
- Agent auto-commits and pushes via SSH