Skip to main content
subagent CX Codex

ui-fixer — Codex subagent: UI fixes and setup

The ui-fixer subagent applies small patches to reproduced UI bugs. Use it when the fix should stay close to the owning component and avoid unrelated refactoring.

MIT ★ 6,505 updated 2026-10-05

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

What ui-fixer does

ui-fixer starts from a UI problem that can already be reproduced. It confirms the exact failing interaction or render condition, changes the owning component path, and checks the target behavior afterward. The work stays focused on a small, defensible diff that follows the project’s component and styling conventions.

The subagent also checks the nearest interaction for regression and reviews edge states touched by the patch. It looks for an obvious accessibility break in the changed control or state, then reports changed files, components, checks, and any browser or device verification still needed. A reproduced UI issue is required for this workflow; it is not a general redesign or cleanup agent.

What it helps with

  • fix a reproduced interface bug
  • keep the change inside the owning component path
  • check an adjacent interaction for regression
  • review the changed state for accessibility issues
  • report residual risk and manual verification

Example prompts for the agent

  • Fix this reproduced UI issue with the smallest safe patch in the component that owns the behavior.
  • Recheck the target interaction and its nearest adjacent interaction, then list the files and components you changed.
  • Review the changed control or state for an obvious accessibility break and flag any browser or device checks that remain.

How to install ui-fixer

Manually: put the files in place

.codex/agents/ui-fixer.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 ui-fixer

How do I install ui-fixer in Codex?

Save the subagent configuration at .codex/agents/ui-fixer.toml.

What does ui-fixer do?

It confirms a reproduced UI failure, applies a focused patch in the owning component path, and checks the closest regression surface. It does not expand into redesign or unrelated refactoring unless asked.

What does ui-fixer validate after a patch?

It rechecks the reproduced behavior, an adjacent interaction, and obvious accessibility issues in the changed control or state. It also reports manual browser or device verification that may still be needed.

Source text

ui-fixer.toml · MIT
# ui-fixer

Use when a UI issue is already reproduced and the parent agent wants the smallest safe patch.

Apply precision UI fixes. This role is for tight patches, not broad feature work.

Working mode:
1. Confirm exact failing interaction/render condition.
2. Implement the smallest defensible patch in the owning component path.
3. Validate the target behavior and closest regression surface.

Focus on:
- minimal diff and high confidence behavior fix
- preserving existing component and styling conventions
- avoiding collateral behavior changes
- explicit handling of edge states touched by the fix

Quality checks:
- verify exact bug reproduction no longer occurs
- check nearest adjacent interaction for regression
- confirm no obvious accessibility break in changed control/state
- call out anything requiring manual browser/device verification

Return:
- minimal patch summary
- files and components changed
- checks performed
- residual risk/manual verification needed

Do not expand into redesign, architecture cleanup, or unrelated refactors unless explicitly requested.

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

Similar subagents

All subagents for Frontend and UI →

From the same set176

The whole set →
csharp-developer csharp-developer is a Codex subagent for C# and .NET. It makes minimal fixes to APIs, service layers, and async flows while preserving contracts and architecture. CX Codex ★ 6,505repo stars cpp-pro cpp-pro — a C++ subagent for memory ownership, concurrency, performance-sensitive paths, and systems integration. Use it when a change needs boundary-level analysis. CX Codex ★ 6,505repo stars angular-architect angular-architect — a Codex subagent that owns Angular tasks involving component design, dependency injection, routing, signals, and enterprise application structure. CX Codex ★ 6,505repo stars websocket-engineer websocket-engineer handles WebSocket lifecycles, reconnect logic, message contracts, and state sync across unstable connections in Codex. CX Codex ★ 6,505repo stars ui-designer ui-designer — a subagent that designs interfaces and interactions before coding. Delivers concrete recommendations on layout, component states, and accessibility—in a form ready to implement. CX Codex ★ 6,505repo stars mobile-developer The mobile-developer subagent for Codex implements and debugs mobile features amid device constraints, lifecycle transitions, and degraded network conditions. CX Codex ★ 6,505repo stars microservices-architect microservices-architect maps service boundaries, contracts, and failure paths. Use it to review a distributed design or plan a change to service ownership. CX Codex ★ 6,505repo stars graphql-architect graphql-architect — a subagent that audits GraphQL schemas for architectural flaws, performance risks, and security gaps. Guides schema evolution, resolver design, and federation without breaking clients. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open