Skip to content

Commit

Permalink
Add documentation about catmux script
Browse files Browse the repository at this point in the history
  • Loading branch information
fmauch committed Jan 29, 2024
1 parent 06ca4be commit 1d9d12a
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,20 @@ session, use `tmux -L catmux list-sessions`. You can change the server's name by
in which `catmux_create_session` is started, will be used inside the catmux session (as long as no
other session previously exists on that particular tmux server).

To make things a bit easier, there is a convenience script installed with this
package: [`catmux`](script/catmux). It is basically a wrapper around `tmux -L
<server_name>`. For example, you can

``` bash
catmux attach # attach to the latest running catmux session
catmux ls # list current catmux sessions
catmux kill-session -t example_session # kill session 'target session'
```

In case you use another tmux server than `catmux`, you can set the environment
variable `CATMUX_DEFAULT_SERVER` to that name and continue using the `catmux`
script.

## Migrating from the catkin version of catmux
With the spread of ROS2, the need for a catkin-independent catmux has emerged.
Catmux is now a plain python package without the ROS integration.
Expand Down

0 comments on commit 1d9d12a

Please sign in to comment.