Merge pull request #1 from stefanc-ai2/simplify

refactor(cli): rebrand to cq with ccb aliases

Author: stefanc-ai2

.github/workflows/cross-platform-test.yml

@@ -56,7 +56,9 @@ jobs:
 
       - name: Test unified commands syntax
         run: |
-          chmod +x bin/ask bin/ping
+          chmod +x cq bin/ask bin/ping bin/cq-mounted
+          python cq --help
           python bin/ask --help
           python bin/ping --help
+          python bin/cq-mounted --help
           echo "✅ Unified commands syntax test passed"

.github/workflows/test.yml

@@ -29,7 +29,7 @@ jobs:
           python -m pip install pytest
 
       - name: Syntax check
-        run: python -m compileall -q lib bin ccb
+        run: python -m compileall -q lib bin cq
 
       - name: Run tests
         run: pytest test/ -v --tb=short

.gitignore

@@ -6,7 +6,7 @@ __pycache__/
 docs/
 !docs/**/*.md
 tests/
-.ccb_config/
+.cq_config/
 .codex-session
 .gemini-session
 .claude-session

AGENTS.md

@@ -2,19 +2,19 @@
 
 ## Project Structure & Module Organization
 
-- `ccb`: primary CLI entrypoint (launcher/orchestrator).
+- `cq`: primary CLI entrypoint (launcher/orchestrator).
 - `lib/`: Python implementation (terminal backends, protocol markers, config/session utilities).
-- `bin/`: small CLI tools and wrappers (e.g. `ask`, `ping`, `ccb-mounted`).
+- `bin/`: small CLI tools and wrappers (e.g. `ask`, `ping`, `cq-mounted`).
 - `test/`: `pytest` suite (+ a few `test/system_*.sh` scripts).
 - `claude_skills/`, `codex_skills/`: provider skill bundles installed by `install.sh`.
 
 ## Build, Test, and Development Commands
 
-- `python -m compileall -q lib bin ccb`: fast syntax/type-syntax sanity check (matches CI).
+- `python -m compileall -q lib bin cq`: fast syntax/type-syntax sanity check (matches CI).
 - `python -m pip install -U pip pytest`: install test runner.
 - `python -m pytest test/ -v --tb=short`: run the full test suite locally.
 - `./install.sh install` / `./install.sh uninstall`: install or remove local commands (see env vars in `install.sh` header).
-- `./ccb -h`: run the launcher from the repo checkout (no install required).
+- `./cq -h`: run the launcher from the repo checkout (no install required).
 
 ## Coding Style & Naming Conventions
 
@@ -43,8 +43,8 @@
 
 ## Security & Configuration Tips
 
-- Don’t commit local session/config artifacts under `.ccb_config/` or provider runtime/session files.
-- Prefer configuration via `ccb.config` (`.ccb_config/ccb.config` or `~/.ccb/ccb.config`) and environment variables; avoid hardcoding paths or secrets.
+- Don’t commit local session/config artifacts under `.cq_config/` or provider runtime/session files.
+- Prefer configuration via `cq.config` (`.cq_config/cq.config` or `~/.cq/cq.config`) and environment variables; avoid hardcoding paths or secrets.
 
 ## Beads (Issue Tracking)
 

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code when working with code in this reposi
 
 ## Project Overview
 
-Claude Code Bridge (`ccb`) is a split-pane collaboration tool for **Claude** and **Codex**.
+Code Quorum (`cq`) is a split-pane collaboration tool for **Claude** and **Codex**.
 
 Current design constraints:
 - Providers: `claude`, `codex` only
@@ -19,7 +19,7 @@ Current design constraints:
 
 ```bash
 # Syntax check
-python -m compileall -q lib bin ccb test
+python -m compileall -q lib bin cq test
 
 # Run all tests
 python -m pytest test/ -v --tb=short
@@ -32,21 +32,21 @@ TERM=xterm-256color python -m pytest test/ -v --tb=short
 
 ### Entry points
 
-- `ccb`: launcher/orchestrator (starts panes, writes `.ccb_config/.{provider}-session`)
+- `cq`: launcher/orchestrator (starts panes, writes `.cq_config/.{provider}-session`)
 - `bin/ask`: send-only message delivery into a provider pane (async; prints req_id)
 - `bin/ping`: provider connectivity check
-- `bin/ccb-mounted`: report mounted providers for the current directory
+- `bin/cq-mounted`: report mounted providers for the current directory
 
 ### Key modules
 
 - `lib/terminal.py`: terminal backend abstraction (`TmuxBackend`, `WeztermBackend`)
 - `lib/*_session.py`: loads per-project session bindings and ensures pane liveness
-- `lib/ccb_protocol.py`: protocol markers (`CCB_REQ_ID`, `CCB_REPLY`, `CCB_FROM`) + wrapping helpers
+- `lib/cq_protocol.py`: protocol markers (`CQ_REQ_ID`, `CQ_REPLY`, `CQ_FROM`) + wrapping helpers
 - `lib/project_id.py`, `lib/session_utils.py`, `lib/session_registry.py`: project isolation and session lookup
 
 ### Session isolation
 
-Session resolution is scoped to the current project via `.ccb_config/`.
+Session resolution is scoped to the current project via `.cq_config/`.
 This enables running multiple repositories (repo A and repo B) without cross-talk.
 
 ## Beads (Issue Tracking)

README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# Claude Code Bridge (`ccb`)
+# Code Quorum (`cq`)
 
 Split-pane collaboration between **Claude** and **Codex** using **tmux** or **WezTerm**.
 
@@ -16,7 +16,7 @@ Split-pane collaboration between **Claude** and **Codex** using **tmux** or **We
 
 ## What it does
 
-- `ccb` starts **Claude** and/or **Codex** in separate panes and writes per-project session files under `.ccb_config/`.
+- `cq` starts **Claude** and/or **Codex** in separate panes and writes per-project session files under `.cq_config/`.
 - `ask` sends a message directly to the target pane (send-only, always async).
 - Replies come back **in the pane** via `ask --reply-to ...` (bidirectional “reply-via-ask”).
 
@@ -28,7 +28,7 @@ No log tailing/monitoring is required or used.
 
 - Python **3.10+**
 - Either:
-  - tmux (run `tmux` first, then run `ccb` inside tmux), or
+  - tmux (run `tmux` first, then run `cq` inside tmux), or
   - WezTerm (recommended)
 - The `claude` CLI and the `codex` CLI installed and on `PATH`
 
@@ -43,8 +43,8 @@ From a repo checkout:
 ```
 
 This installs:
-- executables into `~/.local/bin` (or `$CODEX_BIN_DIR`)
-- project files into `~/.local/share/codex-dual` (or `$CODEX_INSTALL_PREFIX`)
+- executables into `~/.local/bin` (or `$CQ_BIN_DIR`)
+- project files into `~/.local/share/code-quorum` (or `$CQ_INSTALL_PREFIX`)
 - skills into `~/.claude/skills` and `${CODEX_HOME:-~/.codex}/skills`
 
 Uninstall:
@@ -57,11 +57,11 @@ Uninstall:
 
 ## Quickstart
 
-From your project directory (must contain `.ccb_config/`):
+From your project directory (must contain `.cq_config/`):
 
 ```bash
-mkdir -p .ccb_config
-ccb codex,claude
+mkdir -p .cq_config
+cq codex,claude
 ```
 
 Send a message to a provider:
@@ -85,7 +85,7 @@ ask codex --reply-to <REQ_ID> --caller claude "Here are my notes..."
 ask claude --reply-to <REQ_ID> --caller codex "Here are my notes..."
 ```
 
-Tip: when you *expect* reply-via-ask, set a stable id with `--req-id`. `ask` includes a `CCB_REQ_ID: <id>` line at the top automatically so the recipient can copy it.
+Tip: when you *expect* reply-via-ask, set a stable id with `--req-id`. `ask` includes a `CQ_REQ_ID: <id>` line at the top automatically so the recipient can copy it.
 
 ```bash
 REQ_ID="$(python -c 'import secrets; print(secrets.token_hex(16))')"
@@ -98,9 +98,9 @@ EOF
 The reply is wrapped with protocol markers so the caller can identify it:
 
 ```
-CCB_REPLY: <REQ_ID>
-CCB_FROM: claude
-[CCB_RESULT] No reply required.
+CQ_REPLY: <REQ_ID>
+CQ_FROM: claude
+[CQ_RESULT] No reply required.
 
 ...message...
 ```
@@ -109,19 +109,19 @@ CCB_FROM: claude
 
 ## Session isolation (repo A vs repo B)
 
-By default, `ask` resolves sessions **only** for the current project via `.ccb_config/` and will not talk to sessions from a different repository.
+By default, `ask` resolves sessions **only** for the current project via `.cq_config/` and will not talk to sessions from a different repository.
 
 To check what is currently mounted:
 
 ```bash
-ccb-mounted --json
+cq-mounted --json
 ```
 
 ---
 
 ## Development
 
 ```bash
-python -m compileall -q lib bin ccb test
+python -m compileall -q lib bin cq test
 python -m pytest test/ -v --tb=short
 ```

bin/ask

@@ -47,7 +47,7 @@ from compat import read_stdin_text, setup_windows_encoding
 
 setup_windows_encoding()
 
-from ccb_protocol import make_req_id, wrap_reply_payload, wrap_request_prompt
+from cq_protocol import make_req_id, wrap_reply_payload, wrap_request_prompt
 from claude_session import load_project_session as load_claude_session
 from cli_output import EXIT_ERROR, EXIT_OK
 from codex_session import load_project_session as load_codex_session
@@ -61,10 +61,10 @@ def _env_bool(name: str, default: bool = False) -> bool:
 
 
 def _default_caller() -> str:
-    caller = (os.environ.get("CCB_CALLER") or "").strip()
+    caller = (os.environ.get("CQ_CALLER") or "").strip()
     if caller:
         return caller
-    if _env_bool("CCB_MANAGED", False):
+    if _env_bool("CQ_MANAGED", False):
         return "codex"
     if os.environ.get("CODEX_SESSION_ID") or os.environ.get("CODEX_RUNTIME_DIR"):
         return "codex"
@@ -75,7 +75,7 @@ def _resolve_req_id(override_req_id: str | None) -> str:
     explicit = (override_req_id or "").strip()
     if explicit:
         return explicit
-    env_req_id = (os.environ.get("CCB_REQ_ID") or "").strip()
+    env_req_id = (os.environ.get("CQ_REQ_ID") or "").strip()
     return env_req_id or make_req_id()
 
 
@@ -124,13 +124,13 @@ def main(argv: list[str]) -> int:
         "--req-id",
         dest="override_req_id",
         default=None,
-        help="Override the request id (default: CCB_REQ_ID env var, else auto-generated 32-hex).",
+        help="Override the request id (default: CQ_REQ_ID env var, else auto-generated 32-hex).",
     )
     parser.add_argument(
         "--caller",
         dest="caller",
         default=None,
-        help="Override the `CCB_FROM` value in reply payloads (only used with --reply-to).",
+        help="Override the `CQ_FROM` value in reply payloads (only used with --reply-to).",
     )
     parser.add_argument(
         "message",
@@ -184,7 +184,7 @@ def main(argv: list[str]) -> int:
             f"[ERROR] No active {provider} session found for this directory.",
             file=sys.stderr,
         )
-        print(f"[ERROR] Run `ccb {provider}` in this project first.", file=sys.stderr)
+        print(f"[ERROR] Run `cq {provider}` in this project first.", file=sys.stderr)
         return EXIT_ERROR
 
     ok, pane_or_err = session.ensure_pane()

bin/ccb-mounted bin/cq-mountedbin/ccb-mounted renamed to bin/cq-mounted

@@ -1,18 +1,18 @@
 #!/usr/bin/env python3
 """
-ccb-mounted - Check which CCB providers are mounted.
+cq-mounted - Check which Code Quorum providers are mounted.
 
 A provider is "mounted" if:
-1. Session file exists (.ccb_config/.{provider}-session or .{provider}-session) and is active
+1. Session file exists (.cq_config/.{provider}-session or .{provider}-session) and is active
 2. Pane is reachable/alive (best-effort) - OR socket access is blocked (sandbox mode)
 
 Usage:
-    ccb-mounted [CWD] [--json|--simple] [--include-inactive]
+    cq-mounted [CWD] [--json|--simple] [--include-inactive]
 
 Examples:
-    ccb-mounted
-    ccb-mounted --simple
-    ccb-mounted /path/to/project --json
+    cq-mounted
+    cq-mounted --simple
+    cq-mounted /path/to/project --json
 """
 
 import sys
@@ -34,7 +34,7 @@ PROVIDERS = ["codex", "claude"]
 def find_session_file_path(cwd: Path, provider: str) -> Path | None:
     """Return the provider session file path if present."""
     candidates = (
-        cwd / ".ccb_config" / f".{provider}-session",
+        cwd / ".cq_config" / f".{provider}-session",
         cwd / f".{provider}-session",
     )
     for p in candidates:
@@ -132,8 +132,8 @@ def can_connect_localhost() -> bool:
 
 def main():
     parser = argparse.ArgumentParser(
-        prog="ccb-mounted",
-        description="Check which CCB providers are mounted for a project directory.",
+        prog=Path(sys.argv[0]).name or "cq-mounted",
+        description="Check which Code Quorum providers are mounted for a project directory.",
     )
     parser.add_argument("cwd", nargs="?", default=".", help="Project directory (default: current working directory).")
     fmt_group = parser.add_mutually_exclusive_group()

bin/ping

@@ -62,7 +62,7 @@ def _load_session(provider: str, *, work_dir: Path, session_file: Path | None) -
         session = load_claude_session(work_dir)
 
     if not session:
-        return None, f"No active {provider} session found for this directory. Run `ccb {provider}` first."
+        return None, f"No active {provider} session found for this directory. Run `cq {provider}` first."
 
     if _is_inactive(getattr(session, "data", {})):
         return None, f"Session is inactive: {getattr(session, 'session_file', '')}"

claude_skills/all-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: all-plan
-description: Collaborative planning with mounted CLIs only. Automatically detects active providers via ccb-mounted.
+description: Collaborative planning with mounted CLIs only. Automatically detects active providers via cq-mounted.
 metadata:
   short-description: Collaborative planning with mounted CLIs
 ---
@@ -9,7 +9,7 @@ metadata:
 
 Collaborative planning involving only the mounted/active CLIs with iterative refinement.
 
-**IMPORTANT**: This skill automatically detects which providers are active by running `ccb-mounted`. It will only dispatch to providers that are actually mounted. For example, if you ran `ccb claude codex`, only Claude and Codex will participate in the planning.
+**IMPORTANT**: This skill automatically detects which providers are active by running `cq-mounted`. It will only dispatch to providers that are actually mounted. For example, if you ran `cq claude codex`, only Claude and Codex will participate in the planning.
 
 Note: After dispatching planning requests via `ask`, draft your own independent design, then end your turn to collect replies via reply-via-ask.