Every merka command at a glance. All commands support --json for machine-readable output and --non-interactive to skip prompts.
| Command | What it does |
|---|
merka | Opens the TUI (interactive shell) |
merka --non-interactive | Runs the zero-input flow headlessly (identity, recovery, system summary) |
merka status | Shows system health and service status |
merka activate | Claims the system for your identity |
merka connect | Connects to an existing Merka system by URL |
merka setup | Guided onboarding wizard (identity, connect, activate) |
merka doctor | Checks your environment for common issues |
| Command | What it does |
|---|
merka identity show | Shows device ID, fingerprint, tier, link state |
merka identity devices | Lists all devices under your identity |
merka identity link | Links this device to a cosmic.rocks account |
merka identity unlink | Removes the cosmic.rocks account link |
merka identity reset-local | Deletes the local identity (requires --force) |
merka recover | Restores identity from your MK-… recovery key (prompted, or --recovery-key) |
| Command | What it does |
|---|
merka system bring-up | High-level system preparation wizard (early preview) |
merka system trust-ca | Trusts your system’s certificate on this device |
merka system install discover | Discovers BYO hardware for installation |
merka system install plan | Reviews proposed installation schema |
merka system install run | Validates and confirms a BYO installation (provisioning step coming soon) |
| Command | What it does |
|---|
merka settings | Opens settings (or shows as JSON) |
merka diagnostics export | Creates a support bundle |
merka self update | Checks for and installs updates |
merka self version | Shows the installed version |
| Flag | Effect |
|---|
--json | Machine-readable JSON output |
--non-interactive | Skip all prompts; missing inputs become errors |
--log-level <level> | Override log level (error/warn/info/debug/trace) |
--advanced | Show hidden commands in help output |
