CLI Reference
Oore CI provides two command-line tools:
oored— the daemon (control plane and API server)oore— the operator CLI for setup, administration, and daily use
oored (Daemon)
The daemon serves the HTTP API and manages instance state.
Commands
| Command | Description | Status |
|---|---|---|
oored run | Start the daemon | Implemented |
oored install-service | Install as a macOS launchd service | Placeholder |
oored uninstall-service | Remove the launchd service | Placeholder |
oored version | Print version information | Implemented |
oored run
bash
oored run [--listen <addr>] [--state-file <path>]| Flag | Default | Env var | Description |
|---|---|---|---|
--listen | 127.0.0.1:8787 | OORED_LISTEN_ADDR | Address and port to listen on |
--state-file | Platform default | OORE_SETUP_STATE_FILE | Override database path |
The default database path is ~/Library/Application Support/oore/oore.db. The encryption key is stored at ~/Library/Application Support/oore/encryption.key.
In default mode, oored starts an embedded local runner automatically. Set OORED_RUNNER_MODE=external to disable the embedded runner and require an external runner process.
oore (Operator CLI)
The operator CLI handles setup, authentication, and administration.
Commands
| Command | Description | Status |
|---|---|---|
oore setup | Interactive 4-step instance setup | Implemented |
oore setup token | Generate a bootstrap token | Implemented |
oore login | Authenticate in local mode or import a token | Implemented |
oore status | Show setup status and authenticated operational summary | Implemented |
oore runner register | Register an external build runner | Implemented |
oore runner start | Start external runner process | Implemented |
oore config set <key> <value> | Set CLI configuration values | Implemented |
oore config get <key> | Get CLI configuration values | Implemented |
oore doctor | Run environment/signing diagnostics | Implemented |
Global behavior
- All commands that communicate with the daemon accept
--daemon-url(default:http://127.0.0.1:8787, env:OORE_DAEMON_URL) - The CLI stores local defaults in
~/.oore/config.json(override path viaOORE_CONFIG_FILE) - State database path can be overridden with
--state-fileorOORE_SETUP_STATE_FILE - Default database location:
~/Library/Application Support/oore/oore.db
Embedded runner note
The single-host default flow does not require oore runner start. The daemon (oored) auto-starts an embedded local runner unless OORED_RUNNER_MODE=external.