CLI

The cemi command is the package's command-line entrypoint. In the closed beta it focuses on the local gateway, local workspace, and child-process orchestration for tracked runs on the same machine.

Command summary

Command	Purpose
cemi help	Show the main command list
cemi config	Display local CLI configuration
cemi config set <key> <value>	Persist owner or logdir in ~/.cemi/config.json
cemi gateway	Start the local gateway in the foreground
cemi view	Open the workspace without creating a run
cemi start -- <cmd>	Create a run context, open the workspace, and execute a command
cemi stop	Stop background local services started by the CLI

cemi gateway

Starts the local gateway and serves the embedded workspace UI.

cemi gateway

Choose a custom save directory:

cemi gateway --save-dir /tmp/cemi-demo

Choose a custom port:

cemi gateway --port 3142 --save-dir /tmp/cemi-demo

cemi view

Open the workspace without creating a run.

cemi view

The CLI runs the gateway in the foreground, opens a browser tab after startup, and keeps the process attached until you stop it.

Dev UI mode

cemi view --dev-ui

This starts the gateway in the background and opens the Vite development server when you are working from the source repository.

cemi start

cemi start is the main orchestration command. In the closed beta it prepares a local run environment, opens the workspace, injects environment variables, and then runs your training or benchmark command.

Local run

cemi start -- python train.py

With an explicit project and save directory:

cemi start --project compression-engine --save-dir .cemi -- python -m engine.main --config benchmark.yaml

The CLI:

• ensures a compatible local gateway is available
• creates a local run id
• injects CEMI_PROJECT_ID, CEMI_RUN_ID, CEMI_SAVE_DIR, and CEMI_LOCAL_SERVER_URL
• opens the local workspace

cemi config

Display current configuration:

cemi config

Set the default owner:

cemi config set owner "Jane Doe"

Set the default log directory:

cemi config set logdir "/data/cemi"

cemi stop

Stops background services recorded by the CLI:

cemi stop

This is mostly useful after cemi start --dev-ui or cemi view --dev-ui.

Closed beta notes

• Cloud actions are intentionally hidden in this build.
• cemi view and cemi start open the browser automatically.
• cemi gateway keeps serving on 127.0.0.1 and does not open a browser by itself.
• Local CLI state such as config.json and PID files lives under ~/.cemi/.