93d879a434
Comprehensive session documenting cleanup and standardization of homelab-agents repository. Established clear file naming conventions, consolidated duplicate documentation, and ensured agent compatibility across all VPS instances. Changes: - Updated sys-apps-session-summary.md with complete session documentation - Updated CLAUDE.md with session history and VPS hostname change (108-system-apps → sys-apps) - Session covers: workflow docs, naming conventions, git basics, and documentation consolidation - All changes from 8 commits throughout session now documented Repository: http://100.120.125.113:3000/pdm/homelab-agents Next Session Focus: Test finish-up agent on real project repository 🤖 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