1602733fad
Renamed the agent from 'sysadmin-session-closer' to 'finish-up' and added VPS hostname functionality to session summary filenames. Changes: - Renamed agent file: agents/sysadmin-session-closer.md → agents/finish-up.md - Updated agent version to 1.1.0 - Modified agent to include VPS hostname in session summary filenames - Session summaries now use format: [PROJECT_NAME]-[HOSTNAME]-session-summary.md - Hostname is auto-detected using `hostname` command - Updated all documentation references: - README.md, QUICK-START.md, agents/README.md - scripts/README.md, scripts/bootstrap-agents.sh, scripts/init-project.sh - Improved agent description to mention VPS hostname functionality Repository: http://100.120.125.113:3000/pdm/homelab-agents Next Session Focus: Test the renamed agent on a VPS project to verify hostname detection works correctly 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
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
|
|
|
|
- **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 |