CLI Overview

The commands @askrjs/cli actually ships, how to target a project with --cwd, and which generators do not exist.

Example

Run the project-local published CLI, inspect help before scripting it, and keep CI commands pinned by package-lock.json.

npx askr --version
npx askr --help
npx askr create --help
npx askr openapi --check

askr --help is the generated source of truth for the current command set. It covers scaffolding and generation; analysis, diagnosis, repair, and full project checks; database, OpenAPI, and SSG workflows; agent skills; and dependency maintenance. The command table rendered below comes directly from the installed CLI snapshot, and each command accepts its own --help flag for command-specific usage and examples.

Help and version

Running askr with no arguments, or with --help/-h, prints the same top-level help text: a usage line, the command table, global options, and a handful of worked examples. --version (or -v) prints the installed @askrjs/cli version by walking up from the executable's directory until it finds the package.json whose name is @askrjs/cli. An unrecognized command prints Unknown command: <name> and points you back at askr --help rather than silently doing nothing.

Project-local execution

@askrjs/cli can be installed globally (npm install -g @askrjs/cli) or run through a project-local installation. Project-aware commands expose --cwd in their own help when they support targeting a directory other than the current one; check askr <command> --help rather than assuming the flag is universal. This matters for scripting: a CI job or monorepo tool can invoke a supported command such as askr update --cwd packages/app without changing its own working directory first.

CI usage

Several commands fit CI directly: askr analyze --check and askr check fail on project diagnostics, askr openapi --check fails without writing when the checked-in artifact drifts, askr database validate checks an installed @askrjs/orm schema, and askr outdated --json emits deterministic machine-readable output. Because update and upgrade never run an install or touch a lockfile, they can be followed by the normal install-and-test job. --workspace and --tag flags let a dependency-maintenance matrix target one package or one dist-tag at a time.

Published commands

These commands come from @askrjs/cli. Planned generators such as route, crud, table, and form are not available commands.

Command	Run
`add`	`askr add --help`
`analyze`	`askr analyze --help`
`check`	`askr check --help`
`create`	`askr create --help`
`database`	`askr database --help`
`docs`	`askr docs --help`
`doctor`	`askr doctor --help`
`generate`	`askr generate --help`
`openapi`	`askr openapi --help`
`skills`	`askr skills --help`
`ssg`	`askr ssg --help`
`outdated`	`askr outdated --help`
`repair`	`askr repair --help`
`update`	`askr update --help`
`upgrade`	`askr upgrade --help`