A tmux terminal backend for hive-mcp.
It implements the terminal (ITerminalAddon) and vessel (IVessel) ports, so
lings can run in tmux panes, and drives tmux through the Python
libtmux library via
libpython-clj.
License: MIT.
io.github.hive-agi/hive-tmux {:mvn/version "<version>"}
Published to Clojars. The current version is in VERSION.
The addon needs these at runtime, and none of them comes with the jar:
PATH.python -m pip install libtmux).Pick the interpreter with HIVE_PYTHON_EXECUTABLE (or HIVE_TMUX_PYTHON),
pointing at a Python that has libtmux (for example a conda env). If neither is
set, a conda env under $HOME is auto-detected; failing that, libpython-clj
autodetects one.
If a prerequisite is missing, the vessel stays dormant: the addon mounts, but it reports through its preflight / health status instead of opening panes. That looks the same as "not installed", so check those three items before you treat it as a mount bug.
You do not need to wire anything. The jar ships the manifest
META-INF/hive-addons/hive-tmux.edn (:addon/id "hive.tmux"), and
hive-mcp's classpath manifest scanner mounts it automatically.
:addon/init-ns is hive-tmux.init.:addon/init-fn is addon-ctor, a constructor that returns an IAddon.
The host registers and initializes the addon it returns.init-as-addon! is retained for the legacy loader, which expects the addon to
register itself.Capabilities: :terminal, :health-reporting, :vessel.
The swarm tool discovers Claude Code and Codex terminals through tmux:
{"command":"tmux panes","pane_provider":"codex"}
{"command":"tmux read","pane":"%3","lines":20}
pane_provider defaults to all; claude and codex select one provider.
Each row reports its provider and capabilities. Codex rows expose terminal
identity and the read-screen capability. Task identity, busy/input state,
context usage and goal state remain unknown. Titles are display metadata.
Codex screen reads return terminal text with ANSI escapes removed. Claude screen reads can additionally return parsed state and transcript text. Prompt submission, goal control and compaction currently require Claude Code; automatic compaction sweeps cover Claude panes. A mixed explicit compaction selection containing Codex starts no jobs.
These inspection commands use the tmux CLI and work independently of the Python bridge used to create managed terminal vessels.
clojure -M:test # kaocha; suites in tests.edn
Can you improve this documentation?Edit on GitHub
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |