GeneSYS CLI Overview
GeneSYS is a local-first coding workspace and control plane for agent-driven software work. The gene CLI controls the runtime that backs sessions, memory, plugins, tools, policy, browser/sandbox automation, and diagnostics.
Mental Model
- gene start launches the local runtime and attached services.
- gene ask sends work to the active runtime session.
- Runtime-backed commands need the backend to be running.
- Local commands such as init, doctor, config, sessions, shell, and identity/status checks can run before the backend is up.
- The CLI and terminal viewer share the same session/runtime model.
Operator Surfaces
| Surface | Use |
|---|---|
| /workspace | Active coding sessions, approvals, diffs, tasks, memory, MCP resources, coordinator mode, buddy state, and compaction flows. |
| /control/* | Runtime health, models, prompts, memory, tools, plugins, audit, logs, sandbox posture, and settings. |
| gene CLI | Runtime startup, UI serving, sessions, memory, plugins, tools, policy, sandbox/browser, self-heal, research, companion, channels, logs, and diagnostics. |
Backend Boundary
Document backend requirements explicitly.Every hosted command entry should say whether it is local-only or requires an active runtime backend, because connection errors are one of the highest-friction first-run failures.
Source Material
- Pasted GeneSYS CLI Documentation Outline
- packages/cli
- packages/ui/src/index.ts
- README.md