Process Management
Process commands are terminal-only because they affect the running service and every connected channel.
Lifecycle commands
| Command | Effect |
|---|---|
chemag start | Start the service; foreground and log-tail options are available |
chemag stop | Stop the running service |
chemag restart | Stop and start the service |
chemag update | Apply an authorized update, dependencies, CLI installation, and restart |
chemag status | Inspect process, version, model, and channel state |
chemag logs -n 100 | Show a bounded recent log window |
chemag logs -f | Follow live service logs |
chemag install-browser | Install the optional browser-tool runtime |
Controlled restart workflow
- 1Announce the window
Connected sessions and channels may be interrupted.
- 2Capture state
Record version, active integrations, configuration ownership, and open incidents.
- 3Run the command
Use an authorized terminal and retain only non-sensitive diagnostic output.
- 4Verify
Check status, Web console, model response, channel health, scheduled work, and logs.
Update boundary
Do not update a modified production tree blindly
Review release notes, preserve local modules, run the website and product tests, and maintain a rollback point before applying an update.