# Homelab Agents

Central storage for AI agent prompts shared across all VPS instances.

## Quick Start

For new VPS instances, run this once:

```bash
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](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

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

```bash
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**
```bash
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](QUICK-START.md) - Fast setup guide for new VPS instances
- [scripts/README.md](scripts/README.md) - Documentation for helper scripts
- [SSH-SETUP.md](SSH-SETUP.md) - SSH key configuration for git push
- [agents/README.md](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

1. Bootstrap VPS: `source <(curl -s ...bootstrap-agents.sh)`
2. Create repo on Gitea: http://100.120.125.113:3000/repo/create
3. Init project: `init-project my-project`
4. Work on project
5. Close session with agent
6. Agent auto-commits and pushes via SSH