a0acb5b7fe
PROBLEM: Step 7 ~/.bashrc method still not persistent - agent dies on logout ROOT CAUSE: ~/.bashrc approach relies on shell process lifecycle - Agent dies when last shell exits - Socket files get cleaned up - User must manually restart on next login NEW SOLUTION: Systemd user service keeps agent truly persistent - Agent runs as systemd service (survives logout/reboot) - Single socket location managed by systemd - Auto-starts on user login - Works across all shells and sessions - No manual intervention needed IMPROVEMENTS: - Added systemd-based setup as recommended method - Kept ~/.bashrc method as fallback (for systems without systemd) - Added comprehensive diagnostic script - Added troubleshooting for common issues - Quick reference commands for management The systemd method is production-grade and used in enterprise environments. SSH agent now persists forever (until explicitly stopped).
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