omnarad

omnarad [command] [options]omnarad start [--no-service]omnarad install [--release-manifest-url url] [--no-start]omnarad uninstall [--yes]

omnarad is the Omnara machine daemon. It runs on each laptop, VM, or container that agents should use as a computer: it dials out to the Omnara API, so no inbound port or SSH key is required, and it runs commands that survive daemon restarts. The Go program is `cmd/daemon`; go-arg describes it as "Omnara machine daemon for running agent processes." Official installs live under ~/.omnarad (or OMNARA_HOME).With no subcommand, omnarad starts the daemon (same as omnarad start). On Linux it registers a systemd user service; on macOS it uses launchd. When no user service manager is available, it warns and runs in the foreground with restart supervision; press Ctrl-C to stop it and run omnarad start again. The daemon updates itself in the background from the installer-recorded release manifest unless updates are disabled.The usual install path is the hosted script `https://api.omnara.com/install/omnarad.sh`, which supports macOS and Linux on amd64 and arm64. omnara machines create-local creates the machine record, mints a one-time machine token, and runs that installer on the current computer.

--version

Print the daemon version and exit.

With start, run in the foreground instead of a user service.

With install, URL of the release manifest for a new installation.

With install, install without starting or restarting the daemon.

With uninstall, skip the confirmation prompt.

~/.omnarad/ or $OMNARA_HOME

Daemon home. OMNARA_HOME must be an absolute, already-clean path. Default is `~/.omnarad`.

Runtime config, mode `0600`. Default API root is `https://api.omnara.com/v1`.

$ {
  "schema_version": 1,
  "api_url": "https://api.omnara.com/v1",
  "machine_token": "",
  "installation_id": "",
  "machine_id": "",
  "no_update": false,
  "runner_path": "",
  "git_credentials_disabled": false
}

Install receipt used for repairs and background updates: schema version, install method `omnarad.sh`, and the release manifest URL.

(default) / start

Start the daemon. With a systemd or launchd user service, prints `omnarad daemon is running` and returns. --no-service stops any managed service and runs in the foreground instead.

Stop the daemon. Prints `omnarad is stopped`.

Restart the managed service, or run in the foreground when no service manager is available.

Print running or stopped state, including the service manager and pid when running. Exit status 1 when stopped.

Copy this executable into the daemon home and write `daemon.json`. A new install requires --release-manifest-url. Prompts for OMNARA_MACHINE_TOKEN unless that variable is already set. Restarts the daemon unless --no-start is given.

Stop the daemon, attempt to stop agent processes, remove the user service, and delete the entire daemon home. Without --yes, type `uninstall` at the prompt. Non-interactive uninstall requires --yes.

OMNARA_HOME

Daemon home directory. Must be an absolute clean path.

Control-plane API root written into `daemon.json`. Default `https://api.omnara.com/v1`.

One-time machine token (omnara daemon v1 prefix). Required at install if not prompted interactively. A rejected token is reported against the configured API URL.

`1` disables background updates; `0` enables them. Other values are an error.

`0` disables git credential helper injection; `1` enables it. Other values are an error.

`PATH` used when the daemon starts agent processes. Defaults to the installer's `PATH`.

Installer coverage is macOS and Linux on amd64 and arm64. macOS binaries require macOS 13 or later. uninstall permanently deletes the daemon home and everything beneath it, including files you added and files on filesystems mounted inside that directory.status exits 1 when the daemon is stopped, so it is not a success-only health check in scripts. Hidden internal subcommands (`run-service`, process runner, file transfer, git credential helper) are used by the service manager and agent runtime; they are not user commands.The daemon connects outbound only. Grant the machine to a project with omnara grant machines add (or pass --project-ids at create) before agent configs can target it by machine name.

omnarad is the machine daemon from the Apache-2.0 Omnara project (omnara-ai/omnara). GitHub releases publish tagged `omnarad-v*` binaries separately from the npm CLI. The registered daemon semantic version is the compatibility boundary with the control plane.

omnara(1), curl(1), systemctl(1), launchctl(1)

Source code · Homepage · Documentation