Skip to content
axxbetadocs
v0.2.26next
GitHub

axx env

View .mdOpen in Claude

Report the services Axx started from axx.yaml, as the Axx MCP server’s env tool does: running (axx up, or a run, still holds them), left over (they run, but what started them does not: axx down stops them) or not cleaned up (their cleanup failed or never ran: axx down runs it). env status is axx env; env up and env down are axx up and axx down.

Usage:
axx env [flags]
axx env [command]
Available Commands:
down Stop services started by `axx up` (and any left behind by an interrupted run)
status The services axx started (the same as `axx env`)
up Start the services from axx.yaml and keep them running between `axx run`s
Flags:
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-h, --help help for env
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)
Use "axx env [command] --help" for more information about a command.

Stop services started by axx up (and any left behind by an interrupted run)

Usage:
axx env down [flags]
Flags:
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-h, --help help for down
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)

The services Axx started (the same as axx env)

Usage:
axx env status [flags]
Flags:
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-h, --help help for status
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)

Start the services (all enabled ones, or the ones named) in the background and wait until they are ready. Later axx run invocations reuse them instead of starting and stopping them each time, which is the fastest local loop. Stop them with axx down. Service output goes to .axx/logs/services.log.

Usage:
axx env up [services...] [flags]
Flags:
--debug string[="*"] start services with their debug command (all, or a comma-separated list)
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-h, --help help for up
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)