Commands
All 56 make targets and 100 check scripts, with prerequisites, platform support and source locations.
Command entry points
Two execution surfaces: 56 Makefile targets (default check) and 100 check scripts under scripts/.
| Entry | Count | When to use |
|---|---|---|
make <target> | 56 | Daily development, packaging and gates; targets carry prerequisites and platform checks |
node scripts/verify-*.mjs | 100 | Single checks; the gate targets call these internally |
node scripts/*.mjs | 204 | Build, release and codegen scripts, not checks |
Read the prerequisites
Most targets have prerequisites (for example web-dev depends on profile-install). Running the dependency chain beats typing commands in order by hand.
Platform support
Desktop builds ship for macOS arm64 and Windows x64 only. Another 2 legacy Intel-Mac targets in the repo are outside the supported path, so they are absent from the list below.
| Platform | Architecture | Status |
|---|---|---|
macOS | arm64 | Supported, ships a .dmg |
Windows | x64 | Supported, ships an NSIS .exe |
macOS | Intel | Not supported; appears in neither the docs nor the release artifacts |
make targets
All 56 supported targets in definition order. An empty prerequisite list shows as —.
| Target | Prerequisites | Notes | Location |
|---|---|---|---|
make setup | — | Bootstrap: install deps, apply patches, build Host, install plugin | Makefile:43 |
make dev | — | Start the local development server | Makefile:53 |
make doctor | — | Check toolchain, Host revision, build outputs and installed plugin | Makefile:56 |
make cloud-identity | — | Verify cloud identity configuration | Makefile:62 |
make check | — | Default gate: lint, types and unit tests | Makefile:72 |
make dsh-pin-check | — | Check dsh-pin.json against the Host | Makefile:75 |
make client-module-gate | — | Client module boundary gate | Makefile:80 |
make client-build | — | Build the client bundle | Makefile:84 |
make test | — | Run unit tests | Makefile:87 |
make public-surface-audit | — | Audit the public surface and sensitive material | Makefile:90 |
make secret-scan | — | Scan for leaked credentials | Makefile:95 |
make public-gate | — | Aggregate public-boundary gate | Makefile:100 |
make ref-parity | — | Check ref parity between the tracked branches | Makefile:113 |
make pack | — | Pack the plugin tarball | Makefile:118 |
make release-check | public-gate | Pre-release check | Makefile:122 |
make runtime-source-stage | — | Stage runtime sources | Makefile:127 |
make patch-format-check | — | Check patch formatting | Makefile:131 |
make patch-manifest-check | — | Check the patch manifest | Makefile:135 |
make patch-source-check | — | Check patch sources | Makefile:141 |
make patch-source-verify | — | Verify patch source digests | Makefile:144 |
make patch-source-import | — | Import patch sources | Makefile:147 |
make patch-source-export | — | Export patch sources | Makefile:151 |
make verify-patched-host | — | Verify the patched Host | Makefile:155 |
make dsh-bootstrap | — | Fetch and build the DSH base | Makefile:162 |
make profile-install | pack | Install the plugin into the target profile | Makefile:176 |
make profile-check | — | Check profile state | Makefile:196 |
make patch-check | — | Check that patches apply | Makefile:203 |
make patch-apply | patch-check | Apply patches | Makefile:210 |
make verify-dsh | — | Verify the DSH base | Makefile:213 |
make verify-dsh-lifecycle | — | Verify the DSH lifecycle | Makefile:218 |
make verify-dsh-live-runtime | — | Verify DSH against a live runtime | Makefile:222 |
make verify-studio-plugin-lifecycle | — | Verify the plugin lifecycle | Makefile:227 |
make verify-studio-desktop-dev | — | Verify the desktop dev runtime | Makefile:231 |
make verify-desktop-update | — | Verify desktop update | Makefile:235 |
make verify-desktop-differential | — | Differentially verify desktop artifacts | Makefile:240 |
make verify-desktop-artifact | — | Verify the desktop installer | Makefile:244 |
make verify-dsh-sdk | — | Verify the DSH SDK contract | Makefile:248 |
make web-build | client-build | Build the web client | Makefile:254 |
make web-dev | profile-install | Build and start the web dev environment | Makefile:260 |
make web-start | web-dev | Start the built web client | Makefile:265 |
make desktop-build | client-build | Build desktop artifacts | Makefile:269 |
make desktop-dev | — | Build and start the desktop dev runtime | Makefile:275 |
make desktop-start | client-build | Start the built desktop runtime | Makefile:279 |
make desktop-package-preflight | pack | Desktop packaging preflight | Makefile:284 |
make desktop-package-mac-arm64 | desktop-package-preflight | Package the signed macOS arm64 installer | Makefile:291 |
make desktop-package-mac-arm64-unsigned | desktop-package-preflight | Package the unsigned macOS arm64 build | Makefile:296 |
make desktop-package-mac-arm64-dir | desktop-package-preflight | Package macOS arm64 as a directory | Makefile:300 |
make desktop-package-win-x64 | desktop-package-preflight | Package the Windows x64 installer | Makefile:313 |
make desktop-package-win-x64-unsigned | desktop-package-preflight | Package the unsigned Windows x64 build | Makefile:316 |
make desktop-check-package | — | Check the desktop installer | Makefile:319 |
make docs-site-build | — | Static-export the docs site | Makefile:326 |
make docs-site-dev | — | Start the docs site dev server | Makefile:330 |
make docs-site-check | — | Docs site gate: i18n, links and the generator | Makefile:333 |
make docs-site-preview | docs-site-build | Preview the exported docs site | Makefile:336 |
make ci | public-gate | The CI entry point | Makefile:341 |
make clean | — | Clean build artifacts and temp directories | Makefile:343 |
Check scripts
100 scripts/verify-*.mjs files (99 at the top level, 1 nested), grouped into 23 families by the second name segment. Each file's header comment states what it checks.
| Family | Size | Scripts | What it accepts |
|---|---|---|---|
studio | 39 | verify-studio-catalog-ui.mjs verify-studio-client-pages-ui.mjs verify-studio-client-state-ui.mjs verify-studio-desktop-dev.mjs verify-studio-dsh-a2a-controls.mjs verify-studio-frozen-host.mjs verify-studio-host-startup.mjs verify-studio-http-scope.mjs verify-studio-native-a2a-busy-cancel.mjs verify-studio-native-a2a-inbound.mjs verify-studio-native-a2a-recovery.mjs verify-studio-native-a2a.mjs verify-studio-native-background.mjs verify-studio-native-child-a2a-recovery.mjs verify-studio-native-child-write-recovery.mjs verify-studio-native-children-web.mjs verify-studio-native-children.mjs verify-studio-native-e2b.mjs verify-studio-native-harness.mjs verify-studio-native-managed-a2a.mjs verify-studio-native-managed-children.mjs verify-studio-native-managed-crash.mjs verify-studio-native-management-web.mjs verify-studio-native-memory-web.mjs verify-studio-native-portable-runtime.mjs verify-studio-native-portable.mjs verify-studio-native-response-crash.mjs verify-studio-native-sidebar-ui.mjs verify-studio-native-sidebar-web.mjs verify-studio-native-skill-workflow.mjs verify-studio-native-vision.mjs verify-studio-node-builtins.mjs verify-studio-onboarding-ui.mjs verify-studio-persistence.mjs verify-studio-plugin-lifecycle.mjs verify-studio-product-profiles.mjs verify-studio-route-failures-ui.mjs verify-studio-startup-states.mjs verify-studio-team-host.mjs | End-to-end acceptance for the Studio plugin and desktop product |
native | 17 | verify-native-codex-cli.mjs verify-native-dependencies.mjs verify-native-dsh-browser.mjs verify-native-dsh-numeric.mjs verify-native-dsh-output.mjs verify-native-dsh-turn.mjs verify-native-durable-approval.mjs verify-native-full-page.mjs verify-native-mcp-package.mjs verify-native-memory-browser.mjs verify-native-model-surface.mjs verify-native-owned-recovery.mjs verify-native-python-syntax-package.mjs verify-native-real-model.mjs verify-native-studio-install.mjs verify-native-thinking-browser.mjs verify-native-thinking-view.mjs | Native engine, native tools and native sessions |
dsh | 9 | verify-dsh-codex-tool-cards.mjs verify-dsh-lifecycle.mjs verify-dsh-live-runtime.mjs verify-dsh-node-store.mjs verify-dsh-plugin-market.mjs verify-dsh-product-presentation.mjs verify-dsh-runtime-adapter.mjs verify-dsh-runtime-retry.mjs verify-dsh-sdk-node-store.mjs | DSH base, patches and lifecycle |
desktop | 6 | verify-desktop-artifact.mjs verify-desktop-client-source.mjs verify-desktop-differential.mjs verify-desktop-installed-update.mjs verify-desktop-module-graph.mjs verify-desktop-update-inputs.mjs | Desktop runtime and installer |
codex | 5 | verify-codex-command-events.mjs verify-codex-configured-model.mjs verify-codex-long-task.mjs verify-codex-plugins.mjs verify-codex-signing.mjs | Codex App Server and plugins |
a2a | 4 | verify-a2a-host-decisions.mjs verify-a2a-observation-view.mjs verify-a2a-question-wait.mjs verify-a2a-session-events.mjs | Agent-to-Agent control plane |
windows | 4 | verify-windows-app-ui.mjs verify-windows-coexistence.mjs verify-windows-official-dsh.mjs verify-windows-online-update.mjs | Windows release and update |
agent | 1 | verify-agent-manifest.mjs | Agent catalog |
agentengine | 1 | verify-agentengine-responses.mjs | AgentEngine control plane integration |
bundle | 1 | verify-bundle-host.mjs | Portable runtime bundle |
client | 1 | verify-client-modules.mjs | Client build and module graph |
container | 1 | verify-container-bundle.mjs | Container deployment environment |
deployed | 1 | verify-deployed-bundle.mjs | Deployed runtime |
host | 1 | verify-host-dependency-lifecycle.mjs | Host routing and dispatch |
independent | 1 | verify-independent-workspace-host.mjs | Native engine independence |
ks3 | 1 | verify-ks3-multipart.mjs | KS3 storage |
macos | 1 | verify-macos-onboarding.mjs | macOS release |
managed | 1 | verify-managed-mcp-identity.mjs | — |
packaged | 1 | verify-packaged-drag-region.mjs | Packaged artifacts |
patched | 1 | verify-patched-dsh-host.mjs | Patched Host |
portable | 1 | verify-portable-codex.mjs | Portable resources and credentials |
team | 1 | verify-team-template-catalog.mjs | Team runtime |
verification/verify | 1 | verification/verify-assistant-deliverable-boundary.mjs | — |
Version and compatibility
| Item | Value | Notes |
|---|---|---|
| make targets | 56 | A new target must land here, or --check fails |
| Default goal | check | Runs when make has no argument |
| Check scripts | 100 | Gate targets reuse them |
| Excluded targets | 2 | Legacy Intel-Mac targets, never published |
Developer entry points
| Item | Source |
|---|---|
| Target definitions | Makefile |
| Check scripts | scripts/ |
| Developer experience | scripts/development-doctor.mjs |
| Docs site build | docs-site/scripts/build-static.mjs |
Related tests:
| Test file | Location |
|---|