AgentKit Studio
Reference

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/.

EntryCountWhen to use
make <target>56Daily development, packaging and gates; targets carry prerequisites and platform checks
node scripts/verify-*.mjs100Single checks; the gate targets call these internally
node scripts/*.mjs204Build, 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.

PlatformArchitectureStatus
macOSarm64Supported, ships a .dmg
Windowsx64Supported, ships an NSIS .exe
macOSIntelNot 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 —.

TargetPrerequisitesNotesLocation
make setup—Bootstrap: install deps, apply patches, build Host, install pluginMakefile:43
make dev—Start the local development serverMakefile:53
make doctor—Check toolchain, Host revision, build outputs and installed pluginMakefile:56
make cloud-identity—Verify cloud identity configurationMakefile:62
make check—Default gate: lint, types and unit testsMakefile:72
make dsh-pin-check—Check dsh-pin.json against the HostMakefile:75
make client-module-gate—Client module boundary gateMakefile:80
make client-build—Build the client bundleMakefile:84
make test—Run unit testsMakefile:87
make public-surface-audit—Audit the public surface and sensitive materialMakefile:90
make secret-scan—Scan for leaked credentialsMakefile:95
make public-gate—Aggregate public-boundary gateMakefile:100
make ref-parity—Check ref parity between the tracked branchesMakefile:113
make pack—Pack the plugin tarballMakefile:118
make release-checkpublic-gatePre-release checkMakefile:122
make runtime-source-stage—Stage runtime sourcesMakefile:127
make patch-format-check—Check patch formattingMakefile:131
make patch-manifest-check—Check the patch manifestMakefile:135
make patch-source-check—Check patch sourcesMakefile:141
make patch-source-verify—Verify patch source digestsMakefile:144
make patch-source-import—Import patch sourcesMakefile:147
make patch-source-export—Export patch sourcesMakefile:151
make verify-patched-host—Verify the patched HostMakefile:155
make dsh-bootstrap—Fetch and build the DSH baseMakefile:162
make profile-installpackInstall the plugin into the target profileMakefile:176
make profile-check—Check profile stateMakefile:196
make patch-check—Check that patches applyMakefile:203
make patch-applypatch-checkApply patchesMakefile:210
make verify-dsh—Verify the DSH baseMakefile:213
make verify-dsh-lifecycle—Verify the DSH lifecycleMakefile:218
make verify-dsh-live-runtime—Verify DSH against a live runtimeMakefile:222
make verify-studio-plugin-lifecycle—Verify the plugin lifecycleMakefile:227
make verify-studio-desktop-dev—Verify the desktop dev runtimeMakefile:231
make verify-desktop-update—Verify desktop updateMakefile:235
make verify-desktop-differential—Differentially verify desktop artifactsMakefile:240
make verify-desktop-artifact—Verify the desktop installerMakefile:244
make verify-dsh-sdk—Verify the DSH SDK contractMakefile:248
make web-buildclient-buildBuild the web clientMakefile:254
make web-devprofile-installBuild and start the web dev environmentMakefile:260
make web-startweb-devStart the built web clientMakefile:265
make desktop-buildclient-buildBuild desktop artifactsMakefile:269
make desktop-dev—Build and start the desktop dev runtimeMakefile:275
make desktop-startclient-buildStart the built desktop runtimeMakefile:279
make desktop-package-preflightpackDesktop packaging preflightMakefile:284
make desktop-package-mac-arm64desktop-package-preflightPackage the signed macOS arm64 installerMakefile:291
make desktop-package-mac-arm64-unsigneddesktop-package-preflightPackage the unsigned macOS arm64 buildMakefile:296
make desktop-package-mac-arm64-dirdesktop-package-preflightPackage macOS arm64 as a directoryMakefile:300
make desktop-package-win-x64desktop-package-preflightPackage the Windows x64 installerMakefile:313
make desktop-package-win-x64-unsigneddesktop-package-preflightPackage the unsigned Windows x64 buildMakefile:316
make desktop-check-package—Check the desktop installerMakefile:319
make docs-site-build—Static-export the docs siteMakefile:326
make docs-site-dev—Start the docs site dev serverMakefile:330
make docs-site-check—Docs site gate: i18n, links and the generatorMakefile:333
make docs-site-previewdocs-site-buildPreview the exported docs siteMakefile:336
make cipublic-gateThe CI entry pointMakefile:341
make clean—Clean build artifacts and temp directoriesMakefile: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.

FamilySizeScriptsWhat it accepts
studio39verify-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.mjsEnd-to-end acceptance for the Studio plugin and desktop product
native17verify-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.mjsNative engine, native tools and native sessions
dsh9verify-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.mjsDSH base, patches and lifecycle
desktop6verify-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.mjsDesktop runtime and installer
codex5verify-codex-command-events.mjs verify-codex-configured-model.mjs verify-codex-long-task.mjs verify-codex-plugins.mjs verify-codex-signing.mjsCodex App Server and plugins
a2a4verify-a2a-host-decisions.mjs verify-a2a-observation-view.mjs verify-a2a-question-wait.mjs verify-a2a-session-events.mjsAgent-to-Agent control plane
windows4verify-windows-app-ui.mjs verify-windows-coexistence.mjs verify-windows-official-dsh.mjs verify-windows-online-update.mjsWindows release and update
agent1verify-agent-manifest.mjsAgent catalog
agentengine1verify-agentengine-responses.mjsAgentEngine control plane integration
bundle1verify-bundle-host.mjsPortable runtime bundle
client1verify-client-modules.mjsClient build and module graph
container1verify-container-bundle.mjsContainer deployment environment
deployed1verify-deployed-bundle.mjsDeployed runtime
host1verify-host-dependency-lifecycle.mjsHost routing and dispatch
independent1verify-independent-workspace-host.mjsNative engine independence
ks31verify-ks3-multipart.mjsKS3 storage
macos1verify-macos-onboarding.mjsmacOS release
managed1verify-managed-mcp-identity.mjs—
packaged1verify-packaged-drag-region.mjsPackaged artifacts
patched1verify-patched-dsh-host.mjsPatched Host
portable1verify-portable-codex.mjsPortable resources and credentials
team1verify-team-template-catalog.mjsTeam runtime
verification/verify1verification/verify-assistant-deliverable-boundary.mjs—

Version and compatibility

ItemValueNotes
make targets56A new target must land here, or --check fails
Default goalcheckRuns when make has no argument
Check scripts100Gate targets reuse them
Excluded targets2Legacy Intel-Mac targets, never published

Developer entry points

ItemSource
Target definitionsMakefile
Check scriptsscripts/
Developer experiencescripts/development-doctor.mjs
Docs site builddocs-site/scripts/build-static.mjs

Related tests:

Test fileLocation

On this page