File size: 1,987 Bytes
383cb38 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | ---
name: atom-daemon
description: Start Atom OS as background daemon service with PID tracking
version: 1.0.0
author: Atom Team
tags: [atom, cli, daemon, service-management]
maturity_level: AUTONOMOUS
governance:
maturity_requirement: AUTONOMOUS
reason: "Daemon control manages background services, requires full autonomy"
---
# Atom Daemon Manager
Start Atom OS as a background daemon service with PID file tracking.
## Usage
Execute this skill to start the Atom daemon:
```
atom-os daemon [options]
```
## Options
- `--port <number>`: Port for web server (default: 8000)
- `--host <address>`: Host to bind to (default: 0.0.0.0)
- `--workers <count>`: Number of worker processes (default: 1)
- `--host-mount`: Enable host filesystem mount (requires confirmation)
- `--dev`: Enable development mode with auto-reload
- `--foreground`: Run in foreground (not daemon mode)
## Examples
Start daemon on default port:
```
atom-os daemon
```
Start daemon on custom port with development mode:
```
atom-os daemon --port 3000 --dev
```
Start daemon with host mount (requires AUTONOMOUS maturity):
```
atom-os daemon --host-mount
```
## Output
Returns daemon process ID and status information:
- PID: Process identifier for daemon
- Dashboard URL: http://localhost:8000 (or custom port)
- Log file location: ~/.atom/logs/daemon.log
## Notes
⚠️ **AUTONOMOUS maturity required** - This command manages background services.
**Host Mount Warning:** Enabling `--host-mount` gives containers write access to host directories. Governance protections active:
- AUTONOMOUS maturity gate required
- Command whitelist (ls, cat, grep, git, npm, etc.)
- Blocked commands (rm, mv, chmod, kill, sudo, etc.)
- 5-minute timeout enforcement
- Full audit trail to ShellSession table
## Control Commands
After starting daemon, use these commands:
- `atom-os status` - Check daemon status
- `atom-os stop` - Stop daemon
|