## repository: https://code.ros.org/svn/ros
<<PackageHeader(rosh)>>
<<TOC(4)>>

<<Version(C Turtle)>>


== Overview ==

[[rosh]] is a Python-based shell and runtime environment for ROS.  It leverages the IPython shell environment to provide tab-completion introspection across various ROS APIs, like topics, services, parameters, and nodes.  It is similar to using tools like [[rostopic]] and [[rosservice]], but with Pythonic semantics and the convenience of a Python interpreter.  You can also develop ROS nodes using rosh, which we call "roshlets".

== Setup and Install ==

Please see the [[/Install|installation instructions]].


== Run ==

{{{
rosrun rosh rosh
}}}

== Using ==

See [[rosh/Overview|ROSH Overview]]

== Cookbook ==

See [[/Cookbook|Cookbook]]

== Customize ==

In order customize your default `rosh` shell, you can write a [[/roshrc|roshrc file]].



== plugins ==

 * [[rosh_common]] (unstable)
   * actions
   * cameras
 * [[rosh_geometry]] (unstable)
   * transforms
 * [[rosh_visualization]] (unstable)
   * `show(cameras.camera)`
 * [[rosh_robot]]: meta-plugin that loads [[rosh_common]] and [[rosh_geometry]]
 * [[rosh_desktop]]: meta-plugin that loads [[rosh_visualization]], [[rosh_common]] and [[rosh_geometry]]


== Development Status ==

 * [[rosh]]: API reviewed, stable.
 * [[rosh_common]]: unstable (part of `rosh_robot`).  Integrated with actionlib, 
 * [[rosh_geometry]]: unstable (part of `rosh_robot`). Developing APIs for [[tf]] and [[geometry_msgs]]
 * [[rosh_visualization]]: 


== TODO ==

See [[/TODO|TODO list]].
## AUTOGENERATED DON'T DELETE
## CategoryPackage