CLI Command Reference
Comprehensive reference catalog for all 55 Omera CLI commands. Orchestrate your firmware builds, runs, testing, verification, and hardware flashing directly from your terminal.
Primary Commands
Root level commands for initializing workspaces, validating environments, and starting interactive sessions.
| Command | Description |
|---|---|
omera | Launches the Interactive Chat REPL if run inside an initialized project workspace; opens the TUI Dashboard otherwise. |
omera init | Initializes a new Omera workspace. Creates a local configuration .omera/config.json, and setup directories. Idempotent. |
omera doctor | System environment diagnostic. Checks Python version, PlatformIO Core toolchains, debug probes, and AI cloud endpoints. |
omera version | Prints CLI version, Python runtime, OS platform architecture, and Omera 3.6 engine state. |
omera login | Triggers a secure browser-based OAuth device authorization flow (GitHub/Google SSO) to write local credentials. |
omera whoami | Displays active account username, current billing tier, and remaining AI quota. |
omera logout | Revokes active session tokens and clears cached local credentials safely. |
Firmware Group (omera fw)
Subcommands to manage the firmware generation lifecycle, target MCU definitions, and evidence packing.
| Command | Description |
|---|---|
omera fw workflow run | Executes the complete generation pipeline (C1 to C5). Resolves MCU pins, drivers, and compiles. |
omera fw system-map | Outputs JSON or visual representations of the board architecture, driver bindings, and simulation nodes. |
omera fw safety show | Prints the safety evaluation matrix showing pins with high-current or actuator safety locks. |
omera fw drivers matrix | Checks driver availability schemas for all detected components on the board netlist. |
omera fw app generate-spec | Uses AI to generate project firmware source code modules based on natural language intent. |
omera fw simulate | Runs host-side Renode tests and simulation trace assertions, outputting runtime results. |
omera fw verify | Quality gate executing static analysis rules, safety locks validation, and build checks. |
omera fw deliver | Packages compiled binaries, logs, reports, and checksum validation hashes into a deliverable zip archive. |
omera fw flash | Flashes compiled binary onto target MCU using connected debug probes via pyOCD. |
omera fw import-svd | Imports peripheral XML definitions (CMSIS-SVD) to supply exact hardware register mappings to the generator. |
Compilation & Patching
Commands to compile source files, query AI to explain compiler outputs, and apply code patches.
| Command | Description |
|---|---|
omera fw build run | Triggers compilation via PlatformIO using project configuration profiles. |
omera fw build explain | Pipes compiler errors to Omera 3.6 to receive diagnostic descriptions and code patch drafts. |
omera fw patch draft | Drafts replacement patch sets to solve compiler errors. |
omera fw patch validate | Validates proposed patches to check for security policy violations or directory escapes. |
Chat REPL Slash Commands
Slash commands available inside the interactive multi-turn shell (omera chat):
| Slash Command | Description |
|---|---|
/help | Lists all available REPL commands. |
/status | Displays active session ID, token count, and active deployment mode. |
/workspace [path] | Inspects or overrides the active workspace directory. |
/compact | Summarizes old turns to shrink the token context window. |
/new | Closes the current session and clears state to start a new chat turn. |
/sessions | Lists all saved conversations across the current project directory. |
/exit | Saves the conversation log and terminates the REPL. |