From 4fcd89c3d9994c4fb30b25e8c720a8d271c3667c Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sat, 3 Jan 2026 14:08:19 +0000 Subject: [PATCH] docs(faq): add stop/cancel task + Codex subscription auth sections - Added FAQ for /stop and other abort commands - Added FAQ explaining Codex CLI browser auth vs API key - Browser OAuth uses ChatGPT Pro subscription, API key is pay-per-token Co-authored-by: Clawd --- docs/faq.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/faq.md b/docs/faq.md index 4bd3e4cdb..52d44d74f 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -529,6 +529,41 @@ Use `/model` to switch without restarting: **Tip:** `/model` is processed at the gateway level — it works even if you're rate-limited (429) on the current model! +### How do I stop/cancel a running task? + +Send `/stop` to immediately abort the current agent run. Other stop words also work: +- `/stop` +- `/abort` +- `/esc` +- `/exit` + +For background processes (like Codex), use: +``` +process action:kill sessionId:XXX +``` + +You can also configure `routing.queue.mode` to control how new messages interact with running tasks: +- `steer` — New messages redirect the current task +- `interrupt` — Kills current run, starts fresh +- `collect` — Queues messages for after + +### Does Codex CLI use my ChatGPT Pro subscription or API credits? + +**Both are supported!** Codex CLI can auth via: + +1. **Browser OAuth** → Uses your ChatGPT Pro/Plus subscription (no per-token cost) + ```bash + codex auth + # Opens browser, log in with your ChatGPT account + ``` + +2. **API key** → Pay-per-token via OpenAI API billing + ```bash + export OPENAI_API_KEY="sk-..." + ``` + +If you have a ChatGPT subscription, use browser auth to avoid API charges! + ### How do rapid-fire messages work? Use `/queue` to control how messages sent in quick succession are handled: