llm-cli-council 1.0.0

package/skills/setup.md

@@ -0,0 +1,164 @@
+---
+name: llm-cli-council:setup
+description: Detect and configure available LLM CLIs for the council
+invocable: true
+---
+
+# LLM CLI Council Setup
+
+This command detects available LLM CLI tools and configures the council.
+
+## Execution Steps
+
+### Step 1: Detect Available CLIs
+
+Run detection for each provider in parallel:
+
+```bash
+# Claude
+which claude && claude --version 2>/dev/null || echo "not-found"
+
+# Copilot
+which copilot && copilot --version 2>/dev/null || echo "not-found"
+
+# Codex
+which codex && codex --version 2>/dev/null || echo "not-found"
+
+# Gemini
+which gemini && gemini --version 2>/dev/null || echo "not-found"
+
+# Ollama
+which ollama && ollama list 2>/dev/null || echo "not-found"
+```
+
+### Step 2: Build Configuration
+
+For each detected CLI, record:
+- `available`: boolean - whether CLI is found
+- `path`: string - full path to CLI
+- `version`: string - version if detectable
+- `authenticated`: boolean - whether auth check passed
+
+### Step 3: Write Configuration
+
+Before writing config, initialize path variables:
+
+```bash
+# Source platform utilities
+source "${CLAUDE_PLUGIN_ROOT}/lib/platform-utils.sh"
+
+# Path resolution
+COUNCIL_CONFIG_DIR="${CLAUDE_COUNCIL_CONFIG_DIR:-${CLAUDE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/claude}/council}"
+COUNCIL_CONFIG_FILE="${CLAUDE_COUNCIL_CONFIG_FILE:-$COUNCIL_CONFIG_DIR/config.json}"
+COUNCIL_LOG_DIR="${CLAUDE_COUNCIL_LOG_DIR:-$COUNCIL_CONFIG_DIR/logs}"
+
+# Ensure directories exist
+ensure_dir "$COUNCIL_CONFIG_DIR"
+ensure_dir "$COUNCIL_LOG_DIR"
+```
+
+Write results to `$COUNCIL_CONFIG_FILE`:
+
+```json
+{
+  "version": "1.0.0",
+  "lastSetup": "<ISO timestamp>",
+  "providers": {
+    "claude": {
+      "available": true,
+      "path": "/path/to/claude",
+      "version": "x.y.z",
+      "authenticated": true
+    }
+    // ... other providers
+  },
+  "defaultMode": "quick",
+  "availableCount": 5
+}
+```
+
+### Step 4: Display Status Table
+
+Present results in a clear table format:
+
+```
+LLM CLI COUNCIL - SETUP COMPLETE
+═══════════════════════════════════════════════════════
+
+Provider     Status      Path                  Version
+─────────────────────────────────────────────────────────
+Claude       READY       /usr/local/bin/claude 1.0.0
+Copilot      READY       /usr/local/bin/copilot 2.1.0
+Codex        READY       /usr/local/bin/codex  1.5.0
+Gemini       READY       /usr/local/bin/gemini 0.8.0
+Ollama       READY       /usr/local/bin/ollama 0.1.30
+
+═══════════════════════════════════════════════════════
+Total: 5/5 providers available
+
+Council Modes Available:
+• quick   - 2 providers (fast feedback)
+• full    - 5 providers (comprehensive)
+• privacy - Ollama only (local execution)
+
+Configuration saved to: $COUNCIL_CONFIG_FILE
+Run /llm-cli-council:status to view current configuration.
+```
+
+### Step 5: Install Global Rules
+
+For proactive delegation checking to work, copy the plugin rules to Claude's global rules directory:
+
+```bash
+# Define target directory
+RULES_TARGET_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/rules/delegator"
+
+# Create directory if needed
+ensure_dir "$RULES_TARGET_DIR"
+
+# Copy rules from plugin to global location
+cp -r "${CLAUDE_PLUGIN_ROOT}/rules/"* "$RULES_TARGET_DIR/"
+
+# Confirm installation
+echo "✓ Global delegation rules installed to: $RULES_TARGET_DIR"
+```
+
+This enables Claude to automatically check for delegation triggers on every message without needing to invoke a skill.
+
+**What gets installed:**
+- `orchestration.md` - Multi-LLM coordination rules
+- `triggers.md` - When to delegate automatically
+- `delegation-format.md` - How to format delegation prompts
+- `model-selection.md` - Which expert for which task
+
+### Step 6: Handle Missing Providers
+
+If a provider is not found or not authenticated:
+
+```
+Provider     Status      Issue                 Fix
+─────────────────────────────────────────────────────────
+Gemini       NOT FOUND   CLI not installed     brew install gemini-cli
+Copilot      AUTH ERROR  Not logged in         copilot auth login
+```
+
+## Error Handling
+
+- **No providers found**: Display error with installation instructions for each CLI
+- **Only 1 provider**: Warn that council requires minimum 2 for quorum, but setup can continue
+- **Auth failures**: Log warning but mark provider as available (may work for some commands)
+
+## Post-Setup
+
+After successful setup:
+1. Council configuration is stored persistently
+2. Global delegation rules are active (proactive behavior)
+3. Commands can auto-detect mode based on available providers
+4. Run `/llm-cli-council:review-plan` to test the council
+
+## Re-running Setup
+
+Running setup again will:
+1. Re-detect all providers (catches new installations)
+2. Update configuration with current status
+3. Preserve any custom settings from previous config

package/skills/status.md

@@ -0,0 +1,220 @@
+---
+name: llm-cli-council:status
+description: Show council configuration and provider availability status
+invocable: true
+---
+
+# LLM CLI Council - Status
+
+This command displays the current council configuration and checks provider availability.
+
+## Usage
+
+```
+/llm-cli-council:status [--check]
+```
+
+### Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `--check` | Re-check provider availability (live test) |
+
+---
+
+## Execution Flow
+
+### Step 1: Load Configuration
+
+Read `$COUNCIL_CONFIG_FILE`.
+
+If not found:
+```
+Council not configured.
+Run /llm-cli-council:setup to detect and configure providers.
+```
+
+### Step 2: Display Status
+
+```
+LLM CLI COUNCIL STATUS
+═══════════════════════════════════════════════════════
+
+Configuration: $COUNCIL_CONFIG_FILE
+Last Setup: 2024-01-15T10:30:00Z
+Version: 1.0.0
+
+PROVIDERS
+─────────────────────────────────────────────────────────
+Provider     Status      Version    Last Used
+─────────────────────────────────────────────────────────
+Claude       READY       1.0.5      2024-01-15
+Copilot      READY       2.1.0      2024-01-14
+Codex        READY       1.5.2      2024-01-15
+Gemini       READY       0.8.1      2024-01-10
+Ollama       READY       0.1.30     2024-01-12
+
+Total: 5/5 providers available
+
+MODES AVAILABLE
+─────────────────────────────────────────────────────────
+• quick   - 2 providers (Claude, Codex for plans; Codex, Copilot for code)
+• full    - 5 providers (all available)
+• privacy - 1 provider (Ollama only)
+
+PREFERENCES
+─────────────────────────────────────────────────────────
+Default Mode: quick
+Auto-Suggest: enabled
+Privacy Required For: api, secret, password
+
+═══════════════════════════════════════════════════════
+```
+
+### Step 3: Live Check (if --check)
+
+When `--check` is specified, actively test each provider:
+
+```bash
+# Test each provider with simple prompt
+claude --version
+copilot --version
+codex --version
+gemini --version
+ollama list
+```
+
+Display results:
+
+```
+LIVE CHECK RESULTS
+─────────────────────────────────────────────────────────
+Provider     Check           Result
+─────────────────────────────────────────────────────────
+Claude       Version         OK (1.0.5)
+Copilot      Version         OK (2.1.0)
+Codex        Version         OK (1.5.2)
+Gemini       Version         FAIL (auth required)
+Ollama       Model List      OK (3 models available)
+
+Issues Found:
+• Gemini: Authentication required
+  Fix: gemini auth login
+
+Would you like to re-run setup? [y/N]
+```
+
+---
+
+## Status Indicators
+
+| Status | Meaning |
+|--------|---------|
+| READY | Provider available and authenticated |
+| AUTH ERROR | CLI found but authentication failed |
+| NOT FOUND | CLI not installed |
+| TIMEOUT | CLI found but not responding |
+| UNKNOWN | Unable to determine status |
+
+---
+
+## Troubleshooting Output
+
+When issues detected:
+
+```
+TROUBLESHOOTING
+─────────────────────────────────────────────────────────
+
+Provider Issues:
+
+1. Gemini - AUTH ERROR
+   The Gemini CLI requires authentication.
+   Fix: Run `gemini auth login`
+
+2. Ollama - NO MODELS
+   Ollama is installed but no models are available.
+   Fix: Run `ollama pull gpt-oss:20b`
+
+Quick Fixes:
+• Re-run setup: /llm-cli-council:setup
+• Check individual CLI: which <cli-name>
+• Manual auth: <cli-name> auth login
+```
+
+---
+
+## Configuration Details
+
+### Show Full Config (if requested)
+
+```
+FULL CONFIGURATION
+─────────────────────────────────────────────────────────
+
+providers:
+  claude:
+    available: true
+    path: /usr/local/bin/claude
+    version: x.y.z
+    authenticated: true
+    invocation: claude -p --print "{prompt}"
+
+  codex:
+    available: true
+    path: /usr/local/bin/codex
+    version: x.y.z
+    authenticated: true
+    invocation: codex exec "{prompt}"
+
+  # ... etc
+
+taskRouting:
+  plan-review:
+    preferred: [claude, codex]
+    fallback: [gemini]
+
+  code-review:
+    preferred: [codex, copilot]
+    fallback: [claude]
+
+defaults:
+  mode: quick
+  minQuorum: 2
+  timeoutMs: 120000
+```
+
+---
+
+## Output Formats
+
+### Default (Human-readable)
+
+Formatted table with colors (if terminal supports).
+
+### JSON (--json flag)
+
+```json
+{
+  "configured": true,
+  "configPath": "$COUNCIL_CONFIG_FILE",
+  "lastSetup": "2024-01-15T10:30:00Z",
+  "providers": {
+    "claude": {"available": true, "version": "x.y.z"},
+    "codex": {"available": true, "version": "x.y.z"}
+  },
+  "availableCount": 5,
+  "modes": ["quick", "full", "privacy"]
+}
+```
+
+---
+
+## Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Config not found | Run `/llm-cli-council:setup` |
+| All providers unavailable | Check CLI installations, network |
+| Auth errors | Run auth command for specific CLI |
+| Privacy mode unavailable | Install Ollama: `brew install ollama` |

package/skills/uninstall.md

@@ -0,0 +1,179 @@
+---
+name: llm-cli-council:uninstall
+description: Remove council configuration and optionally the skill files
+invocable: true
+---
+
+# LLM CLI Council - Uninstall
+
+This command removes the council configuration and provides options for complete cleanup.
+
+## Usage
+
+```
+/llm-cli-council:uninstall [--full]
+```
+
+### Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `--full` | Also remove skill files (complete uninstall) |
+
+---
+
+## Execution Flow
+
+### Step 1: Confirm Uninstall
+
+```
+LLM CLI Council Uninstall
+═══════════════════════════════════════════════════════
+
+This will remove:
+• Configuration: $COUNCIL_CONFIG_FILE
+• Logs (if any): $COUNCIL_LOG_DIR
+• Global delegation rules: ~/.claude/rules/delegator/
+
+The plugin files will remain (use 'claude /plugin uninstall' to remove).
+
+Proceed with uninstall? [y/N]
+```
+
+### Step 2: Remove Configuration
+
+```bash
+rm -f $COUNCIL_CONFIG_FILE
+rm -rf $COUNCIL_LOG_DIR
+```
+
+### Step 3: Remove Global Rules
+
+Remove the delegation rules from Claude's global rules directory:
+
+```bash
+# Define rules directory
+RULES_TARGET_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/rules/delegator"
+
+# Remove rules if they exist
+if [ -d "$RULES_TARGET_DIR" ]; then
+  rm -rf "$RULES_TARGET_DIR"
+  echo "✓ Removed global delegation rules from: $RULES_TARGET_DIR"
+else
+  echo "• No global rules found (already removed or never installed)"
+fi
+```
+
+This removes the proactive delegation checking behavior. After uninstall, Claude will no longer automatically check for delegation triggers.
+
+### Step 4: Full Uninstall (if --full)
+
+```
+Full uninstall requested.
+
+Note: For plugin-based installations, use:
+  claude /plugin uninstall llm-cli-council
+
+This command only removes configuration and rules, not the plugin itself.
+```
+
+### Step 5: Confirm Completion
+
+```
+LLM CLI Council - Uninstalled
+═══════════════════════════════════════════════════════
+
+Removed:
+✓ Configuration file
+✓ Log directory
+✓ Global delegation rules
+
+The plugin files remain installed. To completely remove:
+  claude /plugin uninstall llm-cli-council
+
+The underlying CLI tools (claude, codex, copilot, etc.)
+were NOT modified. They remain available for direct use.
+
+To reinstall:
+  /llm-cli-council:setup
+```
+
+---
+
+## What Gets Removed
+
+### Standard Uninstall
+
+| Item | Path | Description |
+|------|------|-------------|
+| Config | `$COUNCIL_CONFIG_FILE` | Provider settings, preferences |
+| Logs | `$COUNCIL_LOG_DIR` | Review history (if logging enabled) |
+| Rules | `~/.claude/rules/delegator/` | Global delegation rules |
+
+**Note:** Plugin files remain. Use `claude /plugin uninstall llm-cli-council` to remove.
+
+---
+
+## What Is NOT Removed
+
+The uninstall does NOT affect:
+
+- Individual CLI tools (claude, codex, copilot, gemini, ollama)
+- CLI authentication/credentials
+- Other Claude Code skills
+- Global Claude Code configuration
+
+---
+
+## Re-installation
+
+After uninstalling, to reinstall:
+
+### If skill files remain (standard uninstall):
+```
+/llm-cli-council:setup
+```
+
+### If skill files removed (--full uninstall):
+1. Re-download/copy skill files to `$SKILLS_DIR/llm-cli-council/`
+2. Run `/llm-cli-council:setup`
+
+---
+
+## Error Handling
+
+### Config Not Found
+```
+No council configuration found.
+Nothing to uninstall.
+
+If you want to remove skill files:
+  rm -rf $SKILLS_DIR/llm-cli-council/
+```
+
+### Permission Error
+```
+Error: Permission denied removing configuration.
+Manual cleanup required:
+  rm $COUNCIL_CONFIG_FILE
+  rm -rf $COUNCIL_LOG_DIR
+```
+
+---
+
+## Dry Run
+
+To see what would be removed without actually removing:
+
+```
+/llm-cli-council:uninstall --dry-run
+
+Would remove:
+• $COUNCIL_CONFIG_FILE (exists, 2.1KB)
+• $COUNCIL_LOG_DIR (exists, 15 files)
+
+Add --full to also remove:
+• $SKILLS_DIR/llm-cli-council/ (exists, 12 files)
+
+No changes made (dry run).
+```