From 7e62a571aa58ff7151153bb5bcdd128cb6af0baf Mon Sep 17 00:00:00 2001 From: root Date: Sun, 23 Nov 2025 22:07:14 +0000 Subject: [PATCH] Update: Scripts README to use 'source' for bootstrap MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Changed: bash <(...) → source <(...) - Emphasize agents copied to .claude/agents/ - Clarify agent locations for Claude Code - Update workflow examples - Explain why source is better --- scripts/README.md | 36 +++++++++++++++++++++++++++++------- 1 file changed, 29 insertions(+), 7 deletions(-) diff --git a/scripts/README.md b/scripts/README.md index 7816f40..72f2ed8 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -17,9 +17,14 @@ Utility scripts for agent installation and project management. Run this **once** on your new VPS: ```bash -bash <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh) +source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh) ``` +**Why use `source`?** +- Uses `source` instead of `bash` so PATH updates immediately in your current shell +- `init-project` and other commands are available right away +- No need to manually run `source ~/.bashrc` afterward + **Output:** ``` ✨ Homelab agents bootstrap complete! @@ -33,11 +38,12 @@ bash <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/sc ## init-project -**Purpose:** Quickly initialize new VPS projects with automatic Gitea remote configuration. +**Purpose:** Quickly initialize new VPS projects with automatic Gitea remote configuration and agent setup. **Problem it solves:** - No more manual git setup - No more being asked for repository URL +- Agents automatically copied to project - Consistent project initialization across all VPS instances - Remote is ready before any work starts @@ -47,6 +53,8 @@ bash <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/sc 3. Sets up git user config 4. **Automatically configures Gitea remote** (no prompts!) 5. Creates initial main branch +6. **Copies agents to `.claude/agents/`** for Claude Code +7. Provides clear next steps **Usage:** @@ -61,25 +69,29 @@ init-project my-new-app 📁 Creating project directory: my-new-app 🔧 Initializing git repository... 🔗 Configuring Gitea remote... +📚 Setting up Claude Code agents... +✅ Copied 2 agent(s) to .claude/agents/ ✅ Project initialized successfully! 📋 Project Details: Name: my-new-app - Directory: /root/projects/my-new-app + Directory: /home/pdm/projects/my-new-app Remote: http://100.120.125.113:3000/pdm/my-new-app.git Branch: main + Agents: .claude/agents/ 🚀 Next steps: 1. Start working in this directory 2. Create files and make changes - 3. When done, use the summary agent + 3. When done, use the summary agent: .claude/agents/sysadmin-session-closer.md 4. Agent will automatically commit and push to Gitea ``` **What happens next:** - Work normally in your project directory - Git remote is already configured +- Agents are locally available in `.claude/agents/` - When you use the summary agent, it knows exactly where to push - No more "What's the Gitea remote URL?" prompts! @@ -91,6 +103,16 @@ Each project gets its own independent Gitea repository: Projects on the same VPS are separate and independent. +**Agent Location:** + +Agents are available at: +``` +.claude/agents/sysadmin-session-closer.md +.claude/agents/[other-agents].md +``` + +Claude Code will automatically find them here. + **Installation:** `init-project` is automatically installed by bootstrap-agents.sh to: @@ -106,7 +128,7 @@ It's added to your PATH, so you can run it from anywhere. ### First Time on a VPS ```bash -bash <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh) +source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh) ``` ### For Each New Project @@ -118,9 +140,9 @@ cd my-app ``` ### Closing a Session -Use the summary agent: +Use the summary agent at: ``` -~/.homelab-agents/agents/sysadmin-session-closer.md +.claude/agents/sysadmin-session-closer.md ``` The agent will: