1# Create a CLI Codex can use | Codex use cases1# Create a CLI Codex can use | Codex use cases
2 2
3Codex use cases
4
5
6
7
8
9Codex use case
10
11# Create a CLI Codex can use
12
13Give Codex a composable command for an API, log source, export, or team script.
14
15Difficulty **Intermediate**
16
17Time horizon **1h**
18
19Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts, use to download files, and remember through a companion skill.
20
21## Best for
22
23- Repeated work where Codex needs to search, read, download from, or safely write to the same service, export, local archive, or repo script.
24- Agent tools that need paged search, exact reads by ID, predictable JSON, downloaded files, local indexes, or draft-before-write commands.
25
26# Contents
27
3[← All use cases](https://developers.openai.com/codex/use-cases)28[← All use cases](https://developers.openai.com/codex/use-cases)
4 29
30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/agent-friendly-clis/?export=pdf)
31
5Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts, use to download files, and remember through a companion skill.32Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts, use to download files, and remember through a companion skill.
6 33
7Intermediate34Intermediate
26 53
27 Create the companion skill that teaches later Codex tasks which CLI commands to run first and which write actions require approval.54 Create the companion skill that teaches later Codex tasks which CLI commands to run first and which write actions require approval.
28 55
56| Skill | Why use it |
57| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
58| [Cli Creator](https://github.com/openai/skills/tree/main/skills/.curated/cli-creator) | Design the command surface, build the CLI, add setup and auth checks, install the command on PATH, and verify it from another folder. |
59| [Skill Creator](https://github.com/openai/skills/tree/main/skills/.system/skill-creator) | Create the companion skill that teaches later Codex tasks which CLI commands to run first and which write actions require approval. |
60
29## Starter prompt61## Starter prompt
30 62
31Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same thread.63Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same thread.
35 Command name: [cli-name, or recommend one].67 Command name: [cli-name, or recommend one].
36Before coding, show me the proposed command surface and ask only for missing details that would block the build.68Before coding, show me the proposed command surface and ask only for missing details that would block the build.
37 69
70[Open in the Codex app](codex://new?prompt=Use+%24cli-creator+to+create+a+CLI+you+can+use%2C+and+use+%24skill-creator+to+create+the+companion+skill+in+this+same+thread.%0A%0ASource+to+learn+from%3A+%5Bdocs+URL%2C+OpenAPI+spec%2C+redacted+curl+command%2C+existing+script+path%2C+log+folder%2C+CSV+or+JSON+export%2C+SQLite+database+path%2C+or+pasted+--help+output%5D.%0A%0AFirst+job+the+CLI+should+support%3A+%5Bdownload+failed+CI+logs+from+a+build+URL%2C+search+support+tickets+and+read+one+by+ID%2C+query+an+admin+API%2C+read+a+local+database%2C+or+run+one+step+from+an+existing+script%5D.%0A%0AOptional+write+job%3A+%5Bcreate+a+draft+comment%2C+upload+media%2C+retry+a+failed+job%2C+or+read-only+for+now%5D.%0A%0ACommand+name%3A+%5Bcli-name%2C+or+recommend+one%5D.%0A%0ABefore+coding%2C+show+me+the+proposed+command+surface+and+ask+only+for+missing+details+that+would+block+the+build. "Open in the Codex app")
71
72Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same thread.
73Source to learn from: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output].
74First job the CLI should support: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script].
75Optional write job: [create a draft comment, upload media, retry a failed job, or read-only for now].
76 Command name: [cli-name, or recommend one].
77Before coding, show me the proposed command surface and ask only for missing details that would block the build.
78
38## Introduction79## Introduction
39 80
40When Codex keeps using the same API, log source, exported inbox, local database, or team script, give that work a composable interface: a command it can run from any folder, inspect, narrow, and combine with `git`, `gh`, `rg`, tests, and repo scripts.81When Codex keeps using the same API, log source, exported inbox, local database, or team script, give that work a composable interface: a command it can run from any folder, inspect, narrow, and combine with `git`, `gh`, `rg`, tests, and repo scripts.
115 156
116Use Codex to turn a game brief into first a well-defined plan, and then a real browser-based...157Use Codex to turn a game brief into first a well-defined plan, and then a real browser-based...
117 158
118159Engineering Code](https://developers.openai.com/codex/use-cases/browser-games)[Engineering Code](https://developers.openai.com/codex/use-cases/browser-games)[
119 160
120161### Save workflows as skills### Deploy an app or website
121 162
122163Turn a working Codex thread, review rules, test commands, release checklists, design...Use Codex with Build Web Apps and Vercel to turn a repo, screenshot, design, or rough app...
123 164
124165Engineering Workflow](https://developers.openai.com/codex/use-cases/reusable-codex-skills)[Front-end Integrations](https://developers.openai.com/codex/use-cases/deploy-app-or-website)[
125 166
126167### Upgrade your API integration### Refactor your codebase
127 168
128169Use Codex to update your existing OpenAI API integration to the latest recommended models...Use Codex to remove dead code, untangle large files, collapse duplicated logic, and...
129 170
130171Evaluation Engineering](https://developers.openai.com/codex/use-cases/api-integration-migrations)Engineering Code](https://developers.openai.com/codex/use-cases/refactor-your-codebase)