codex-cli

OpenAI Codex CLI reference. Use when running codex in interactive_shell overlay or when user asks about codex CLI options.

Jump to install

Repository: nicobailon/pi-interactive-shell
Last source activity: April 23, 2026 at 19:17
Detected SKILL.md language: English
Stars: 563
Forks: 50

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/nicobailon/pi-interactive-shell --skill codex-cli

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

pi-interactive-shell

Cheat sheet + workflow for launching interactive coding-agent CLIs (Claude Code, Gemini CLI, Codex CLI, Cursor CLI, and pi itself) via the interactive_shell overlay, headless dispatch, or monitor mode. Use for TUI agents and long-running processes that need supervision, fire-and-forget delegation, or event-driven background monitoring. Regular bash commands should use the bash tool instead.

2026-08-08

cursor-cli

Cursor CLI reference. Use when running Cursor in interactive_shell overlay or when user asks about Cursor CLI options.

2026-04-23

codex-5-3-prompting

How to write system prompts and instructions for GPT-5.3-Codex. Use when constructing or tuning prompts targeting Codex 5.3.

2026-03-13

View all from this repository

codex "Generate a clean app icon for a fitness tracker, flat design, 512x512"
codex "Create a hero banner for a SaaS landing page showing a dashboard with dark mode"
codex -i screenshot.png "Edit this screenshot to make the button green and add a tooltip"

codex 'Make a pixel-art sprite sheet for a platformer game $imagegen'
codex 'Generate a logo for my coffee shop $imagegen'

Image editing / iteration: Attach a reference image (screenshot, wireframe, mockup) to your prompt. Codex handles multimodal input natively.
```
codex -i wireframe.png "Turn this wireframe into a polished UI mockup"
codex -i design.png "Generate code for this design"
```
Usage & limits: Images count against your regular Codex usage quota and consume it 3-5x faster than text-only turns (depending on size/quality).
Heavy/batch work: For production pipelines, set OPENAI_API_KEY in your shell and tell Codex to call the OpenAI Images API directly. It will then use gpt-image-2 with full API pricing and options.
No config needed: Image generation is enabled by default. Older experimental flags like codex features enable image_generation are no longer required.

// Delegated run with completion notification (recommended default)
interactive_shell({
  command: 'codex "Review this codebase for security issues"',
  mode: "dispatch"
})

// Override reasoning effort for a single delegated run
interactive_shell({
  command: 'codex -c model_reasoning_effort="xhigh" "Complex refactor task"',
  mode: "dispatch"
})

// Headless - use bash instead
bash({ command: 'codex exec "summarize the repo"' })

Command	Description
`codex`	Start interactive TUI
`codex "prompt"`	TUI with initial prompt
`codex exec "prompt"`	Non-interactive (headless), streams to stdout. Supports `--output-schema <file>` for structured JSON output
`codex e "prompt"`	Shorthand for exec
`codex login`	Authenticate (OAuth, device auth, or API key)
`codex login status`	Show auth mode
`codex logout`	Remove credentials
`codex mcp`	Manage MCP servers
`codex completion`	Generate shell completions

Flag	Description
`-m, --model <model>`	Switch model (prefer `gpt-5.5`)
`-c <key=value>`	Override config.toml values (dotted paths, parsed as TOML)
`-p, --profile <name>`	Use config profile from config.toml

Command	Description
`codex`	Start interactive TUI
`codex "prompt"`	TUI with initial prompt
`codex exec "prompt"`	Non-interactive (headless), streams to stdout. Supports `--output-schema <file>` for structured JSON output
`codex e "prompt"`	Shorthand for exec
`codex login`	Authenticate (OAuth, device auth, or API key)
`codex login status`	Show auth mode
`codex logout`	Remove credentials
`codex mcp`	Manage MCP servers
`codex completion`	Generate shell completions

Flag	Description
`-m, --model <model>`	Switch model (prefer `gpt-5.5`)
`-c <key=value>`	Override config.toml values (dotted paths, parsed as TOML)
`-p, --profile <name>`	Use config profile from config.toml

codex-cli

Install options

Review the source files

Codex CLI (OpenAI)

Commands

Key Flags

Codex CLI (OpenAI)

Commands

Key Flags

Sandbox Modes

Features

Image Generation (gpt-image-2)

How to Invoke

Natural Language (Recommended)

Explicit Skill Invocation

Tips

Config

In interactive_shell

name	codex-cli
description	OpenAI Codex CLI reference. Use when running codex in interactive_shell overlay or when user asks about codex CLI options.

codex-cli

Source facts

Install options

Review the source files

More from this repository

More from this repository

Codex CLI (OpenAI)

Commands

Key Flags

Codex CLI (OpenAI)

Commands

Key Flags

Sandbox Modes

Features

Image Generation (gpt-image-2)

How to Invoke

Natural Language (Recommended)

Explicit Skill Invocation

Tips

Config

In interactive_shell