From 172e5995747c31acce3da4ab395e5581d7130e65 Mon Sep 17 00:00:00 2001
From: Tam Nhu Tran <kaitran.ntt@gmail.com>
Date: Wed, 25 Feb 2026 15:54:22 +0700
Subject: [PATCH] docs(cli): document target defaults and ccsd cliproxy usage

- add multi-target help examples for ccsd codex and ccsd agy

- document per-profile target defaults for API and CLIProxy profiles

- include dashboard parity notes for target configuration
---
 README.md                    | 24 ++++++++++++++++++++++++
 src/commands/help-command.ts |  6 ++++++
 2 files changed, 30 insertions(+)

diff --git a/README.md b/README.md
index 9c173863..a51427c1 100644
--- a/README.md
+++ b/README.md
@@ -154,6 +154,30 @@ ccsd glm
 
 Need additional alias names? Set `CCS_DROID_ALIASES` as a comma-separated list (for example: `CCS_DROID_ALIASES=ccs-droid,mydroid`).
 
+### Per-Profile Target Defaults
+
+You can pin a default target (`claude` or `droid`) per profile:
+
+```bash
+# API profile defaults to Droid
+ccs api create myglm --preset glm --target droid
+
+# CLIProxy variant defaults to Droid
+ccs cliproxy create mycodex --provider codex --target droid
+```
+
+Built-in CLIProxy providers also work with Droid alias/target override:
+
+```bash
+ccsd codex
+ccsd agy
+ccs codex --target droid
+```
+
+Dashboard parity:
+- `ccs config` -> `API Profiles` -> set **Default Target**
+- `ccs config` -> `CLIProxy` -> create/edit variant -> set **Default Target**
+
 ### Kiro Auth Methods
 
 `ccs kiro --auth` defaults to AWS Builder ID Device OAuth (best support for AWS org accounts).
diff --git a/src/commands/help-command.ts b/src/commands/help-command.ts
index 1fdc3d63..38953277 100644
--- a/src/commands/help-command.ts
+++ b/src/commands/help-command.ts
@@ -326,6 +326,12 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
   printSubSection('Multi-Target', [
     ['ccs glm --target droid', 'Run GLM profile on Droid CLI'],
     ['ccsd glm', 'Same as above (alias)'],
+    ['ccsd codex', 'Run built-in CLIProxy Codex profile on Droid'],
+    ['ccsd agy', 'Run built-in CLIProxy Antigravity profile on Droid'],
+    [
+      'ccs cliproxy create my-codex --provider codex --target droid',
+      'Create CLIProxy variant with Droid as default target',
+    ],
     ['ccs glm', 'Run GLM profile on Claude Code (default)'],
   ]);