Skip to main content

Axion CLI Reference

All commands use the axn prefix.

Core Commands

axn init

Initialize a new Axion project.
axn init [options]
OptionDescription
--cloudCreate and link to a cloud project

axn set

Set an environment variable.
axn set <key> <value> [options]
OptionDescription
--scope <env>Environment scope: development, staging, production
--forceSuppress overwrite warning
--jsonValidate value as JSON before storing
-s, --service <name>Scope to a specific service
Examples:
axn set DATABASE_URL "postgres://localhost/db"
axn set API_KEY "sk-xxx" --scope production
axn set CONFIG '{"debug":true}' --json
axn set DATABASE_URL "postgres://{{PG_USER}}:{{PG_PASS}}@localhost/db"

axn get

Get an environment variable value.
axn get <key> [options]
OptionDescription
--scope <env>Environment scope (default: development)
--revealShow actual value (unmask)

axn rm

Remove an environment variable.
axn rm <key> [options]

axn list / axn ls

List all environment variables.
axn list [options]
axn ls [options]
OptionDescription
--scope <env>Environment scope
--revealShow actual values

axn run

Run a command with secrets injected.
axn run [options] -- <command>
OptionDescription
--scope <env>Environment scope (default: development)
-s, --service <name>Service to load secrets for
Examples:
axn run -- npm start
axn run --scope production -- node dist/index.js
axn run -s api -- npm start

axn export

Export secrets to stdout or file.
axn export [options]
OptionDescription
--scope <env>Environment scope
--format <fmt>Output format: env, json, yaml
-o, --output <file>Write to file

Cloud Sync

axn sync

Sync .env files with encrypted manifest.
axn sync [file] [options]
OptionDescription
--pushForce push local to cloud
--pullForce pull from cloud
--discoverDiscover .env files
--initInitialize sync config

axn drift

Detect differences between local and cloud.
axn drift

axn push

Push manifest to cloud.
axn push

Authentication

axn login

Sign in with SSO.
axn login [options]
OptionDescription
--googleSign in with Google (default: GitHub)

axn logout

Sign out and clear credentials.
axn logout

axn whoami

Show current user and linked project.
axn whoami

Project Management

Link to an existing cloud project.
axn link <project-id>
Disconnect from cloud.
axn unlink

axn destroy

Delete a project (owner only).
axn destroy [options]

Team Management

axn members

Manage project members.
axn members list
axn members add <email>
axn members revoke <user-id>

axn audit

View access audit logs.
axn audit

Service Tokens (CI/CD)

axn tokens

Manage service tokens.
axn tokens create
axn tokens list
axn tokens revoke <id>

Key Management

axn key

Show key fingerprint or reveal key.
axn key [options]
OptionDescription
--showReveal the actual key

axn rotate

Rotate encryption key.
axn rotate

axn recovery

Manage key recovery.
axn recovery setup
axn recovery restore

Global Options

These options work with any command:
OptionDescription
-s, --service <name>Scope operations to a specific service
--scope <env>Environment scope
--revealShow actual secret values
--forceSkip confirmation prompts