diff --git a/.ccw/workflows/cli-tools-usage.md b/.ccw/workflows/cli-tools-usage.md index fbe4651f..2741edc8 100644 --- a/.ccw/workflows/cli-tools-usage.md +++ b/.ccw/workflows/cli-tools-usage.md @@ -1,601 +1,203 @@ # CLI Tools Execution Specification -## Table of Contents -1. [Configuration Reference](#configuration-reference) -2. [Tool Selection](#tool-selection) -3. [Prompt Template](#prompt-template) -4. [CLI Execution](#cli-execution) -5. [Auto-Invoke Triggers](#auto-invoke-triggers) -6. [Best Practices](#best-practices) +Unified reference for `ccw cli` — runs agent tools (gemini, qwen, codex, claude, opencode) with a shared interface for prompt, mode, model, directory, templates, and session resume. + +**References**: `~/.claude/cli-tools.json` (tool config), `~/.ccw/templates/cli/` (protocol + prompt templates) --- -## Configuration Reference +## 1. Quick Reference -### Configuration File +### Command Syntax -**Path**: `~/.claude/cli-tools.json` +```bash +ccw cli -p "" [options] +``` -All tool availability, model selection, and routing are defined in this configuration file. +### Options -### Configuration Fields +| Option | Description | Default | +|--------|-------------|---------| +| `-p, --prompt` | **Required**. Prompt text | — | +| `--tool ` | Tool: gemini, qwen, codex, claude, opencode | First enabled in config | +| `--mode ` | `analysis` (read-only), `write` (create/modify/delete), `review` (codex-only) | `analysis` | +| `--model ` | Model override | Tool's `primaryModel` | +| `--cd ` | Working directory | Current directory | +| `--includeDirs ` | Additional directories (comma-separated) | — | +| `--rule