Skip to content

Commit f8a3f7f

Browse files
committed
docs: add tmux info
1 parent a5560b2 commit f8a3f7f

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

docs/running.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,30 @@ pixi run -e single-pc-gpu-and-npu demo
1919
> [!TIP]
2020
> If you have a system-installed ROS 2, pass the `--clean-env` flag to `pixi run`, or use Docker for clean isolation. Otherwise the demo may fail to start due to an API/ABI mismatch.
2121
22+
## tmux sessions
23+
24+
Each component runs in its own detached tmux session named
25+
`agentic-mobile-manipulator-<component>` (`-sim`, `-stack`, `-llm-servers`,
26+
`-agents`, `-hmi`). `pixi run demo` starts all of them in the background and prints
27+
the attach commands. Running a single task such as `pixi run sim` attaches you to
28+
its session directly.
29+
30+
Attach to a session from another terminal (swap the suffix for any component):
31+
32+
```shell
33+
tmux attach -t agentic-mobile-manipulator-sim
34+
```
35+
36+
Inside tmux, `Ctrl-b s` lists and switches sessions and `Ctrl-b d` detaches. Stop
37+
every session with:
38+
39+
```shell
40+
pixi run kill
41+
```
42+
43+
To run a component in the foreground instead (no tmux), use its `-fg` variant:
44+
`pixi run sim-fg`, `pixi run stack-fg`, or `pixi run hmi-fg`.
45+
2246
## Run separately
2347

2448
### O3DE

0 commit comments

Comments
 (0)