Skip to main content

Valor CLI developer preview

Valor CLI is a repository-local developer preview for terminal automation, session state, runtime checks, and agent-lane orchestration. Its command contract is testable today, but the ask response remains a scaffold and the package is not documented as a public npm release.

Use this page to evaluate or contribute to the CLI from a ValkyrAI source checkout. Do not build production automation around preview responses or an assumed registry package.

Prerequisites​

  • Git
  • Node.js 20 or newer
  • npm

Run from an authorized source checkout​

The CLI is currently distributed with the ValkyrAI source tree. Begin in a checkout that your Valkyr Labs account is authorized to access:

cd ValkyrAI/packages/valor-cli
npm ci
npm test
node src/cli.mjs --help

Run the CLI without a global link:

node src/cli.mjs doctor --offline --format json
node src/cli.mjs session list --format json

For local development, npm link exposes the package's valor executable from this checkout. Remove the link when you finish testing.

Authenticate without exposing a token​

Prefer a secret-store-provided environment variable or standard input:

valor auth login --token-env VALKYR_AUTH_TOKEN --format json
valor auth status --format json

Avoid --token <value> in shared shells because the token can enter shell history or process inspection output.

Stable preview surfaces​

The current command parser exposes:

  • doctor and runtime status for local/runtime checks;
  • auth login, auth status, and auth logout;
  • session save, current, list, resume, switch, and forget;
  • lane event and lane history; and
  • agent-run registration, transition, listing, and lane release commands.

Use --format json for automation and inspect each command's ok, error, and exit-code fields.

About ask and chat​

The source package currently returns scaffold output for ask and its local chat path. These commands validate input sources, output shape, and session behavior; they are not evidence of a production model response.

Do not present a successful scaffold response as completed remote work.

Validate changes​

cd packages/valor-cli
npm test
npm run test:pack
npm run lint

The package manifest is the version source of truth. Registry publication and release promotion require a separate verified release event.