# App tools (/cli/resource/app)



The app-only tools, on top of the shared [`geni resource`](/cli/resource) commands ([`create --type app`](/cli/resource/create), [`validate`](/cli/resource/validate), [`config`](/cli/resource/config), [`publish`](/cli/resource/publish), [`pull`](/cli/resource/pull)). They all run against the **live** (published) app, so publish before you run a handler.

Because an app's UI renders in the dashboard's iframe, the CLI can't preview it. These tools let an agent drive correctness headlessly. See [Apps](/cli/resource/apps) for the authoring contract.

* [`app build-status`](/cli/resource/app/build-status) — the live app's Vite build state.
* [`app run-handler`](/cli/resource/app/run-handler) — dispatch a handler with test input.
* [`app invocations`](/cli/resource/app/invocations) — recent handler runs.
* [`app errors`](/cli/resource/app/errors) — browser-side errors the iframe reported.
* [`app clear-cache`](/cli/resource/app/clear-cache) — flush the handler response cache.