claude-code-setup

Claude Code Setup

Manage your claude-code-setup installation: check status, upgrade, install, and remove modules.

Goal: Any scenario completes in 2 permission prompts (1 discover + 1 execute).

Phase 1: Discovery (1 Bash call)

Clone repo and run setup-status.sh in a single Bash call:

temp=$(mktemp -d /tmp/claude-setup-XXXXXX) && \
git clone --depth 1 https://github.com/b33eep/claude-code-setup.git "$temp" 2>/dev/null && \
"$temp/lib/setup-status.sh"

The script reads installed.json and templates/VERSION, compares modules, and outputs JSON.

Parse the JSON output. Handle errors:

• Bash call fails (no network, git clone fails):

  Unable to reach GitHub.
  
  Manual upgrade:
    cd /path/to/claude-code-setup
    git pull
    ./install.sh --update
  

  Stop here.

• JSON has "error": "not_installed" (no installed.json):

  claude-code-setup is not installed. Run install.sh first.
  

  Clean up: rm -rf "$temp" → Stop.

• Success: Parse JSON fields. The temp_dir field contains the repo path. Continue to Phase 2.

JSON structure reference

{
  "temp_dir": "/tmp/claude-setup-XXXXXX",
  "base": { "installed": 50, "available": 52, "update_available": true },
  "custom": { "configured": true, "installed": 1, "available": 2, "update_available": true, "commands": ["catchup.md"], "scripts": ["helper.sh"] },
  "new_modules": { "skills": ["name"], "mcp": ["name"], "plugins": ["id@marketplace"] },
  "installed_modules": { "skills": ["name"], "mcp": ["name"], "plugins": ["id@marketplace"] },
  "agent_teams": { "enabled": true }
}

Phase 2: Present + Ask (0 Bash calls)

Show status

Present a summary from the JSON:

claude-code-setup status:
- Base: v{base.installed} installed, v{base.available} available
- Custom: v{custom.installed} installed, v{custom.available} available
- Custom commands: {custom.commands} (only if non-empty)
- Custom scripts: {custom.scripts} (only if non-empty)
- Agent Teams: enabled / not configured

Modules available to install:
  Skills: {new_modules.skills}
  MCP Servers: {new_modules.mcp}
  External Plugins: {new_modules.plugins}