shoko/kugetsu
1
0
Fork 0
Code Issues 17 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

docs: add Phase 3a installation guide and update install script

Browse Source 
- docs/phase3a-setup.md - Complete installation guide for Phase 3a
- skills/kugetsu/scripts/kugetsu-install.sh - Updated to reflect v2.2 changes
This commit is contained in:
shokollm
2026-03-30 14:25:22 +00:00
parent 7c94a59bb6
commit 227ec3a22e
2 changed files with 183 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
skills/kugetsu/scripts/kugetsu-install.sh
View File

@@ -1,10 +1,13 @@
#!/bin/bash
# kugetsu installation script
# Installs kugetsu CLI and optionally sets up Phase 3a Chat Agent
set -euo pipefail
KUGETSU_DIR="${KUGETSU_DIR:-$HOME/.kugetsu}"
BIN_DIR="$KUGETSU_DIR/bin"
BIN_DIR="${BIN_DIR:-$HOME/.local/bin}"
echo "Installing kugetsu to $KUGETSU_DIR..."
echo "Installing kugetsu..."
mkdir -p "$BIN_DIR"
@@ -13,24 +16,21 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cp "$SCRIPT_DIR/kugetsu" "$BIN_DIR/kugetsu"
chmod +x "$BIN_DIR/kugetsu"
echo "kugetsu installed at: $BIN_DIR/kugetsu"
add_to_shell() {
local rc_file="$1"
local export_line="export PATH=\"\$HOME/.kugetsu/bin:\$PATH\""
local export_line="export PATH=\"\$HOME/.local/bin:\$PATH\""
if [ -f "$rc_file" ]; then
if grep -q "$export_line" "$rc_file" 2>/dev/null; then
echo "$rc_file already has kugetsu in PATH"
echo "$rc_file already has .local/bin in PATH"
else
echo "" >> "$rc_file"
echo "# kugetsu - opencode session manager" >> "$rc_file"
echo "# kugetsu and other tools" >> "$rc_file"
echo "$export_line" >> "$rc_file"
echo "Added to $rc_file"
fi
else
echo "" >> "$rc_file"
echo "# kugetsu - opencode session manager" >> "$rc_file"
echo "$export_line" >> "$rc_file"
echo "Created $rc_file with kugetsu PATH"
fi
}
@@ -39,29 +39,24 @@ add_to_shell "$HOME/.zshrc"
echo ""
echo "=== Verifying installation ==="
if [ ! -f "$BIN_DIR/kugetsu" ]; then
echo "ERROR: kugetsu was not installed correctly."
exit 1
fi
echo "kugetsu installed at: $BIN_DIR/kugetsu"
"$BIN_DIR/kugetsu" help | head -10
echo ""
echo "Installation complete!"
echo ""
echo "Run this to start using kugetsu immediately:"
echo " export PATH=\"\$HOME/.kugetsu/bin:\$PATH\""
echo "=== Phase 3a Chat Agent Setup (Optional) ==="
echo "To also install the Chat Agent skills for Phase 3a:"
echo ""
echo "Or start a new shell."
echo " 1. Link skills to Hermes:"
echo " mkdir -p ~/.hermes/skills/kugetsu-chat ~/.hermes/skills/kugetsu-pm ~/.hermes/skills/kugetsu-helpers"
echo " ln -sf /path/to/kugetsu/skills/kugetsu-chat ~/.hermes/skills/"
echo " ln -sf /path/to/kugetsu/skills/kugetsu-pm ~/.hermes/skills/"
echo " ln -sf /path/to/kugetsu/skills/kugetsu-helpers ~/.hermes/skills/"
echo ""
echo "Usage:"
echo " kugetsu init Initialize base session (requires TTY)"
echo " kugetsu start <issue-ref> <message> Start task for issue"
echo " kugetsu continue <issue-ref> [msg] Continue existing task"
echo " kugetsu list List all sessions"
echo " kugetsu prune [--force] Remove orphaned sessions"
echo " kugetsu destroy <issue-ref> [-y] Delete session for issue"
echo " kugetsu destroy --base [-y] Delete base session"
echo " kugetsu help Show help"
echo " 2. Install Chat Agent SOUL:"
echo " cp /path/to/kugetsu/skills/kugetsu-chat/SOUL.md ~/.hermes/SOUL-chat.md"
echo ""
echo "Issue ref format: instance/user/repo#number"
echo "Example: github.com/shoko/kugetsu#14"
echo " 3. Initialize kugetsu (requires TTY):"
echo " kugetsu init"
echo ""
echo "See docs/phase3a-setup.md for full installation guide."