Hermes Tmux Suite
Tmux-integrated skill operations for Hermes Agent.
What It Does
Dispatch a delegate_task subagent and automatically tail its live transcript in
a dedicated tmux pane — watch every step in real time without polluting your working panes.
Skills
| Skill | Description |
|---|---|
tmux-delegate-task |
Dispatch subagent + auto-tail transcript in tmux pane with auto-cleanup |
tmux-socket |
Detect active tmux socket and provide the correct -L/-S flag |
Install
git clone https://github.com/nuffin/hermes-tmux-suite.git
cd hermes-tmux-suite
./install.sh # copy to ~/.hermes/skills/devops/
./install.sh --symlink # symlink for development
Or via pip:
pip install hermes-tmux-suite
Usage
tmux-delegate-task
In Hermes:
> run code review with tmux-delegate-task in the infra session, hermes window
The skill:
- Dispatches
delegate_taskwith your goal - Opens a tmux pane tailing the subagent's live transcript
- Auto-closes the pane when done (unless you say
--keep)
Keep the Pane
By default, auto-created panes are closed when the delegation finishes. Add
--keep to leave the pane open for later review.
> run this with tmux-delegate-task, keep the pane after
> don't close the pane
> --keep
User-provided panes (pane 3) are never closed, regardless of --keep.
tmux-socket
Detects the active tmux socket and provides the correct -L flag — useful when
constructing tmux commands in scripts or other skills.
# Inline one-liner for any script
TMUX_FLAG=$(if [ -n "$TMUX" ]; then \
S=$(tmux display -p '#{socket_path}' 2>/dev/null); \
N=$(basename "$S"); \
[ "$N" != "default" ] && echo "-L $N"; \
fi)
# Then prefix all tmux commands
tmux $TMUX_FLAG new-session -d -s my-session
tmux $TMUX_FLAG send-keys -t my-session:0 "echo hello" Enter
| Socket | basename | TMUX_FLAG |
|---|---|---|
/tmp/tmux-1000/default |
default |
"" (empty) |
/tmp/tmux-1000/nested |
nested |
-L nested |
| Not in tmux | — | "" (empty) |
Pane/Window Defaults
| You say... | session | window | pane |
|---|---|---|---|
| (nothing) | current | current | split new |
| "infra session" | infra | new window | pane 0 |
| "infra session, hermes window" | infra | hermes | split new |
| "infra session, hermes window, pane 3" | infra | hermes | .3 (never close) |
Repositories
| Role | Repo | PyPI |
|---|---|---|
| Skill code (this repo) | hermes-tmux-suite | — |
| Pip wrapper | hermes-tmux-suite-pip | hermes-tmux-suite |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hermes_tmux_suite-1.0.5.tar.gz.
File metadata
- Download URL: hermes_tmux_suite-1.0.5.tar.gz
- Upload date:
- Size: 9.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
944553408d8735139d147623b616d8ede3329f7a91632430d79f12cfbd2e44ba
|
|
| MD5 |
348d74fbaf6e6bc8b2c186ae86722157
|
|
| BLAKE2b-256 |
ae81185a0b9153e362266a84a0864f448c6e5ee353b584cff74fdac89532d85f
|
Provenance
The following attestation bundles were made for hermes_tmux_suite-1.0.5.tar.gz:
Publisher:
publish.yml on nuffin/hermes-tmux-suite-pip
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hermes_tmux_suite-1.0.5.tar.gz -
Subject digest:
944553408d8735139d147623b616d8ede3329f7a91632430d79f12cfbd2e44ba - Sigstore transparency entry: 2255325235
- Sigstore integration time:
-
Permalink:
nuffin/hermes-tmux-suite-pip@c19d6902a69bbcfeb5f3e9fe21a26550148cf509 -
Branch / Tag:
refs/tags/v1.0.5 - Owner: https://github.com/nuffin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c19d6902a69bbcfeb5f3e9fe21a26550148cf509 -
Trigger Event:
push
-
Statement type:
File details
Details for the file hermes_tmux_suite-1.0.5-py3-none-any.whl.
File metadata
- Download URL: hermes_tmux_suite-1.0.5-py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6fddbac351eff57048790ed3fb764e70167b7f074a8de263597caa59d591a012
|
|
| MD5 |
e1b3f5ad3f69cca9e15073843011df40
|
|
| BLAKE2b-256 |
7edb25991a6802e93a66f7be4b1d6ca68ad3050c411d8d09ac76f197b0f2e44b
|
Provenance
The following attestation bundles were made for hermes_tmux_suite-1.0.5-py3-none-any.whl:
Publisher:
publish.yml on nuffin/hermes-tmux-suite-pip
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hermes_tmux_suite-1.0.5-py3-none-any.whl -
Subject digest:
6fddbac351eff57048790ed3fb764e70167b7f074a8de263597caa59d591a012 - Sigstore transparency entry: 2255325270
- Sigstore integration time:
-
Permalink:
nuffin/hermes-tmux-suite-pip@c19d6902a69bbcfeb5f3e9fe21a26550148cf509 -
Branch / Tag:
refs/tags/v1.0.5 - Owner: https://github.com/nuffin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c19d6902a69bbcfeb5f3e9fe21a26550148cf509 -
Trigger Event:
push
-
Statement type:
