Claude Code Agents

Shared repository for Claude Code AI agents across machines.

📦 Contents

This repository contains 13 specialized Claude agents:

Core Agents

documentation-keeper - Automatically updates server documentation when services change
homelab-optimizer - Analyzes homelab infrastructure and provides optimization recommendations

GSD (Get Shit Done) Agent System

Complete workflow system for structured project development:

gsd-project-researcher - Researches domain ecosystem before roadmap creation
gsd-roadmapper - Creates project roadmaps with phase breakdown
gsd-phase-researcher - Researches implementation approaches before planning
gsd-planner - Creates executable phase plans with task breakdown
gsd-plan-checker - Verifies plans will achieve phase goals
gsd-executor - Executes plans with atomic commits and state management
gsd-verifier - Verifies phase goal achievement through analysis
gsd-integration-checker - Verifies cross-phase integration and E2E flows
gsd-debugger - Investigates bugs using scientific method
gsd-codebase-mapper - Explores codebase and writes structured analysis

🚀 Setup on New Machine

Initial Clone

# Clone to Claude's agents directory
git clone https://gitea.pressmess.duckdns.org/admin/claude-agents.git ~/.claude/agents

# Or if directory exists, pull into it
cd ~/.claude/agents
git init
git remote add origin https://gitea.pressmess.duckdns.org/admin/claude-agents.git
git pull origin main

Configure Git

git config --global user.name "admin"
git config --global user.email "admin@server-ai.local"

🔄 Syncing Changes

Push Changes

cd ~/.claude/agents
git add .
git commit -m "Description of changes"
git push origin main

Pull Changes

cd ~/.claude/agents
git pull origin main

Quick Sync Script

# Add to ~/.bashrc or create ~/sync-agents.sh
sync-agents() {
    cd ~/.claude/agents
    git pull origin main
    echo "✓ Agents synced from Gitea"
}

📝 Adding New Agents

Create new agent file: nano ~/.claude/agents/my-new-agent.md
Commit and push:

cd ~/.claude/agents
git add my-new-agent.md
git commit -m "Add my-new-agent: description"
git push origin main

🌐 Repository

Gitea URL: https://gitea.pressmess.duckdns.org/admin/claude-agents

Clone URL: https://gitea.pressmess.duckdns.org/admin/claude-agents.git

🔐 Authentication

Uses admin credentials for Gitea access. Credentials are stored in git remote URL (URL-encoded).

To update credentials:

cd ~/.claude/agents
git remote set-url origin https://admin:PASSWORD@gitea.pressmess.duckdns.org/admin/claude-agents.git

Skills sync: Managed by Skillshare at ~/.claude/skills/
Server docs: /home/jon/SERVER-DOCUMENTATION.md

2.9 KiB Raw Blame History