Skip to main content
subagent CX Codex

powershell-ui-architect · voltagent/awesome-codex-subagents — Codex subagent: purpose and setup

powershell-ui-architect is a Codex subagent for PowerShell interfaces in terminals, forms, WPF, and admin tools. It examines interactive workflows to locate friction and failures.

MIT ★ 6,505 updated 2026-10-05

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

What powershell-ui-architect does

The subagent maps a workflow, separates evidence-supported causes from symptoms, then suggests or implements a small, coherent change. Its focus includes event and state handling, input checks, background work through jobs and runspaces, error messages, and keeping automation logic separate from the UI.

It checks a normal path, invalid input, cancellation, and an integration edge. Privileged actions should have an explicit confirmation boundary. The report covers the failure source, supporting evidence, changes, tradeoffs, completed checks, and remaining environment-specific validation.

What it helps with

  • design an interactive PowerShell terminal or WPF interface
  • trace a failure in UI state or event handling
  • check invalid input and cancellation paths
  • investigate a UI freeze during background work
  • separate automation logic from interface code

Example prompts for the agent

  • Review this PowerShell admin interface and propose a small WPF change.
  • Check how this PowerShell form handles invalid input and cancellation.
  • Find why the background task freezes the interface and inspect its confirmation step for privileged actions.

How to install powershell-ui-architect

Manually: put the files in place

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

How do I install powershell-ui-architect in Codex?

Add the subagent file at .codex/agents/powershell-ui-architect.toml.

What does powershell-ui-architect do?

It examines PowerShell UI workflows, identifies likely failure causes, and proposes focused changes. It also checks normal, error, cancellation, and background-task behavior.

Which PowerShell interface types does powershell-ui-architect cover?

It covers interactive terminal interfaces, forms, and WPF, including admin-oriented tools.

Source text

powershell-ui-architect.toml · MIT
# powershell-ui-architect

Use when a task needs PowerShell-based UI work for terminals, forms, WPF, or admin-oriented interactive tooling.

Own PowerShell UI architecture 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:
- interactive flow design for terminal, forms, or WPF-based admin tooling
- state management and event handling correctness in interactive sessions
- input validation and safe execution boundaries for privileged operations
- responsiveness and long-running task handling (jobs/runspaces) in UI context
- error feedback clarity and operator recovery paths
- accessibility/keyboard usability in interactive controls where applicable
- maintainable separation between UI layer and automation logic

Quality checks:
- verify UI behavior for normal flow, invalid input, and cancellation paths
- confirm background/async task handling does not freeze interactive sessions
- check that privileged actions require explicit confirmation boundaries
- ensure UI output and logging support operational troubleshooting
- call out environment-specific validations needed on target host configurations

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 over-engineer full UI platform abstractions for a scoped interface issue unless explicitly requested by the parent agent.

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

Similar subagents

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

powershell-ui-architect by other authors comes first.

powershell-ui-architect VoltAgent Community powershell-ui-architect designs desktop graphical interfaces (WinForms, WPF, Metro) and terminal UIs for PowerShell tools while keeping business logic separate. CX Codex 218installs powershell-module-architect VoltAgent Community powershell-module-architect is a Claude Code subagent for designing and refactoring PowerShell modules. It handles profile systems, reusable libraries, and cross-version automation work. CX Codex 183installs 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 powershell-pester-6 official github powershell-pester-6 directs GitHub Copilot to follow Pester v6 testing patterns in PowerShell. Useful when writing test suites in *.Tests.ps1 without outdated v5 habits. CX Codex +1 ★ 41,430repo stars powershell-master JosiahSiegel powershell-master — a skill for PowerShell work: cmdlet syntax, PSGallery modules, CI/CD pipeline patterns and security. Useful whenever the agent writes a .ps1 or edits a pipeline. CX Codex +1 1,200installs analyzing-powershell-script-block-logging mahipal The analyzing-powershell-script-block-logging skill parses PowerShell Script Block Logging events from EVTX files and flags obfuscated commands, Base64 payloads and AMSI bypass attempts. CX Codex +1 313installs ms365-tenant-manager alirezarezvani ms365-tenant-manager — a skill for Microsoft 365 Global Administrators: tenant setup, user management, security policies, and PowerShell automation. CX Codex +1 ★ 907repo stars

From the same set176

The whole set →
tooling-engineer The tooling-engineer subagent works on internal tooling, scripts, automation glue, and workflow utilities. Use it when a developer workflow has a concrete failure or friction point. CX Codex ★ 6,505repo stars slack-expert slack-expert is a Codex subagent for Slack development, from bot behavior to event handling and workflows. It joins tasks that involve Slack interactions or platform-specific integration details. CX Codex ★ 6,505repo stars refactoring-specialist refactoring-specialist delivers low-risk structural refactoring that preserves existing runtime behavior while improving modularity. CX Codex ★ 6,505repo stars readme-generator The readme-generator subagent builds a README from the repository’s actual files and behavior. Use it to document setup, commands, and configuration without making up details. CX Codex ★ 6,505repo stars powershell-module-architect powershell-module-architect designs PowerShell module structures, refines cmdlet contracts, and handles packaging issues with minimal disruption. CX Codex ★ 6,505repo stars mcp-developer The mcp-developer subagent handles MCP servers, clients, tool wiring, and protocol-aware integrations. Use it when contract behavior and failure handling need a close review. CX Codex ★ 6,505repo stars legacy-modernizer legacy-modernizer helps plan upgrades to older code, frameworks, or architecture without breaking what works. Use when you need to move to newer technology but the stakes are high for deployment risk. CX Codex ★ 6,505repo stars 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

Project sponsors

Companies that keep this analytics open