Commands

Complete reference for all uc-apx commands. Use --app-dir to point at your exported APEX application.

Read

Command	Description
uc-apx overview	Show a high-level summary of the exported APEX application: application name, mmdVersion, page count, file count, and component counts grouped by kind.
uc-apx pages	List every page in the exported APEX application with its ID, name, alias, title, source file, and component count. Use —page-group or —ungrouped to restrict the listing to a single page group or to pages with no group.
uc-apx page-groups	List every page group defined in the application along with the pages assigned to each, plus an ‘ungrouped’ bucket for pages that belong to no group. A group defined with zero member pages is flagged with ‘empty’: true; a page that references a group not defined in page-groups.apx surfaces as a ‘phantom’: true group (a broken reference worth fixing).
uc-apx page	Show a specific page’s properties and its components (regions, items, buttons, processes, …). Accepts the page number, alias, or name. By default each component is listed as a summary with a descendant count; pass —detail for the full recursive property tree of every component.
uc-apx tree	Print a tree view of a page’s component hierarchy (kind + name only). Without arguments, shows the top-level structure of the entire app.
uc-apx search	Free-text search across names, IDs, SQL, and PL/SQL — with kind filtering and grouped summaries
uc-apx lov	Show a LOV’s definition and entries plus a count of where it is used. By default the usage sites (usedBy) are omitted; pass —detail to include them.
uc-apx refs	Find every component in the app that references the given ID via an @-reference. Useful for understanding what uses a shared LOV, list, breadcrumb, or authorization scheme.
uc-apx component	Show any component — LOV, region, authorization scheme, breadcrumb, list, or any other kind — by its ID or name. By default it shows the component’s own properties plus its immediate children as summaries (with a descendant count); pass —detail for the full recursive property tree. When an ID matches multiple nodes across kinds, a note is printed to stderr. Use —kind to disambiguate.
uc-apx list	List all components of a specific kind (e.g., authorization, breadcrumb, list, lov, appItem). Use ‘uc-apx list’ without arguments to see all available kinds and their counts. The —page-group / —ungrouped filters apply only to ‘list page’.
uc-apx deps	Show what a component depends on (upstream) and what depends on it (downstream), traversing @-references transitively. Use —depth to limit traversal. When an ID is ambiguous, use —kind to target a specific component type.
uc-apx auth schemes	List authorization schemes with their usage
uc-apx auth usage	List every construct that carries an authorizationScheme
uc-apx auth audit	Report unused schemes and unprotected pages
uc-apx schema	Database objects (tables, views, packages, …) the app uses, extracted statically from its SQL/PL-SQL
uc-apx shape	Observed properties for a component kind (no flags), or an APEXlang reference template (—type / —list-types)

Utility

Command	Description
uc-apx validate	Structural checks (local) and full MMD-schema validation (—official via SQLcl)
uc-apx version	Print uc-apx version, Go version, and supported mmdVersion
uc-apx slots	Resolves the page’s appearance.pageTemplate and returns the per-template slot allowlist (from cmd/template_slots.go) plus the slots actually in use on the page. LLM agents picking a --slot for create region <kind> should call this first; the local validator’s invalidSlot check uses the same data.
uc-apx template	Bare per-template slot lookup. Pass the template ref without the leading @ (so /standard, /login, etc.). Without an argument, lists every template on uc-apx’s allowlist.

Skills

Command	Description
uc-apx skills sync	Download and install uc-apx skills for your coding agent
uc-apx skills list	List available skills from the public repo, or show already-installed skills

Create

Command	Description
uc-apx create page	Create a new apexlang page of the given —type. Writes to pages/pNNNNN-<slug>.apx by default.
uc-apx create app	Create a new APEXlang application directory pre-populated with a minimal
uc-apx create region	Insert a new region into an existing page’s .apx file.
uc-apx create region form	Insert a new form region into the target page. The region is bound to
uc-apx create region classic-report	Insert a new classic-report region backed by an inline SQL query.
uc-apx create region interactive-report	Insert a new interactiveReport region backed by an inline SQL query.
uc-apx create region interactive-grid	Insert a new interactiveGrid region. Source can be a local-database
uc-apx create region cards	Insert a new cards region. Source can be a local-database table
uc-apx create region chart	Insert a new chart region with one or more SQL-backed series.
uc-apx create region faceted-search	Insert a paired facetedSearch + classicReport region into the target page.
uc-apx create region static-content	Insert a new static-content region into the target page. The region’s
uc-apx create region avatar	Insert a themeTemplateComponent/avatar region backed by an inline SQL
uc-apx create region comments	Insert a themeTemplateComponent/comments region backed by an inline
uc-apx create region content-row	Insert a themeTemplateComponent/contentRow region backed by an inline
uc-apx create region timeline	Insert a themeTemplateComponent/timeline region backed by an inline
uc-apx create region metric-card	Insert a themeTemplateComponent/metricCard region backed by an inline
uc-apx create region media-list	Insert a themeTemplateComponent/mediaList region backed by an inline
uc-apx create region flexbox-container	Insert a themeTemplateComponent/flexboxContainer region — a layout-only
uc-apx create button	Insert a new button into a page’s existing region.
uc-apx create branch	Splice an anonymous branch construct into the page. The branch jumps
uc-apx create page-item	Insert a new pageItem (input field) into a page’s existing region.
uc-apx create page-group	Append a fresh top-level pageGroup &lt;id&gt; ( name: &lt;Display&gt; ) construct to
uc-apx create process	Insert a new process into a page. Today the only supported kind is
uc-apx create process plsql	Splice a process ... type: executeCode source &#123; plsqlCode: ... &#125;
uc-apx create process execute-code	Splice a process ... type: executeCode source &#123; plsqlCode: ... &#125;
uc-apx create process close-dialog	Splice a process ... type: closeDialog into a page. Used on modal
uc-apx create process clear-session-state	Splice a process ... type: clearSessionState into a page. Typically
uc-apx create validation	Splice a validation construct into a page. The --type flag picks
uc-apx create computation	Splice a computation into a page. The computation writes a value into
uc-apx create dynamic-action	Insert a new dynamicAction into a page.
uc-apx create dynamic-action refresh-on-dialog-close	Splice a dynamicAction ... when &#123; event: apexafterclosedialog &#125;
uc-apx create dynamic-action toggle	Splice a dynamicAction that pairs native-hide + native-show actions
uc-apx create dynamic-action run-js	Splice a dynamicAction with a single executeJsCode action.
uc-apx create dynamic-action set-value	Splice a dynamicAction with a single setValue action (static source).
uc-apx create dynamic-action execute-plsql	Splice a dynamicAction with a single executeServerSideCode action.
uc-apx create lov	Append a fresh top-level lov construct to
uc-apx create list	Append a fresh top-level list construct to
uc-apx create list-entry	Insert a new entry child into an existing list construct.
uc-apx create breadcrumb	Append a fresh top-level breadcrumb construct to
uc-apx create breadcrumb-entry	Insert a new entry child into an existing breadcrumb construct.
uc-apx create authorization	Append a fresh top-level authorization construct to
uc-apx create link-column	Rewrite an existing classic-report or interactive-report column from

Edit

Command	Description
uc-apx edit column	Edit an existing column <NAME> ( ... ) inside an interactiveGrid,
uc-apx edit page-item	Edit an existing pageItem <ID> ( ... ) on a page. Common rewrites:
uc-apx edit region	Edit an existing region <ID> ( ... ) on a page without
uc-apx edit authorization	Rewrite an existing top-level authorization scheme without rescaffolding it.
uc-apx edit page	Edit a page construct in place. Supports two independent edits (one per invocation):

Delete

Command	Description
uc-apx delete page	Delete the .apx file backing the named page. The ref-safety scan covers
uc-apx delete region	Delete a region construct (and all of its nested children: items, columns,
uc-apx delete page-item	Delete a pageItem construct from the named page’s .apx file. The lookup
uc-apx delete button	Delete a button construct from the named page’s .apx file. Blocks when
uc-apx delete column	Delete a column <id> ( ... ) child of an interactiveGrid, classicReport,
uc-apx delete branch	Remove a branch from a page
uc-apx delete process	Remove a process from a page
uc-apx delete validation	Remove a validation from a page
uc-apx delete computation	Remove a computation from a page
uc-apx delete dynamic-action	Remove a dynamicAction from a page
uc-apx delete lov	Delete a top-level lov construct from shared-components/lovs.apx.
uc-apx delete list	Delete a top-level list construct from shared-components/lists.apx.
uc-apx delete list-entry	Delete an entry child of a list. If the app has exactly one list,
uc-apx delete breadcrumb	Delete a top-level breadcrumb construct from
uc-apx delete breadcrumb-entry	Delete an entry child of a breadcrumb. If the app has exactly one
uc-apx delete authorization	Delete a top-level authorization construct from
uc-apx delete page-group	Delete a top-level pageGroup construct from page-groups.apx.