CLI Reference

axs (@axis-tech-co/axs) is the Axis command-line tool. It scaffolds projects, authors handlers and stacks, inspects your project, and runs project tasks. Every reference page on this section shows a usage block generated directly from the CLI’s own command definitions — so the flags you read here are the flags the tool actually accepts, always current.

The commands, by job

Start a project

• axs new — scaffold a new Axis project.

Author into an existing project

• axs add lambda — add a handler + config (API, worker, cron, edge; single or fat multi-route).
• axs add table — add a DynamoDB table config.
• axs add stack — add a pre-built Axis stack.
• axs add resolver — add a VTL/JS AppSync resolver.
• axs add import — import an existing AWS resource by ARN.

Inspect and manage

• axs feature — view/edit feature toggles.
• axs doctor — static project health check.
• axs coverage — run coverage or show thresholds.
• axs context — export a redacted project digest for AI tools.
• axs visualize — print the resource & data-flow graph.
• axs sdk generate — generate a typed client SDK.
• axs run — run a project task.
• axs auth — manage GitHub Packages auth.

How these pages stay accurate

The usage blocks are emitted by generate-cli-partials.mjs, which walks the built Commander program at docs-build time. A bidirectional gate fails the build if a command has no page or a page has no command — a new axs command can’t ship undocumented, and a page can’t outlive its command.