ntm

NTM v1.5.0

Named Tmux Manager - Orchestrate AI coding agents in tmux sessions with beautiful TUI interfaces.

Quick Install

# One-liner install (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash

# Homebrew (macOS/Linux)
brew install dicklesworthstone/tap/ntm

# Go install
go install github.com/Dicklesworthstone/ntm/cmd/[email protected]

Shell Integration

Add to your shell rc file:

eval "$(ntm init zsh)"   # for zsh
eval "$(ntm init bash)"  # for bash
eval "$(ntm init fish)"  # for fish

Changelog

Features

• fb80111fe6b9bbdadff4c59eaca34b5d291a5569: feat(agents): add agent capability profiles for intelligent task assignment (ntm-pryz) (@Dicklesworthstone)
• 1cef4e1afe09b5a262a7632162e060f7d4afdb1f: feat(checkpoint): implement checkpoint restoration (@Dicklesworthstone)
• 15a238f009e315d9260f9265e5874e8b83fb1d5d: feat(cli): add checkpoint restore command with latest support (ntm-5oxc) (@Dicklesworthstone)
• f58ceefcccad954cd4997ec8f39e9deb131712c7: feat(cli): add memory privacy commands for cross-agent settings (ntm-xpje) (@Dicklesworthstone)
• 42250ba2ee51f10d7c0d50c189f7dc0b4243b1e1: feat(cli): add ntm cass preview command (ntm-og0u) (@Dicklesworthstone)
• 8a3038f05bd9a48aa621ffdb55fe190cf5db4a06: feat(cli): add spawn order context for agent coordination (ntm-39os) (@Dicklesworthstone)
• e436ee946524b2a44697bf0264f353b82a1d9df1: feat(cli): complete beads daemon and memory integration (@Dicklesworthstone)
• 11ba6b7348fb6b3a8aed4c967e792e04abec6b16: feat(cm): add CASS Memory server integration and CLI commands (@Dicklesworthstone)
• d22708f9052677d40251ddeac6c6e466993d9de6: feat(config): add CASS injection configuration (ntm-1pnr) (@Dicklesworthstone)
• 44983bd849ba4e2e4286ff9e3a48ffa7f8574994: feat(config): add health monitoring configuration schema (@Dicklesworthstone)
• f75fe821dfe11f865bbc672a1a46c495d85f537e: feat(context): add ContextPackBuilder for agent task assignment (ntm-y700) (@Dicklesworthstone)
• 73b7359e9216841f753d62211a80fe8b71e4ba56: feat(coordinator): add session coordinator package for multi-agent workflows (@Dicklesworthstone)
• eb7e0d954140d4e89b284d23c1f98311d53c4f1a: feat(dashboard): add routing info to metrics panel (ntm-i9sw) (@Dicklesworthstone)
• bfc7ab6c491675d53f1a1479520cef821db7a3a9: feat(dashboard): display profile names prominently in pane cards (ntm-wm0c) (@Dicklesworthstone)
• 61b391d8ce5e086be146cec2e945aea46b186f66: feat(message): add read and ack commands for unified messaging (ntm-i5nz) (@Dicklesworthstone)
• 1e66d552f73f9e213aaa9cfb54c77abe3bc8bd9c: feat(messaging): add unified messaging via ntm message command (@Dicklesworthstone)
• 91d28ca5b8621c896572d44e13cc62e598a3a1f1: feat(metrics): add Success Metrics Tracking system (ntm-crjq) (@Dicklesworthstone)
• dcdfb91d78d73b633b8a90a9e219565c1dd3241b: feat(pipeline): add multi-channel notification system (@Dicklesworthstone)
• 79adeb69ecb71142353e35bf102b52569b42be0f: feat(pipeline): add resume and cleanup commands for state persistence (@Dicklesworthstone)
• 0fe14ce2ca426da6aa2069a680cd7dc19b1f7be4: feat(pipeline): enhance error handling with dependency tracking (ntm-9t8y) (@Dicklesworthstone)
• edbd42e8980886f7b00a1b3401302eb96bb9c545: feat(pipeline): implement loop constructs for workflows (ntm-tclz) (@Dicklesworthstone)
• ce9e289f9b297a40f434edb32b2c8632e5e83933: feat(pipeline): implement notification system for workflow events (@Dicklesworthstone)
• acc3c145e65a9efb46848114b2225d54396a4b2d: feat(profile): add dynamic profile switching command (ntm-mjot) (@Dicklesworthstone)
• ac7afaeacf16870a4e67168bc0e1a5f0208de64d: feat(robot): add --robot-alerts and --robot-beads-list for TUI parity (@Dicklesworthstone)
• 30b9f1a2f4ac84a404d6e7c2584644f8b427de71: feat(robot): add CASS injection to robot API (ntm-gdf8) (@Dicklesworthstone)
• 00a98c358235eaab07b331abd9d1c9ba49cde181: feat(robot): add CASS relevance filtering (ntm-mpw1) (@Dicklesworthstone)
• 30cd6e3af3e77af651b1083a284a13de8ca261fa: feat(robot): add CASS topic filtering for relevance scoring (ntm-gr5b) (@Dicklesworthstone)
• c3347050cae67159907ef10288eb8dcc6bf51c1d: feat(robot): add TUI parity commands for AI agent integration (@Dicklesworthstone)
• 004e66abc6af94164feb5bfd7231dee165c9e26a: feat(robot): add bead management robot commands (@Dicklesworthstone)
• 3f2643dd70b89dcca0ae4c74e5fe8a9c850ee87c: feat(robot): add file conflict detection for multi-agent coordination (ntm-1m1m) (@Dicklesworthstone)
• 68a46037ffc01ae1bfa6b65843298987588ef450: feat(robot): implement CASS context injection (ntm-pd0d) (@Dicklesworthstone)
• 00c660807b5dbb4d5973777644ac15453f2a24fe: feat(robot): implement pre-send CASS query for context injection (ntm-gad0) (@Dicklesworthstone)
• f942bb25eafa2676e56f27eb6e8a5235286098f2: feat(routing): integrate Agent Mail file reservations (ntm-03ae) (@Dicklesworthstone)
• 3e5b93da8ec83921d2c82e9cf1af9219731102a8: feat(server): add host binding, log directory, and poll interval config (@Dicklesworthstone)
• 745cd926b4537065a4d903a1efc561b23b25e9dc: feat(supervisor): add bd daemon integration and health command support (@Dicklesworthstone)
• e483998a486ce853a8b222e868c68574d30198f0: feat(tui): add spawn progress panel with real-time countdown (@Dicklesworthstone)
• fff4377f526f570607b8f8945fe52cb6160f588f: feat(upgrade): add SHA256 checksum verification for downloads (ntm-chv5.2) (@Dicklesworthstone)
• 0c123ed295c95289917f3bb60bebaebc11d8bc72: feat(upgrade): add download progress indicator (ntm-chv5.3) (@Dicklesworthstone)
• e56a21c4e6c3c5c88353194039867c8470cbbcf2: feat(upgrade): add post-upgrade binary verification (ntm-chv5.1) (@Dicklesworthstone)
• 0d2564f22a290b611faba97d0d05d01435955aaa: feat(upgrade): add structured diagnostic error messages (ntm-21mz) (@Dicklesworthstone)

Bug Fixes

• cc12e86710d79582ac725670d3481158c7e730fc: fix(agentmail): improve message lookup and enforce strict loading (@Dicklesworthstone)
• 1d9438b2cea07d70ac9989f0dcd71c2f9fed0aa2: fix(cli): handle edge cases in cass preview helpers (@Dicklesworthstone)
• 4678cd534615f07acc1b38b47e37c76f14e59c07: fix(context): improve JSON parsing for robot mode context output (@Dicklesworthstone)
• 3aed3e0ec3a1dee202babd512eca2fa9488e35d1: fix(coordinator): address code review issues (@Dicklesworthstone)
• 333b070c212ae7a3d68b42f204ab9d54d4576925: fix(coordinator): prevent panic on empty slice and optimize string length check (@Dicklesworthstone)
• b2f1497ba9ebd93ca74b4b740b2203743be741b5: fix(pipeline): improve output extraction robustness (@Dicklesworthstone)
• 405ef36891392fffe193ec8d8de19c2265ea5370: fix(pipeline): improve output extraction robustness (@Dicklesworthstone)
• 662a98d3efeff1a25295b27ed540f1d8d2d37518: fix(pipeline): propagate failed status to skipped transitive deps (@Dicklesworthstone)
• e993fa8c0233a0f8d5628ee44d11811cd8a8e715: fix(policy): allow git push --force-with-lease as safe operation (@Dicklesworthstone)
• 3b766c0d09010191ba3b7f9fde28d332787141b9: fix(profiler): add MaxSpans limit to prevent unbounded memory growth (@Dicklesworthstone)
• ede76435c6688ff86a4f4c9c643010f5d33cba96: fix(robot): address bugs in CASS context injection (@Dicklesworthstone)
• f978934e6984bc777371b12c3c4d5b0788119fb5: fix(robot): correct JSON parsing in bead commands (@Dicklesworthstone)
• c577c9a2e9d4500c677daa24a7b8a1e828bbfe2b: fix(robot): correct test function name typo (@Dicklesworthstone)
• e1756b2a5699a66c1120087b958b3f0b02393787: fix(status): prevent generic > pattern from matching agent-specific prompts (@Dicklesworthstone)
• 0c9cf79daf711a275612b66608822d6aae4ce2d6: fix(supervisor): cross-platform process handling for Windows builds (@Dicklesworthstone)
• f4a4f7409490138637c80098defd9e5d20a4112a: fix(tui): add bounds checking and error state test coverage (@Dicklesworthstone)
• 8f1fcf484d23b538e81cc6085bd9652ffda1623a: fix(upgrade): capture exact semantic matches in ClosestMatch (@Dicklesworthstone)
• d033d1601af9851679fa703026216c997fc32ac6: fix(upgrade): clear progress line for unknown Content-Length (@Dicklesworthstone)
• f94443e428a563de0ec5382f2799a0c29554b98d: fix(upgrade): display Reason field in close match diagnostics (@Dicklesworthstone)
• d851888e5c9e033e6c53d32fc2d93030a02a20b6: fix(upgrade): improve asset name parsing and matching (@Dicklesworthstone)
• 020ba4ddb606b98db2ca59bcb35726eebe30e351: fix(util): improve ExtractNewOutput overlap detection and add tests (@Dicklesworthstone)
• 4e1dae5cedd2a6fee808d03725c3c5aed5718938: fix: TestRobotHealthFlagParsing now actually asserts behavior (@Dicklesworthstone)
• deee7273c89517a84702ec5f872455121e0cdb55: fix: address staticcheck findings and code quality issues (@Dicklesworthstone)
• c25ffd05cfa208b258ab9704d61c503d479f066c: fix: correct agent type translation, path parsing, and log message (@Dicklesworthstone)
• e777e1569dbbefc80be9b74d50d06c8434fd3f78: fix: correct documentation and add defensive check (@Dicklesworthstone)
• e41e9f5e70f664ee3008a8f38e17ffc0579c48ef: fix: correct test struct definitions and improve upgrade error handling (@Dicklesworthstone)
• ce8920c0f659c41e86254dbfe0a994cffdc48111: fix: improve JSON parsing in integration tests (@Dicklesworthstone)
• cb37068081c76143dce98a8cbb9c4d7d3eb6c929: fix: improve close match detection for all architectures (@Dicklesworthstone)
• 0e2062a3e35e7492914982bb3497f9950a7848b7: fix: multiple bug fixes in context pack and unified messaging (@Dicklesworthstone)
• 59f77d26410b3359df6662eb5b3ae26954bebdf3: fix: pipeline nil check, persona name validation, atomic state writes (@Dicklesworthstone)
• e28a585f0fe99c99f13697073ed8873b1061c6d3: fix: resolve remaining staticcheck findings (@Dicklesworthstone)
• e759fe1dd7b1d8a818356af06a81e1edd2de1a98: fix: upgrade command asset matching for GoReleaser archives (@Dicklesworthstone)

Performance

• eaeb05b6bc36a2308a47ea20bf17969792e367bb: perf(concurrency): parallelize agent setup and limit tmux queries (@Dicklesworthstone)
• 127515d7eade1d95358740e62220ad4eff9b39ed: perf(io): optimize file I/O for large files and command output (@Dicklesworthstone)
• 5bd241fad3d69d054fccfc669259badd643f3c74: perf(watcher): reduce lock contention in Add and addRecursive methods (@Dicklesworthstone)

Documentation

• 4f68962bfbc7577458acac54668507f0fe3751da: docs(readme): add TUI parity robot commands to documentation (@Dicklesworthstone)
• 859e3355dd3837eb26008cc9d7b6509b49642a61: docs(readme): add comprehensive documentation for state detection, alerts, and work assignment (@Dicklesworthstone)
• 15b4ff4f83cc5821a379c156ad21d29cbf2aeea7: docs(robot): clarify summary computation comment in PrintBeadsList (@Dicklesworthstone)
• c18b34e56e05774ab782b06b46d0578647dd4828: docs(routing): fix misplaced comment above ReservationWarning (@Dicklesworthstone)

Others

• 53c82d44ef7b5dbdeb71976e5b2452ae2d03ed4a: chore(beads): add upgrade protection system epic and task beads (@Dicklesworthstone)
• 80e23a6be454381fc273d874218d8c6dcf5cc0b6: chore(beads): comprehensive upgrade protection beads with full documentation (@Dicklesworthstone)
• 3ba0129836c745896f10f3f3bab4b8aaad6016f9: chore(beads): sync closed beads (ntm-966p, ntm-ctey) (@Dicklesworthstone)
• a06305b24bbe2b43ca13ab4710fbee86e5832ab7: refactor(pipeline): use util package for text helpers (@Dicklesworthstone)
• cb057c55a3f23e2bd2530f785b47e21da5d09cd6: refactor(plugins): use strings.Contains instead of custom helper (@Dicklesworthstone)
• 489d13e6c6b1bd70b4da0c5ec7daf9d993ab7cd4: refactor(status): add Analyze method to UnifiedDetector (@Dicklesworthstone)
• 4eb2433c44e8af6808f75cdab85ddac037ad88d1: refactor(status): consolidate status detection logic (@Dicklesworthstone)
• 140ea2714134f39f89b2ce4ca4b75a7089324b51: refactor(storage): consolidate atomic writes to util.AtomicWriteFile (@Dicklesworthstone)
• e043b7abf58c7216d7a964c95e6ef5961ef6e045: test(e2e): add --robot-files command tests (ntm-zei3) (@Dicklesworthstone)
• cc60f4d898637e7db4c993cefb04218a8076ac04: test(e2e): add --robot-inspect-pane command tests (ntm-ux4w) (@Dicklesworthstone)
• 795a8848a2a3a3b9336284f4b398caf332e27a63: test(e2e): add --robot-metrics and --robot-replay tests (ntm-z7ks) (@Dicklesworthstone)
• 24e13505a646ed04a468518d9319eea706c60b31: test(e2e): add --robot-palette command tests (ntm-yyvm) (@Dicklesworthstone)
• 663d2561998406b32751301ab3e5552ac756d6b2: test(e2e): add TUI parity robot command tests (@Dicklesworthstone)
• 1ba0af84c0c99a93c8ef5746cb8e43792ca0d03d: test(pipeline): add Duration unmarshal and schema validation tests (@Dicklesworthstone)
• 5d5af415fe431ece678c1efdd5570316d23939e6: test(pipeline): add edge case tests for conditions and variables (@Dicklesworthstone)
• 78b74b3acf95122250ea33272afbcea76d9ae4db: test(pipeline): add parser, variables, and robot API tests (@Dicklesworthstone)
• 181b3502f5c84440a5f443f5abb2440b60c5f974: test(pipeline): add shouldRerunStep and clearStepVariables tests (@Dicklesworthstone)
• 8f11fa2fda8bffd349935899662383a47cb4d62f: test(pipeline): add test case for cancelled event notification (@Dicklesworthstone)
• 3fe231a028ab94c731eaf6ae852987e1939e4cef: test(pipeline): improve notification test coverage (@Dicklesworthstone)
• a045be7bce423a1b7e546555e80c007c52179d5f: test(plugins): add comprehensive unit tests for plugins package (ntm-3dx8) (@Dicklesworthstone)
• c6063cbb82e7be86cd5aae9ea14b0fd85ba4b554: test(robot): add comprehensive health monitoring tests (@Dicklesworthstone)
• 9427337e2cbb7d9f4f1976f82beb7c577f808421: test(robot): add comprehensive unit tests for tui_parity.go (@Dicklesworthstone)
• 9b3fa33a83e0930e26dbb7e0d4f8f948899de5ad: test(robot): add multi-item count test for minimal format (@Dicklesworthstone)
• d6910fadae7619bc1f927c9ef7b662119020a97e: test(robot): comprehensive CASS injection test suite (ntm-aoxx) (@Dicklesworthstone)
• bc205747836939505cb64a3740993138e7e10e3c: test(session): add comprehensive unit tests for session package (ntm-kh1j) (@Dicklesworthstone)
• 87db6d3bc4deb52d84d58ed92da0833bac4ae02f: test(session): add session recovery helper tests (ntm-zg1q) (@Dicklesworthstone)
• 1f2b8b6fb6cf0fd0771b6340bc7008be7ccd7bac: test(state): add error checking to test setup code (@Dicklesworthstone)

Full Changelog: https://github.com/Dicklesworthstone/ntm/compare/v1.4.1...v1.5.0

Container Image: ghcr.io/dicklesworthstone/ntm:v1.5.0