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 definitions
• scripts/ - Helper scripts (bootstrap-agents.sh, init-project, etc.)
• templates/ - Template files for agents and session summaries

Available Agents

• sysadmin-session-closer - Automatically closes and documents dev sessions
  • Use at end of sessions to commit and push work
  • Generates comprehensive session summaries
  • Handles git workflows automatically

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

init-project my-project
cd my-project
# Start working...

Each project automatically gets:

• Git repo with Gitea remote configured
• Agents available at .claude/agents/
• Git user info set up

Close a Session

Use the summary agent from your project:

.claude/agents/sysadmin-session-closer.md

The agent will:

• Create comprehensive session summary
• Commit all changes
• Push to Gitea automatically

Documentation

• QUICK-START.md - Fast setup guide for new VPS instances
• scripts/README.md - Documentation for helper scripts
• 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