From e9cc23685ddd1f622a97f1feae1d2b7ee7cb1547 Mon Sep 17 00:00:00 2001 From: rob Date: Sat, 1 Nov 2025 16:18:06 -0300 Subject: [PATCH] docs: align claude setup references --- automation/README.md | 24 ++++++++++++++++++++---- config/ai.yml | 2 +- docs/AUTOMATION.md | 4 ++-- 3 files changed, 23 insertions(+), 7 deletions(-) diff --git a/automation/README.md b/automation/README.md index 0f25126..3278aeb 100644 --- a/automation/README.md +++ b/automation/README.md @@ -167,10 +167,26 @@ cat config/ai.yml # Try environment variable override CDEV_AI_COMMAND="claude -p '{prompt}'" git commit -m "test" -# Other provider notes -# codex-cli --stdin --model gpt-4.1-mini (requires OPENAI_API_KEY) -# gemini-cli --model=gemini-1.5-pro --stdin (requires GEMINI_API_KEY or GOOGLE_API_KEY) -# customize claude with --model or --agent to select a saved persona +# Setup Claude custom agents (recommended, one-time) +./tools/setup_claude_agents.sh + +# Other provider authentication (one-time setup): +# Claude: Run 'claude' and follow authentication prompts +# OpenAI: Run 'codex' and sign in with ChatGPT account +# Gemini: Run 'gemini' and sign in with Google account (free tier available) +``` + +**Speed Optimization:** +The config uses fast models by default (Claude Haiku via custom subagent, GPT-5, Gemini 2.5 Flash). For complex changes, you can temporarily use quality models: +```bash +# One-time quality override with Claude Sonnet subagent +CDEV_AI_COMMAND="claude -p" git commit -m "complex refactor" # Uses ~/.claude/agents/cdev-patch-quality.md + +# Or use OpenAI's full GPT-5 with deeper reasoning +CDEV_AI_COMMAND="codex --model gpt-5" git commit -m "complex refactor" + +# Or use Gemini 2.5 Pro for 1M context window +CDEV_AI_COMMAND="gemini --model gemini-2.5-pro" git commit -m "complex refactor" ``` ### Votes Not Updating diff --git a/config/ai.yml b/config/ai.yml index 3b8f403..920d9f6 100644 --- a/config/ai.yml +++ b/config/ai.yml @@ -17,7 +17,7 @@ version: 1 runner: command_chain: # Anthropic Claude CLI with custom subagent (fast Haiku model) - # Create ~/.claude/agents/cdev-patch.md once with: ./tools/setup-claude-agents.sh + # Create ~/.claude/agents/cdev-patch.md once with: ./tools/setup_claude_agents.sh - "claude -p" # OpenAI Codex CLI with GPT-5 (default model, good balance) # Authenticate once with: codex (follow prompts to sign in) diff --git a/docs/AUTOMATION.md b/docs/AUTOMATION.md index 2c39e29..2221663 100644 --- a/docs/AUTOMATION.md +++ b/docs/AUTOMATION.md @@ -97,14 +97,14 @@ Common non-interactive setups: | Provider | CLI Tool | Command Example | Authentication | Notes | | --- | --- | --- | --- | --- | -| Claude | `claude` | `claude -p` | Run `claude` and follow prompts to sign in | Supports custom subagents in `~/.claude/agents/`. Create with `./tools/setup-claude-agents.sh`. Uses Haiku (fast) or Sonnet (quality). | +| Claude | `claude` | `claude -p` | Run `claude` and follow prompts to sign in | Supports custom subagents in `~/.claude/agents/`. Create with `./tools/setup_claude_agents.sh`. Uses Haiku (fast) or Sonnet (quality). | | OpenAI | `codex` | `codex --model gpt-5` | Run `codex` and sign in with ChatGPT account | Codex CLI is OpenAI's terminal coding agent. Default model: GPT-5. Use `gpt-5-mini` for faster, cheaper responses. | | Google | `gemini` | `gemini --model gemini-2.5-flash` | Run `gemini` and sign in with Google account | Free tier: 60 req/min. Use `gemini-2.5-flash` (fast) or `gemini-2.5-pro` (1M context, quality). Open source (Apache 2.0). | **Recommended Setup:** Use the provided setup script to create Claude subagents: ```bash # One-time setup (creates ~/.claude/agents/cdev-patch.md and cdev-patch-quality.md) -./tools/setup-claude-agents.sh +./tools/setup_claude_agents.sh ``` This creates two subagent files: