Skip to main content
The innate CLI is your control panel. SSH into MARS and start typing.
in8 is a zsh alias for innate, available in any new shell.

Default (no args)

CommandWhat it does
innateStatus dashboard — version, mode, ROS/DDS status, quick reference

Service management

Start, stop, and inspect all ROS nodes.
CommandWhat it does
innate service startStart all ROS nodes in tmux
innate service stopKill the tmux session
innate service restartStop + start
innate service viewAttach to the tmux session

Top-level shortcuts

CommandSame as
innate viewinnate service view
innate restartinnate service restart

Build

Smart build that does the right thing automatically. If ROS nodes are running, it stops them, builds, and restarts them. If nodes aren’t running, it just builds. If the build fails, nodes are not restarted.
CommandWhat it does
innate buildBuild full workspace (stops/starts nodes if running)
innate build pkg1 pkg2Build specific packages only
innate cleanRemove build/, install/, log/

Examples

innate build maurice_arm       # build one package (restarts nodes if they're running)
innate build                   # build everything
innate clean && innate build   # full clean rebuild

Diagnostics & updates

CommandWhat it does
innate diagHardware check (servos, PCB, lidar, cameras, speaker)
innate update check [--dev]Check for available updates
innate update apply [version] [--dev]Apply updates (optionally pin a specific version)
innate update statusShow version + service info
See Updates and Maintenance for details.

Quick reference card

innate                          → status dashboard
innate service start            → launch ROS nodes
innate service stop             → kill all nodes
innate service restart          → stop + start
innate service view             → attach to tmux
innate view                     → shortcut for above
innate restart                  → shortcut for above
innate build [pkg ...]          → build (stops/starts nodes if running)
innate clean                    → rm build/install/log
innate diag                     → hardware diagnostics
innate update check [--dev]     → check for updates
innate update apply [version] [--dev] → apply updates
innate update status            → version + service info
in8 ...                         → alias for innate

Tmux navigation

When you run innate view, you’re inside a tmux session. Here’s how to move around:
KeysAction
Ctrl+B then 06Switch to window 0–6
Ctrl+B then / Switch between left/right panes
Ctrl+B then [Enter scroll mode (navigate with arrow keys)
qExit scroll mode
Ctrl+B then DDetach from tmux (nodes keep running)
See Advanced Development for a breakdown of what runs in each window.