dcd2c1f0f7
Completed in this session: - Integrated Gitea with Pangolin Tunnel (git.pdmarf.co.uk domain) - Fixed protocol mismatch (HTTPS ROOT_URL with HTTP service) - Fixed SSH agent persistence bug in VPS-SSH-KEY-SETUP.md Step 7 - Updated documentation for dual access (internal IP + domain) - Comprehensive troubleshooting guides added All systems operational and ready for VPS deployment. Both repositories functional and fully documented. Next session: Deploy to actual VPS and test complete workflows.
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
- 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 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/sysadmin-session-closer.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