root d537ddc665 Update: QUICK-START to clarify repository creation step
- Emphasize: Create repo on Gitea FIRST, then init-project
- Add Step 1: Create repository on Gitea web UI
- Add Step 2: Run init-project to configure local repo
- Update workflow summary to show correct order
- Add SSH key setup section
- Clarify that init-project connects to existing repo
2025-11-23 22:29:03 +00:00

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

Repository Information

Description
Central storage for AI agent prompts
Readme 194 KiB
Languages
Shell 100%