Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/agent0ai/space-agent/llms.txt

Use this file to discover all available pages before exploring further.

The Space Agent CLI lives in a single entry file — space.js — and exposes all server management, configuration, and state-management operations through a consistent node space <command> interface. Commands are discovered dynamically: every .js file inside the commands/ directory is treated as a command module, so the command set reflects exactly what is present on disk. There are no hidden built-ins beyond the two flag aliases --help and --version.

Entry Point

Run any command with Node directly, or mark space.js executable first:
node space <command> [args]
Two flag aliases are handled before command dispatch:
FlagResolves to
--helphelp
--versionversion

Command Families

Space Agent groups its commands into two families based on what they affect.

Operational

Control or inspect the local runtime: serve, supervise, help, get, set, version, update

State Management

Edit layered runtime data under the logical app tree: user, group

All Commands

CommandSummaryUsage
serveStart the local Node servernode space serve [PARAM=VALUE ...]
superviseRun a zero-downtime reverse-proxy supervisornode space supervise CUSTOMWARE_PATH=<path> [...]
userCreate users and manage passwordsnode space user <create|password> ...
groupCreate groups and manage membershipnode space group <create|add|remove> ...
getRead server config parameters from .envnode space get [PARAM]
setWrite server config parameters to .envnode space set KEY=VALUE [...]
updateUpdate source checkout from Gitnode space update [target]
versionPrint the git-derived project versionnode space version
helpList commands or show per-command helpnode space help [command]

Built-in Help

Every command module exports a help object that node space help uses to generate output. You never need to read the source to find the correct flags.
# List all discovered commands
node space help

# Show detailed help for a specific command
node space help serve
node space help supervise
node space help user
node space help group
node space help get
node space help set
node space help update

Command Discovery

The space.js loader reads commands/*.js at runtime and sorts the results alphabetically. Any .js file placed in that directory becomes a command. Non-JavaScript assets such as commands/params.yaml and subdirectories like commands/lib/ are intentionally excluded from discovery — only files matching the pattern commands/<name>.js are loaded.
Because command names derive from filenames, the command set can differ between source checkouts at different revisions. Run node space help to see exactly which commands are available in your current checkout.

Build docs developers (and LLMs) love