ox daemon
Manage the background sync daemon that keeps your Ledger and Team Context automatically synchronized.
What the daemon does
The SageOx daemon runs in the background and handles:
- Automatic git sync - Pushes and pulls changes to your Ledger and Team Context repos
- Change debouncing - Batches rapid changes to avoid excessive git operations
- Periodic pulls - Fetches updates from your team at regular intervals
The daemon starts automatically when you run ox init or ox login. You don't need to manage it manually unless troubleshooting.
Usage
terminal
$
Subcommands
| Command | Description |
|---|---|
start | Start the daemon |
stop | Stop the daemon |
restart | Restart the daemon |
status | Show daemon status |
logs | View daemon logs |
list | List all running ox daemons |
kill | Kill daemon process(es) |
Check daemon status
terminal
$
ox daemon status
Daemon Status
PID: 12345
Running: yes
Uptime: 2h 15m
Last sync: 30s ago
Status flags
| Flag | Description |
|---|---|
--verbose | Show detailed status information |
View daemon logs
terminal
$
Logs flags
| Flag | Description |
|---|---|
-n, --lines | Number of lines to show (default: 50) |
-f, --follow | Follow log output in real-time |
--path | Show log file path instead of contents |
--all | Show logs from all daemon instances |
Follow logs in real-time:
terminal
$
Start and stop
Start the daemon manually:
terminal
$
Run in foreground (for debugging):
terminal
$
Stop the daemon:
terminal
$
Restart after configuration changes:
terminal
$
Managing multiple daemons
List all running ox daemons across your system:
terminal
$
Kill a specific daemon or all daemons:
terminal
$
$
When to restart the daemon
Restart the daemon after:
- Changing SageOx configuration in
.sageox/config.toml - Updating the ox CLI to a new version
- Switching teams or repositories
- Resolving sync conflicts manually
Troubleshooting
Daemon not running - Start it manually:
terminal
$
Sync issues - Check the logs for errors:
terminal
$
Daemon unresponsive - Kill and restart:
terminal
$
Multiple daemons running - Clean up stale processes:
terminal
$
$
$