# 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

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

```bash
source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)
```

### Create a New Project

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

- [QUICK-START.md](QUICK-START.md) - Fast setup guide for new VPS instances
- [scripts/README.md](scripts/README.md) - Documentation for helper scripts
- [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