codex-sidecar

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Codex Sidecar

Codex Sidecar

Use the local
codex-sidecar
CLI to consult a persistent Codex thread as a side reviewer / design partner without leaving the current session.
使用本地
codex-sidecar
CLI即可咨询持久化Codex线程作为侧边评审员/设计伙伴,无需离开当前会话。

Workflow

工作流程

  1. Run
    codex-sidecar status
    .
  2. If the session is stopped, run
    codex-sidecar start
    .
  3. Send focused questions with
    codex-sidecar ask "<message>"
    .
  4. Use
    codex-sidecar reset
    when the user wants to drop the sidecar's prior context.
  5. Use
    codex-sidecar stop
    when the user wants to end the sidecar session and clear local state.
  1. 运行
    codex-sidecar status
  2. 如果会话已停止,运行
    codex-sidecar start
  3. 通过
    codex-sidecar ask "<message>"
    发送针对性问题。
  4. 当用户想要丢弃边车的历史上下文时,使用
    codex-sidecar reset
  5. 当用户想要结束边车会话并清除本地状态时,使用
    codex-sidecar stop

How to Ask

提问方式

  • Keep the current agent as the executor. Use the sidecar for second opinions, review, debugging hypotheses, or alternative designs.
  • Include the relevant task, constraints, and file paths in the
    ask
    message. Do not assume the sidecar can inspect your current unshared reasoning.
  • For code review, ask for concrete risks, likely regressions, and missing tests.
  • For design questions, ask for tradeoffs and a recommendation under the current constraints.
  • 保持当前Agent作为执行者。使用边车获取第二意见、评审结果、调试假设或替代设计方案。
  • ask
    消息中包含相关任务、约束条件和文件路径。不要假设边车能够查看你当前未共享的推理内容。
  • 代码评审场景下,可要求对方指出具体风险、潜在回归问题和缺失的测试用例。
  • 设计问题场景下,可要求对方提供当前约束下的权衡分析和方案建议。

Failure Handling

故障处理

  • If
    ask
    fails with a resume/state error, run
    codex-sidecar status
    first.
  • If the state file is corrupted or the thread cannot be resumed, run
    codex-sidecar reset
    .
  • If you need a hard cleanup, run
    codex-sidecar stop
    , then
    codex-sidecar start
    .
  • 如果
    ask
    调用因恢复/状态错误失败,优先运行
    codex-sidecar status
    排查。
  • 如果状态文件损坏或无法恢复线程,运行
    codex-sidecar reset
  • 如果需要彻底清理,先运行
    codex-sidecar stop
    ,再运行
    codex-sidecar start