33[ ![ PyPI] ( https://img.shields.io/pypi/v/hcom )] ( https://pypi.org/project/hcom/ )
44[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg )] ( https://opensource.org/licenses/MIT )
55[ ![ Rust] ( https://img.shields.io/badge/Built_with-Rust-dea584 )] ( https://www.rust-lang.org/ )
6+ [ ![ GitHub stars] ( https://img.shields.io/github/stars/aannoo/hcom )] ( https://github.com/aannoo/hcom/stargazers )
67
78Agents running in separate terminals are isolated from each other. Context doesn't transfer, decisions get repeated, file edits collide.
89
@@ -189,7 +190,7 @@ hcom status # diagnostics
189190<summary >CLI</summary >
190191
191192```
192- hcom (hook-comms) v0.7.0 - multi-agent communication
193+ hcom (hook-comms) v0.7.3 - multi-agent communication
193194
194195Usage:
195196hcom TUI dashboard
@@ -285,13 +286,18 @@ Usage:
285286 --json JSON array of all agents
286287 --names Just names, one per line
287288 --format TPL Template per agent: --format '{name} {status}'
289+ Fields: name, base_name, status, status_context, status_detail,
290+ status_age_seconds, description, unread_count, tool, tag, directory,
291+ session_id, parent_name, agent_id, headless, created_at,
292+ hooks_bound, process_bound, transcript_path, background_log_file,
293+ launch_context
288294
289295 hcom list [self|<name>] Single agent details
290296 [field] Print specific field (status, directory, session_id, ...)
291297 --json Output as JSON
292298 --sh Shell exports: eval "$(hcom list self --sh)"
293299
294- hcom list --stopped [name] Stopped instances (from events)
300+ hcom list --stopped [name] Stopped agents (from events)
295301 --all All stopped (default: last 20)
296302
297303
@@ -456,7 +462,7 @@ Keys:
456462 hcom config <key> --info for details
457463
458464 Precedence: defaults < config.toml < env vars
459- Files: /Users/anno/ .hcom/config.toml, /Users/anno/ .hcom/.env
465+ Files: ~/ .hcom/config.toml, ~/ .hcom/config .env
460466 HCOM_DIR: isolate per project (see 'hcom reset --help')
461467
462468## hooks
@@ -582,7 +588,7 @@ JSON format:
582588## kill
583589
584590Usage:
585- hcom kill <name> [name2 ...] Kill process (+ close terminal pane)
591+ hcom kill <name> Kill process (+ close terminal pane)
586592 hcom kill tag:<name> Kill all with tag
587593 hcom kill all Kill all with tracked PIDs
588594
@@ -917,6 +923,7 @@ Managed (open + close on kill):
917923 kitty auto split/tab/window
918924 wezterm auto tab/split/window
919925 tmux detached sessions
926+ cmux workspaces
920927
921928 Variants:
922929 kitty: kitty-window, kitty-tab, kitty-split
@@ -929,18 +936,25 @@ Other (opens window only):
929936 Ghostty
930937 alacritty
931938 ttab
939+ zellij
940+ waveterm
932941
933942Custom command (open only):
934943 hcom config terminal "my-terminal -e bash {script}"
935944
936945Custom preset with close (~/.hcom/config.toml):
937946 [terminal.presets.myterm]
938947 open = "myterm spawn -- bash {script}"
939- close = "myterm kill --id {id }"
948+ close = "myterm kill --id {pane_id }"
940949 binary = "myterm"
941-
942- {id} = stdout from the open command.
943- {pid} and {process_id} also available.
950+ pane_id_env = "MYTERM_PANE_ID"
951+
952+ Placeholders:
953+ {script} = hcom-generated launch wrapper script path
954+ {pane_id} = pane/window/workspace ID from pane_id_env; falls back to {id}
955+ {process_id} = HCOM_PROCESS_ID for the launched agent
956+ {pid} = launched terminal process ID
957+ {id} = first line of stdout captured from the open command
944958
945959Set: hcom config terminal kitty
946960Reset: hcom config terminal default
0 commit comments