Connect to MARS
SSH in
goodbot. See Connecting via SSH for hostname, Ethernet, and USB-C options.Optional: Fork the open-source repo
You don’t need to fork to start developing. Agents and skills in
~/agents/ and ~/skills/ work out of the box. Fork when you want to save, version-control, and share your work — or modify the OS itself (ROS2 nodes, drivers, launch files).Fork on GitHub
Go to github.com/innate-robotics/innate-os and click Fork.
Launch and restart
MARS auto-launches all ROS2 nodes on boot via systemd. When you make changes, you need to restart.Watch the nodes boot
| Keys | Action |
|---|---|
Ctrl+B then 0–6 | Switch to a window |
Ctrl+B then ← / → | Switch between left/right panes |
Ctrl+B then O | Cycle to the next pane |
Ctrl+B then Z | Zoom a pane to full screen (press again to unzoom) |
Ctrl+B then D | Detach from tmux (nodes keep running) |
Shutting down gracefully
Always shut down properly before unplugging power. A hard power cut can corrupt the filesystem.Project structure
When you SSH in, the key directories are:| Path | What’s there |
|---|---|
~/agents/ | Your agent definitions (hot-reloaded) |
~/skills/ | Your custom skills |
~/innate-os/ | The full OS repo |
~/innate-os/ros2_ws/ | ROS2 workspace (all packages) |
~/innate-os/scripts/ | Launch scripts, diagnostics, update system |
Next steps
Quick Development
Build your first agent in 5 minutes.
Advanced Development
Modify ROS2 nodes, recompile, visualize topics.
Innate CLI
Every command at your fingertips.
Foxglove Setup
Visualize what your robot sees in real time.

