Files

root d289d33c4d Update: README clarifies two-step project creation

- Step 1: Create repo on Gitea web UI first
- Step 2: Run init-project to set up local copy
- Emphasize SSH authentication for git push
- Update workflow summary with correct order
- Clarify agents use SSH remote

2025-11-23 22:29:22 +00:00

2.4 KiB

Raw Blame History

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 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

2.4 KiB Raw Blame History