Installation

uc-apx ships as a single static binary. No runtime, no package manager needed.

Prerequisites

• An Oracle APEX application exported in APEXlang format (requires APEX 26.1+)
• SQLcl 26.1.2+ — only needed for validate --official. Optional for everything else.

Download the Binary

Download the latest release for your platform from the GitHub releases page.

macOS (Apple Silicon)

curl -L https://github.com/United-Codes/uc-apx/releases/latest/download/uc-apx_darwin_arm64.tar.gz | tar xz
chmod +x uc-apx
sudo mv uc-apx /usr/local/bin/

macOS (Intel)

curl -L https://github.com/United-Codes/uc-apx/releases/latest/download/uc-apx_darwin_amd64.tar.gz | tar xz
chmod +x uc-apx
sudo mv uc-apx /usr/local/bin/

Linux (amd64)

curl -L https://github.com/United-Codes/uc-apx/releases/latest/download/uc-apx_linux_amd64.tar.gz | tar xz
chmod +x uc-apx
sudo mv uc-apx /usr/local/bin/

Linux (arm64)

curl -L https://github.com/United-Codes/uc-apx/releases/latest/download/uc-apx_linux_arm64.tar.gz | tar xz
chmod +x uc-apx
sudo mv uc-apx /usr/local/bin/

Windows

Download uc-apx_windows_amd64.zip from the releases page, extract it, and place uc-apx.exe somewhere on your PATH.

Verify Installation

uc-apx version

uc-apx v26.1
  Go:          go1.26.1
  mmdVersion:  26.1.x

Copyright United Codes (https://united-codes.com)
Developed by Philipp Hartenfeller (https://hartenfeller.dev)
GitHub: https://github.com/United-Codes/uc-apx

Point at an App

Every uc-apx command takes --app-dir to specify which exported APEX application to work with. The directory must contain .apex/apexlang.json and at least one .apx file.

uc-apx --app-dir /path/to/my-apex-app overview

Set a default app

If you always work in the same app directory, cd into it first — --app-dir defaults to .:

cd /path/to/my-apex-app
uc-apx overview
uc-apx pages

Next Steps

• Quickstart — run your first read commands
• APEXlang format — understand the .apx DSL
• Commands reference — full command and flag docs
• Support — community help and enterprise support options