d289d33c4d
- 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
86 lines
2.4 KiB
Markdown
86 lines
2.4 KiB
Markdown
# 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 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/sysadmin-session-closer.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 |