OpenRUA CLI
A CLI that connects Claude Code or Codex to robots and simulators through ROS 2: the agent writes perception and control programs.
- 62 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The agent writes and runs programs that move a physical robot; an error can damage equipment or hurt people nearby.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/openruaDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent writes and runs programs that move a physical robot; an error can damage equipment or hurt people nearby.
This is third-party code. Review the repository files before installing.
What it does
OpenRUA turns a robot into a working project for an ordinary coding agent. The agent works in a directory with robot documentation and starter tools, pulls sensor streams into files, writes perception and control programs and continues the task from execution feedback. It connects through the standard ROS 2 CLI and client library, with no vision-language-action model involved. OpenRUA prepares ROS 2, simulators and drivers in containers so dependencies stay apart from the host. You can work in a terminal (`openrua`), in a browser (`openrua --gui`), in the agent own terminal (`openrua agent`) or run one recorded task with `openrua exec`. `openrua connect` attaches a real robot: the agent and the user identify the robot and prepare its drivers together.
Who it is for. Robotics researchers and students who want to drive an arm or a simulator through Claude Code or Codex.
Good fit when
- You need to describe a scene from virtual robot cameras without moving it.
- A researcher tries Panda arm tasks in ManiSkill or other simulators.
- A real robot is being attached to a lab and drivers are easier to prepare together with the agent.
- Successful techniques should be saved as skills for use in simulation and on hardware.
Not a fit when
- There is no Linux with Python 3.10 or newer and Docker.
- The robot works near people and an emergency stop is not set up.
- You need a validated control model instead of programs written by an agent.
Example request
Look through the cameras and describe the scene, without moving the robot.Limitations
Installation targets Linux with Python 3.10 or newer, and the first Docker container and agent sign-in preparation takes a few minutes. The agent runs on your account or API key. The repository lists supported robots and simulators: Franka Emika Panda, Trossen WidowX 250S and the robosuite, ManiSkill, CALVIN and VLABench environments. Control programs are written by the agent, so on real hardware test them in simulation first and keep an emergency stop at hand.
How to disable. Remove the package with `pip uninstall openrua`, stop and delete the created Docker containers and the working project directory.
FAQ
How do I install OpenRUA?
On Linux with Python 3.10 or newer run `pip install -U openrua`, create a project directory and launch `openrua` in it. The setup wizard offers a simulator and an agent.
Which agents are supported?
Claude Code and Codex, with your account or API key.
How do I connect a real robot?
Run `openrua connect` in the project. The agent identifies the robot, prepares ROS 2 drivers and saves the setup in the project.
How do I stop a robot action?
From the shared conversation in the terminal or browser you can send a follow-up or stop an action. Real hardware also needs a physical emergency stop.
Which license applies?
Apache-2.0.
Discussion
No questions or reviews yet.
Related
CLI toolsquackd connects robots to Claude Code and Claude Desktop over MCP: nine tools and an executor with an allowlist
CLI connects Claude Code and Cursor events to a desk robot's movements, screen expressions and end-of-task bell
Turns one run of a task into a program an agent calls as a single tool, checking the record before and after the save
An MCP server that connects an agent to a ROS robot through rosbridge: reading sensors and control without changing the robot's code
A CLI that loops Claude Code, Codex, OpenCode and other agents over a task list or PRD until everything is done
Untether bridges Claude Code, Codex and OpenCode with Telegram: voice or text tasks, live progress, approvals with buttons.
README in short
The project introduces a robot-use agent that uses a robot the way a computer-use agent uses a computer. The README covers quick start, ways to work, supported robots and simulators and links the paper.