# Commands

Slash commands for quick actions. User-invoked (type `/command` to trigger).

## Available Commands

### Top-Level

| Command | Aliases | Description |
|---------|---------|-------------|
| `/pa` | `/assistant`, `/ask` | Personal assistant entrypoint |
| `/help` | `/commands`, `/skills` | Show available commands and skills |
| `/status` | `/overview`, `/dashboard` | Quick status across all domains |
| `/summarize` | `/save-session` | Summarize and save session to memory |
| `/remember` | `/save`, `/note` | Quick save to memory |
| `/config` | `/settings`, `/prefs` | View/manage configuration |
| `/search` | `/find`, `/lookup` | Search memory, history, config |
| `/log` | `/logs`, `/logview` | View and analyze logs |
| `/debug` | `/diag`, `/diagnose` | Debug and troubleshoot config |
| `/export` | `/session-export`, `/share` | Export session for sharing |
| `/mcp-status` | `/mcp`, `/integrations` | Check MCP integrations |
| `/workflow` | `/workflows`, `/wf` | List and describe workflows |
| `/skill-info` | `/skill`, `/skills-info` | Show skill information |
| `/agent-info` | `/agent`, `/agents` | Show agent information |
| `/diff` | `/config-diff`, `/compare` | Compare config with backup |
| `/template` | `/templates`, `/session-template` | Manage session templates |
| `/maintain` | `/maintenance`, `/admin` | Configuration maintenance |
| `/programmer` | | Code development tasks |
| `/gcal` | `/calendar`, `/cal` | Google Calendar access |
| `/usage` | `/stats` | View usage statistics |
| `/external` | `/llm`, `/ext` | Toggle and use external LLM mode |

### Kubernetes (`/k8s:*`)

| Command | Description |
|---------|-------------|
| `/k8s:cluster-status` | Quick cluster health overview |
| `/k8s:deploy` | Deploy applications to cluster |
| `/k8s:diagnose` | Diagnose Kubernetes issues |

### System Admin (`/sysadmin:*`)

| Command | Description |
|---------|-------------|
| `/sysadmin:health` | System health check |
| `/sysadmin:update` | System package updates |
| `/sysadmin:autonomy` | Set autonomy level for session |

## Command Format

```yaml
---
name: command-name
description: What this command does
aliases: [alias1, alias2]
invokes: skill:skill-name    # or workflow: or agent:
---

# Command Title

Instructions for Claude when command is invoked.
```

## Command vs Skill

| Aspect | Command | Skill |
|--------|---------|-------|
| **Invocation** | User types `/command` | Claude decides automatically |
| **Discovery** | Explicit | Based on description matching |
| **Use case** | Quick actions, shortcuts | Domain expertise, workflows |

## Directory Structure

```
commands/
├── README.md
├── pa.md
├── gcal.md
├── usage.md
├── programmer.md
├── k8s/
│   ├── cluster-status.md
│   ├── deploy.md
│   └── diagnose.md
└── sysadmin/
    ├── health.md
    ├── update.md
    └── autonomy.md
```

Namespaced commands use subdirectories (e.g., `k8s/deploy.md` → `/k8s:deploy`).

## Adding Commands

1. Create `commands/name.md` (or `commands/namespace/name.md`)
2. Add YAML frontmatter with name, description, invokes
3. Write instructions in Markdown body
4. Update `component-registry.json` if needed for routing