ai-tools

# AI Tools Management

Extensible AI CLI tools management with **delegation-first** design. Detects installed tools, reports versions, and retrieves update instructions from authoritative sources.

## Design Principles

1. **No hardcoded documentation** - Never duplicate docs that exist elsewhere
2. **Delegation-first** - Route to ecosystem skills/agents for authoritative guidance
3. **Graceful fallback** - Skill → MCP research → web search
4. **Extensible** - Easy to add new tools via tool-registry.md
5. **Smart detection** - Check what's installed, report versions

## Workflow

### Step 1: Detect Installed Tools

Check which AI CLI tools are installed on the system:

```bash
# Claude Code
which claude 2>/dev/null || where claude 2>/dev/null || echo "NOT_FOUND"
claude --version 2>/dev/null || echo "VERSION_UNKNOWN"

# Gemini CLI
which gemini 2>/dev/null || where gemini 2>/dev/null || echo "NOT_FOUND"
gemini --version 2>/dev/null || echo "VERSION_UNKNOWN"

# Codex CLI
which codex 2>/dev/null || where codex 2>/dev/null || echo "NOT_FOUND"
codex --version 2>/dev/null || echo "VERSION_UNKNOWN"
```

Report which tools are installed with their current versions.

### Step 2: Get Update Instructions (Delegation Pattern)

For each tool that needs updating, retrieve instructions from authoritative sources using the delegation chain:

#### Claude Code

**Primary**: Invoke `claude-ecosystem:docs-management` skill with query "Claude Code update install upgrade"

**Fallback 1**: If skill unavailable, spawn `claude-code-guide` agent:

```text
First WebFetch https://code.claude.com/docs/en/claude_code_docs_map.md to find
update/install documentation. Then WebFetch those pages. Return the update commands.
```

**Fallback 2**: If agent unavailable, use MCP:

```text
mcp__perplexity__search("Claude Code CLI update install latest version 2026")
```

**Fallback 3**: WebSearch for "Claude Code CLI update install"

#### Gemini CLI

**Primary**: Invoke `google-ecosystem:gemini-cli-docs` s