CLI

Process Management

Process commands are terminal-only because they affect the running service and every connected channel.

Lifecycle commands

CommandEffect
chemag startStart the service; foreground and log-tail options are available
chemag stopStop the running service
chemag restartStop and start the service
chemag updateApply an authorized update, dependencies, CLI installation, and restart
chemag statusInspect process, version, model, and channel state
chemag logs -n 100Show a bounded recent log window
chemag logs -fFollow live service logs
chemag install-browserInstall the optional browser-tool runtime

Controlled restart workflow

  1. 1
    Announce the window

    Connected sessions and channels may be interrupted.

  2. 2
    Capture state

    Record version, active integrations, configuration ownership, and open incidents.

  3. 3
    Run the command

    Use an authorized terminal and retain only non-sensitive diagnostic output.

  4. 4
    Verify

    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.