Skip to main content
subagent CX Codex

cli-developer · voltagent/awesome-codex-subagents — Codex subagent for CLI and arguments

cli-developer — a Codex subagent that treats CLI development as workflow engineering, not checklist ticking. Maps the friction, finds the root cause, and proposes the smallest safe fix—from argument parsing to error messages.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/cli-developer.toml
Open on GitHub

What cli-developer does

cli-developer analyzes workflow boundaries and failure points before making changes. It handles command ergonomics, flag and environment-variable precedence, error quality and exit codes, backward compatibility with existing scripts. Validates behavior on valid inputs, error cases, and edges; confirms help and examples stay accurate, output remains automation-friendly.

It focuses on command naming consistency, help text clarity, performance of frequent operations, and shell integration (completion, escaping, stdin/stdout contracts). Won't redesign the whole CLI surface for a local issue—proposes the smallest coherent intervention and flags residual risks.

Returns exact workflow or tool boundary analyzed, primary friction or failure source with supporting evidence, smallest safe change and key tradeoffs, validations already done and remaining environment-level checks, residual risk and prioritized follow-up actions.

What it helps with

  • improve command ergonomics or pinpoint workflow friction
  • straighten out argument parsing and flag precedence
  • rewrite error messages so operators know what to do next
  • verify CLI compatibility with existing scripts and automation
  • boost shell integration and command responsiveness

Example prompts for the agent

  • Fix the bash script that fails on quoted strings in arguments
  • Explain why deploy --env doesn't respect .env file priority and how to handle it safely
  • Review help text and check that examples match the current command signature

How to install cli-developer

Manually: put the files in place

.codex/agents/cli-developer.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about cli-developer

How do I install cli-developer in Codex?

Add the file .codex/agents/cli-developer.toml to your project. Codex will load the configuration on the next run.

What does cli-developer do?

It maps the workflow, finds the failure point in your CLI, separates root causes from symptoms, and proposes the smallest safe change. It tests valid inputs, error cases, and edges; confirms exit codes and output contracts stay automation-friendly.

When should I use cli-developer?

Use it to improve command UX, rework argument parsing, fix error messages, or check backward compatibility with existing scripts. It works locally on specific issues and flags remaining risks—it won't redesign your entire CLI.

Source text

cli-developer.toml · MIT
# cli-developer

Use when a task needs a command-line interface feature, UX review, argument parsing change, or shell-facing workflow improvement.

Own CLI development work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- command ergonomics and discoverability for real operator workflows
- argument parsing, defaults, and precedence across flags, config, and env vars
- error handling quality: actionable messages, exit codes, and safe failure behavior
- backward compatibility for existing scripts and automation consumers
- shell integration concerns (completion, quoting, escaping, and stdin/stdout contracts)
- performance and responsiveness for frequently used commands
- consistency of command naming, help text, and output schema

Quality checks:
- verify changed command behavior on valid, invalid, and edge-case inputs
- confirm exit codes and output contracts remain automation-friendly
- check help and examples stay accurate with changed options
- ensure compatibility impact on existing workflows is explicit
- call out platform or shell-specific validations still needed

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not redesign the entire CLI surface for a local command issue unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

cli-developer by other authors comes first.

cli-developer VoltAgent Community cli-developer designs command structures and terminal interfaces, with guidance on argument parsing, interactive prompts, and error handling. Use it when building CLI tools. CX Codex 312installs bash-script-generator akin-ozer bash-script-generator is a Claude Code skill that creates Bash and shell scripts, automation, and CLI tools. It activates for script-writing requests or when manual commands need to become a script. CX Codex +1 742installs shell-expert laurigates shell-expert is a Claude Code skill for writing Bash, zsh, and POSIX scripts and composing command-line automation. It activates for shell pipelines and portable scripting tasks. CX Codex +1 141installs shell-bash miles990 shell-bash is a Claude Code skill that provides Bash script patterns for parsing arguments, checking paths, and working with strings and arrays. Use these patterns to automate terminal tasks and write system scripts. CX Codex +1 112installs mcp-cli official github mcp-cli — a skill that teaches the agent to reach MCP servers from the shell: list servers, read tool schemas, run calls with JSON arguments. CX Codex +1 9,650installs tmux-cli pchalasani The tmux-cli skill lets an agent work with CLI agents and scripts in other tmux panes. Use it for shell commands, exit-code checks, and pane-to-pane communication. CX Codex +1 ★ 2,039repo stars dx-optimizer qdhenry dx-optimizer configures developer environments, project automation scripts, and Git hooks to eliminate workflow friction and speed up onboarding. CX Codex ★ 1,357repo stars

From the same set176

The whole set →
git-workflow-manager git-workflow-manager guides branching strategies, merge routines, and release flows. It recommends small, practical fixes rather than overhauling the repository setup. CX Codex ★ 6,505repo stars dx-optimizer The dx-optimizer subagent finds friction in setup, local workflows, and feedback loops. It recommends small changes and checks both normal and failing paths. CX Codex ★ 6,505repo stars documentation-engineer documentation-engineer — a subagent for technical documentation that stays faithful to actual code and operator workflows. Finds where docs drift from reality and fixes it with the smallest safe change. CX Codex ★ 6,505repo stars dependency-manager dependency-manager inspects package graphs, updates libraries safely, and audits third-party dependency risks in Codex projects. CX Codex ★ 6,505repo stars build-engineer build-engineer — a subagent for diagnosing build failures, dependency-graph issues, and CI pipeline instability. Maps the root cause, then recommends the smallest change that cuts friction without triggering full system migration. CX Codex ★ 6,505repo stars reinforcement-learning-engineer reinforcement-learning-engineer designs RL environments, crafts reward functions, and trains decision-making agents in Codex with safety checks across random seeds. CX Codex ★ 6,505repo stars prompt-engineer The prompt-engineer subagent treats prompts as behavior contracts, finds unclear instructions, and compares revisions against normal, edge, and failure scenarios. CX Codex ★ 6,505repo stars postgres-pro postgres-pro is a Codex subagent for PostgreSQL schemas, query plans, locking, and operational risks. It joins tasks that need workload-aware advice on database changes and migrations. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open