Skip to content

Add completion spec: Codex (codex)#208

Closed
lucieleblanc wants to merge 1 commit into
mainfrom
oz-agent/APP-3520/command-spec-codex
Closed

Add completion spec: Codex (codex)#208
lucieleblanc wants to merge 1 commit into
mainfrom
oz-agent/APP-3520/command-spec-codex

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

Summary

Add command completion spec for OpenAI's Codex CLI (codex).

What's included

Global options: --model, --sandbox, --ask-for-approval, --config, --image, --cd, --search, --add-dir, --enable/--disable, --full-auto, --yolo, --oss, --profile, --no-alt-screen, --version, --help

Subcommands:

  • exec — non-interactive mode with its own options (--json, --output-schema, --color, --ephemeral, --skip-git-repo-check, --output-last-message) and nested exec resume
  • login / logout — authentication
  • completion — shell completion script generation (bash, zsh, fish, powershell)
  • resume / fork — session management
  • apply (alias: a) — apply Codex Cloud diffs
  • cloud (alias: cloud-tasks) — browse/execute cloud tasks, with nested cloud exec
  • features — feature flag management (list, enable, disable)
  • mcp — MCP server management (list, add, remove, authenticate)
  • mcp-server — run Codex as an MCP server
  • app / app-server — desktop app and server
  • execpolicy — evaluate exec policy rules
  • sandbox — run commands in sandboxes (macos/seatbelt, linux/landlock)
  • debug — debug utilities (app-server send-message-v2)

Argument completions:

  • Static suggestions for enum-like args (sandbox policies, approval modes, shell names, color modes, cloud exec attempts)
  • filepaths template for image/schema/output file arguments
  • folders template for directory arguments (--cd, --add-dir, app PATH)

No generators needed — all completions are static.

Validation

  • npm run format — passed (unchanged)
  • script/presubmit — all checks pass (prettier, cargo fmt, cargo clippy, cargo test: 21 tests passed)

Conversation: https://staging.warp.dev/conversation/095d0912-1c91-4770-ba0f-faea76e12ee8
Run: https://oz.staging.warp.dev/runs/019d473b-7316-7d90-85d9-bedbc9fbe669

This PR was generated with Oz.

Add command completion spec for OpenAI's Codex CLI, covering:
- Global options (--model, --sandbox, --config, --image, etc.)
- Subcommands: exec, login, logout, completion, resume, fork,
  apply, cloud, features, mcp, mcp-server, app, app-server,
  execpolicy, sandbox, debug
- Nested subcommands (exec resume, cloud exec, features
  enable/disable/list, mcp add/remove/list/authenticate,
  sandbox macos/linux, debug app-server send-message-v2)
- Static suggestions for enum-like arguments (sandbox policies,
  approval modes, shell names, color modes)
- File/folder templates for path arguments

Co-Authored-By: Oz <oz-agent@warp.dev>
@linear
Copy link
Copy Markdown

linear Bot commented Apr 1, 2026

@lucieleblanc
Copy link
Copy Markdown
Contributor Author

No generator screenshots. Closing and retrying once skills are loading correctly.

@lucieleblanc lucieleblanc deleted the oz-agent/APP-3520/command-spec-codex branch April 1, 2026 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants