[CLI REFERENCE]

axis install

bun install at the monorepo root plus worker/ and the CLI. App + Worker + CLI deps in one shot.

Wrapper: bun run axis:install. Env: AXIS_ROOT, AXIS_WORKER_URL, CLOUDFLARE_API_TOKEN, AXIS_CLI_SRC=1.

axis doctor

Toolchain, wrangler.toml, Cloudflare® auth, and optional live /health.

Wrapper: bun run axis:doctor. For flags via bun: bun run axis -- doctor --remote.

axis setup

Bootstrap: install → ensure wrangler.toml → local Cloudflare® D1. Combined flags can provision OAuth and remote Cloudflare® D1 in one pass.

When using bun run axis setup -- --flag, keep the -- so Bun forwards flags.

axis dev

Vite product UI on :3000. Pair with Flask Pro API (make -C ../pynescript run) on :5002 for the server engine.

Also: bun run dev (Vite) · bun run desktop:dev (Tauri).

axis deploy

Deploy Cloudflare® Worker pynescript-axis, optional Cloudflare® Pages, or both. Project id is frozen — do not rename.

Wrapper: bun run axis:deploy → axis deploy worker.

axis setup worker

Copy wrangler.toml.example → wrangler.toml if missing.

axis setup d1

Apply worker/schemas/scripts.sql to Cloudflare® D1 (database name pynescript).

axis setup oauth

Set the public OAuth App id in [vars] (or --secret). Device Flow must be enabled on GitHub.

axis secret

Wrangler secrets for the Worker: ADMIN_TOKEN, EXTERNAL_BACKEND, and related values. Prefer secrets over committed vars.

When using bun run axis -- secret put NAME, keep the -- so Bun forwards the subcommand.

axis health

Probe /health and optionally start the GitHub device flow.

Wrapper: bun run axis:health -- --oauth.

axis whoami

Print the authenticated Cloudflare® account.

axis --help

Print the AXIS CLI command surface.

After bun link from packages/cli, axis --help works as a local bin.

make axis

Makefile pass-through to packages/cli/bin/axis.js. Fixed wrappers: axis-install, axis-doctor, axis-setup, axis-deploy, axis-health.

Env: AXIS_ROOT, AXIS_WORKER_URL, CLOUDFLARE_API_TOKEN, AXIS_CLI_SRC=1.