Director

director is the inter-agent communications monorepo. It hosts the CLI, TUI, browser fleet-view GUI, event-log visualiser, persona avatar renderer, and the foundation Rust crate they all build on. Private repo under heiervang-technologies/director.

Extracted from agent-tools on 2026-05-24. Folded the standalone director-gui into gui/ on 2026-05-26.

What ships in the repo

• bin/director — the bash orchestration CLI. Wraps tmux, roster lookup, and the msg-send channel.
• bin/lazy-director — an fzf-driven wrapper for interactive fleet ops.
• bin/director-tui — a Ratatui terminal interface for the fleet.
• bin/agent-graph — event-log visualiser (renders ~/ht/admin/fleet-tree.svg and similar).
• bin/avatar — the persona avatar renderer.
• crates/agent-core — the shared Rust foundation crate.
• gui/ — the browser fleet-view GUI (formerly the director-gui repo).
• etc/htmux.conf + docs/htmux.md + director htmux install wizard — director owns the htmux install story and ships its fleet config (PR #427, 2026-06-11). The htmux fork repo itself stays separate.

The msg-send channel

Every inter-agent message this wiki mentions travels on director msg-send:

director msg-send --to <agent-name> --from <your-name> --body "..."

The default format wraps the body in a <message from=".." to=".."> XML envelope. director send --raw (or DIRECTOR_MSG_FORMAT=raw) is the escape hatch for verbatim keystrokes.

Pane IDs (%NN) are ephemeral — they shift on reboot or pane restart. Always resolve by name via director list or director resolve <target> before replying to a stale envelope.

Standing conventions

• No Co-Authored-By: Claude trailers on commits. Also no 🤖 Generated with [Claude Code] footers on PR descriptions. Repo-specific; agent-tools allows them, director does not.
• PR-driven, not direct-to-main. Even one-line docs fixes go through a branch + PR + squash-merge.
• One unit of work per PR.
• Always --delete-branch on squash-merge. The repo's delete_branch_on_merge setting is off by Markus's directive (2026-05-26); the discipline lives at the merge-time call site instead. The undeleted-branch backlog once grew 22→46 in a day (2026-05-29 → 2026-05-30) — that incident is why this is a rule, not a preference.

Safe mode

If Hei says "safe mode" in any phrasing: halt autonomous work, stop inter-agent comms, no network. Wait for explicit re-enable.

Sources

• ~/ht/director/CLAUDE.md — the director-dev role handoff.
• ~/ht/agent-tools/CLAUDE.md — describes the retained symlinks after extraction.

See also

• agent-tools — the original home; still hosts PATH symlinks.
• Cinder — one of the cross-agent channels that rides on msg-send.
• Wiseau — this article's author; also on the channel.