Dicklesworthstone/ntm v1.0.0 on GitHub

NTM v1.0.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/ntm@v1.0.0

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

4e2f305: feat(agentmail): auto-register sessions as Agent Mail agents (ntm-yxa) (Jeff Emanuel jeff141421@gmail.com)
db8c059: feat(agentmail): implement Human Overseer messaging for ntm mail (Jeff Emanuel jeff141421@gmail.com)
1572f55: feat(agentmail): implement ListReservations API for file locks (Jeff Emanuel jeff141421@gmail.com)
e043de2: feat(alerts): add ProjectsDir config and pre-compile detection patterns (Jeff Emanuel jeff141421@gmail.com)
e13fab4: feat(alerts): implement alert generation and tracking system (ntm-rlp) (Jeff Emanuel jeff141421@gmail.com)
dbd0af8: feat(analytics): improve token estimation aggregation (Jeff Emanuel jeff141421@gmail.com)
3ba0c4c: feat(bv): add beads summary and preview functions (Jeff Emanuel jeff141421@gmail.com)
b259085: feat(bv): add internal/bv package for beads_viewer integration (ntm-r2k) (Jeff Emanuel jeff141421@gmail.com)
3fb3328: feat(checkpoint): add auto-checkpoint on risky operations (ntm-7zx4) (Jeff Emanuel jeff141421@gmail.com)
6e67640: feat(cli): add --context flag for file content injection (ntm-8h3.1) (Jeff Emanuel jeff141421@gmail.com)
baf63e5: feat(cli): add --profile-startup flag for startup timing analysis (ntm-gin) (Jeff Emanuel jeff141421@gmail.com)
821ca15: feat(cli): add --robot-graph flag and status import (Jeff Emanuel jeff141421@gmail.com)
25f6431: feat(cli): add --robot-spawn for structured session creation (ntm-oln) (Jeff Emanuel jeff141421@gmail.com)
522dff9: feat(cli): add analytics command for session usage statistics (Jeff Emanuel jeff141421@gmail.com)
306b0e2: feat(cli): add extract command and minor improvements (Jeff Emanuel jeff141421@gmail.com)
103d7f9: feat(cli): add model specifier parsing for spawn command (ntm-057) (Jeff Emanuel jeff141421@gmail.com)
77aaf4f: feat(cli): add model variant support to add command (Jeff Emanuel jeff141421@gmail.com)
d67df46: feat(cli): add ntm git status command (ntm-e12d) (Jeff Emanuel jeff141421@gmail.com)
21dafee: feat(cli): add ntm git sync command (ntm-f5ur) (Jeff Emanuel jeff141421@gmail.com)
fa30ffb: feat(cli): add ntm grep command for pane output search (Jeff Emanuel jeff141421@gmail.com)
b88be73: feat(cli): add ntm grep command for pane output search (ntm-jar.1) (Jeff Emanuel jeff141421@gmail.com)
8af6eb1: feat(cli): add ntm history command for prompt management (ntm-pp5.4) (Jeff Emanuel jeff141421@gmail.com)
e9d55d1: feat(cli): add ntm personas list/show commands (ntm-8js) (Jeff Emanuel jeff141421@gmail.com)
ed832de: feat(cli): add ntm recipes command for managing session presets (Jeff Emanuel jeff141421@gmail.com)
e4cb912: feat(cli): add ntm recipes list/show commands (ntm-7lh) (Jeff Emanuel jeff141421@gmail.com)
155cd7a: feat(cli): add ntm scan command for UBS integration (Jeff Emanuel jeff141421@gmail.com)
07c967a: feat(cli): add recipe support to spawn and bead-limit to robot-snapshot (Jeff Emanuel jeff141421@gmail.com)
ee9a1c6: feat(cli): add session activity tracking on attach (ntm-yxa) (Jeff Emanuel jeff141421@gmail.com)
97544ae: feat(cli): add session persistence commands and improve scanner bridge (Jeff Emanuel jeff141421@gmail.com)
eae760a: feat(cli): add variant tracking to add command output (Jeff Emanuel jeff141421@gmail.com)
a16cb9f: feat(cli): add variant-aware targeting for send command (Jeff Emanuel jeff141421@gmail.com)
d04027e: feat(cli): integrate status detection into ntm status output (Jeff Emanuel jeff141421@gmail.com)
05f47cf: feat(cli): propagate variant field to JSON output in create and status (Jeff Emanuel jeff141421@gmail.com)
99c68a3: feat(codeblock): add markdown code block parser (Jeff Emanuel jeff141421@gmail.com)
25950e9: feat(config): add UBS scanner configuration (Jeff Emanuel jeff141421@gmail.com)
7a82a2b: feat(config): add comprehensive tests for agent command templates (ntm-n95) (Jeff Emanuel jeff141421@gmail.com)
eac9904: feat(config): add models section to config show output (Jeff Emanuel jeff141421@gmail.com)
6c00a0c: feat(dashboard): add context usage status to pane cards (ntm-nxf) (Jeff Emanuel jeff141421@gmail.com)
eb68871: feat(dashboard): add health badge showing bv drift status (Jeff Emanuel jeff141421@gmail.com)
0bcb773: feat(dashboard): add split view rendering for wide terminals (Jeff Emanuel jeff141421@gmail.com)
faf5254: feat(dashboard): complete health badge rendering and message handling (Jeff Emanuel jeff141421@gmail.com)
5571208: feat(dashboard): integrate compaction detection and auto-recovery (ntm-4pp.5.3) (Jeff Emanuel jeff141421@gmail.com)
f223fe6: feat(dashboard): integrate responsive layout system (Jeff Emanuel jeff141421@gmail.com)
3e0df4d: feat(events): add JSONL event logging framework (Jeff Emanuel jeff141421@gmail.com)
c5a5ed5: feat(extract): add --copy, --apply, and --select flags (ntm-jar.2) (Jeff Emanuel jeff141421@gmail.com)
9ef0bbe: feat(health): add agent progress detection and rate limit enhancements (Jeff Emanuel jeff141421@gmail.com)
d277455: feat(health): add comprehensive agent health checking system (Jeff Emanuel jeff141421@gmail.com)
9dd88ba: feat(health): add rate limit detection with wait time parsing (Jeff Emanuel jeff141421@gmail.com)
6695c25: feat(history): add internal/history package for prompt history (ntm-pp5.1.1) (Jeff Emanuel jeff141421@gmail.com)
d1674e3: feat(hooks): add command hooks config loader (ntm-spa) (Jeff Emanuel jeff141421@gmail.com)
9cdf6bc: feat(hooks): add pre/post-send hooks and documentation (ntm-qen, ntm-1qd) (Jeff Emanuel jeff141421@gmail.com)
9a3bc45: feat(notify): add multi-channel notification system for NTM events (Jeff Emanuel jeff141421@gmail.com)
a66c313: feat(persona): add persona configuration schema (ntm-hzl) (Jeff Emanuel jeff141421@gmail.com)
7ccf8e5: feat(profiler): add internal/profiler package for timing instrumentation (ntm-1rz) (Jeff Emanuel jeff141421@gmail.com)
12407a6: feat(recovery): add dependency/blocker summary to recovery prompts (Jeff Emanuel jeff141421@gmail.com)
f4f5fca: feat(resilience): add auto-restart for crashed agents (ntm-84t) (Jeff Emanuel jeff141421@gmail.com)
71cfce7: feat(robot): add --robot-ack for send confirmation tracking (ntm-a8q) (Jeff Emanuel jeff141421@gmail.com)
f865dd8: feat(robot): add --robot-graph flag and enhance plan with bead actions (Jeff Emanuel jeff141421@gmail.com)
41598cb: feat(robot): add --robot-interrupt for priority course correction (Jeff Emanuel jeff141421@gmail.com)
6244ea3: feat(robot): add --robot-recipes flag for JSON recipe listing (Jeff Emanuel jeff141421@gmail.com)
db4ecae: feat(robot): add --robot-terse flag for ultra-compact output (Jeff Emanuel jeff141421@gmail.com)
b98a795: feat(robot): implement PrintTerse and TerseState for --robot-terse (Jeff Emanuel jeff141421@gmail.com)
74365a1: feat(scan): integrate beads bridge into scan command (Jeff Emanuel jeff141421@gmail.com)
4265824: feat(scanner): add UBS (Ultimate Bug Scanner) Go integration (Jeff Emanuel jeff141421@gmail.com)
af3ec8b: feat(scanner): add UBS to Beads bridge for automatic issue creation (Jeff Emanuel jeff141421@gmail.com)
d185e2f: feat(send): emit prompt_send event for analytics tracking (Jeff Emanuel jeff141421@gmail.com)
6129bc1: feat(send): integrate history logging into send command (ntm-pp5.1.2) (Jeff Emanuel jeff141421@gmail.com)
04e91a6: feat(send): integrate history logging into send command (ntm-pp5.1.2) (Jeff Emanuel jeff141421@gmail.com)
cbff2a1: feat(session): add session state capture and restoration infrastructure (Jeff Emanuel jeff141421@gmail.com)
95e5345: feat(spawn): implement model-specific agent spawning with variant support (Jeff Emanuel jeff141421@gmail.com)
0136519: feat(spawn): integrate event logging and fix alerts config (Jeff Emanuel jeff141421@gmail.com)
c242f96: feat(status): add bead context to compaction recovery prompts (Jeff Emanuel jeff141421@gmail.com)
4be24a4: feat(status): add compaction detection for AI agents (ntm-4pp.5.1) (Jeff Emanuel jeff141421@gmail.com)
69353a4: feat(status): add recovery prompt sender for compaction events (ntm-4pp.5.2) (Jeff Emanuel jeff141421@gmail.com)
a4dfe4f: feat(status): improve agent prompt detection reliability (Jeff Emanuel jeff141421@gmail.com)
79901ad: feat(templates): add prompt template system with variable substitution (Jeff Emanuel jeff141421@gmail.com)
1fa1295: feat(testing): add assertions, skip conditions, and self-tests (ntm-66c) (Jeff Emanuel jeff141421@gmail.com)
a7c8cd7: feat(testing): add test harness with structured logging (ntm-66c) (Jeff Emanuel jeff141421@gmail.com)
d48af24: feat(theme): add semantic color palette for consistent UI styling (Jeff Emanuel jeff141421@gmail.com)
460d623: feat(tui): add responsive layout system for ultra-wide displays (Jeff Emanuel jeff141421@gmail.com)
fa207e8: feat(tui): add theme-aware badge rendering functions (ntm-17s) (Jeff Emanuel jeff141421@gmail.com)
d68d507: feat(watcher): add file watching with debouncing using fsnotify (Jeff Emanuel jeff141421@gmail.com)
c762bff: feat: add --json support to ntm status command (ntm-rm4) (Jeff Emanuel jeff141421@gmail.com)
c232384: feat: add --json support to spawn/create/add/send commands (ntm-ctt) (Jeff Emanuel jeff141421@gmail.com)
4304a06: feat: add --robot-send and comprehensive robot package tests (Jeff Emanuel jeff141421@gmail.com)
7c58ea3: feat: add Agent Mail config integration and deps status (Jeff Emanuel jeff141421@gmail.com)
d48959b: feat: add Agent Mail server detection and config (ntm-uwa) (Jeff Emanuel jeff141421@gmail.com)
918c2a9: feat: add CASS client types, compaction tests, and bv/cli improvements (Jeff Emanuel jeff141421@gmail.com)
ee351e5: feat: add CASS tests and multi-agent sync (Jeff Emanuel jeff141421@gmail.com)
dcb6814: feat: add agentmail client, robot enhancements, tracker, and status improvements (Jeff Emanuel jeff141421@gmail.com)
99b223d: feat: add command templating and dashboard improvements (Jeff Emanuel jeff141421@gmail.com)
3b691fc: feat: add file watcher debouncer utility (Jeff Emanuel jeff141421@gmail.com)
db11ad5: feat: add interactive tutorial with animated slides (Jeff Emanuel jeff141421@gmail.com)
fc9e9f8: feat: add missing CLI commands (mail, checkpoint, lock, replay, rollback) (Jeff Emanuel jeff141421@gmail.com)
d4ea14d: feat: add rate limit tracking and enhance version output (Jeff Emanuel jeff141421@gmail.com)
cb57dcd: feat: add robot mode for AI agent integration (Jeff Emanuel jeff141421@gmail.com)
7a2c1dd: feat: add self-update command for seamless upgrades (Jeff Emanuel jeff141421@gmail.com)
040f196: feat: add token estimation to analytics and events (Jeff Emanuel jeff141421@gmail.com)
bd81fa9: feat: add unified output formatting and robot mode enhancements (Jeff Emanuel jeff141421@gmail.com)
453b6c3: feat: implement delta snapshot tracking and agent mail integration (Jeff Emanuel jeff141421@gmail.com)

Bug Fixes

7425c40: fix(agentmail): add fallback for legacy list_reservations tool name (Jeff Emanuel jeff141421@gmail.com)
ee36bd8: fix(agentmail): improve session directory handling and security (Jeff Emanuel jeff141421@gmail.com)
18970e6: fix(checkpoint): add milliseconds to IDs to prevent collisions (Jeff Emanuel jeff141421@gmail.com)
68c26b8: fix(checkpoint): correct parseGitStatus for unstaged files and update test expectations (Jeff Emanuel jeff141421@gmail.com)
fe8927b: fix(ci): fix Go 1.25 compatibility issues in CI workflow (Jeff Emanuel jeff141421@gmail.com)
a31edad: fix(cli): refactor send targeting to use variant-aware matching (Jeff Emanuel jeff141421@gmail.com)
af778d3: fix(status): add idle grace period to prevent flickering state (Jeff Emanuel jeff141421@gmail.com)
6c9b16c: fix(tui): resolve edge cases in components and dashboard (Jeff Emanuel jeff141421@gmail.com)
509c91d: fix(tutorial): fix alignment, remove transitions, optimize for wide screens (Jeff Emanuel jeff141421@gmail.com)
d58cdc7: fix(updater): return predictable struct instead of nil on non-200 response (Jeff Emanuel jeff141421@gmail.com)
62914de: fix: CI fixes - goreleaser config, palette pointer returns, and tests (Jeff Emanuel jeff141421@gmail.com)
046c401: fix: address bugs found in deep code review (Jeff Emanuel jeff141421@gmail.com)
9c42d74: fix: address code review issues from peer agent work (Jeff Emanuel jeff141421@gmail.com)
a11a522: fix: cross-platform disk space checking for Windows builds (Jeff Emanuel jeff141421@gmail.com)
3f4e5d6: fix: cross-platform syscall compatibility for Windows/FreeBSD (Jeff Emanuel jeff141421@gmail.com)
016ac0c: fix: improve error resilience in tmux and file watcher (Jeff Emanuel jeff141421@gmail.com)
8c55822: fix: include token estimates in JSON output and fix test (Jeff Emanuel jeff141421@gmail.com)
446febd: fix: minor fixes for send hooks, tmux keys, and scanner dedup (Jeff Emanuel jeff141421@gmail.com)
ef159f5: fix: prevent duplicate pane titles in 'add' command (Jeff Emanuel jeff141421@gmail.com)
93f7a1f: fix: remove duplicate mail command registration (Jeff Emanuel jeff141421@gmail.com)
6efee9d: fix: resolve compilation errors and improve code quality (Jeff Emanuel jeff141421@gmail.com)
5056964: fix: specify archive id for homebrew formula (Jeff Emanuel jeff141421@gmail.com)
6cd733a: fix: use script file for nfpm postinstall (Jeff Emanuel jeff141421@gmail.com)

Others

5df7338: Add initial project structure and configuration files for NTM (Jeff Emanuel jeff141421@gmail.com)
155b458: build: add comprehensive CI/CD pipeline and release infrastructure (Jeff Emanuel jeff141421@gmail.com)
9f2dcef: build: disable Docker builds in GoReleaser (Jeff Emanuel jeff141421@gmail.com)
b24df0d: build: promote fsnotify and runewidth to direct dependencies (Jeff Emanuel jeff141421@gmail.com)
ac58aa1: build: upgrade to Go 1.25 and modernize install script (Jeff Emanuel jeff141421@gmail.com)
59b9ae1: chore(beads): close completed tasks (Jeff Emanuel jeff141421@gmail.com)
2911698: chore(beads): close ntm-4pp.2 and ntm-i0zz (Jeff Emanuel jeff141421@gmail.com)
e635a3a: chore(beads): close ntm-gin, ntm-1rz (profiler + profile-startup flag) (Jeff Emanuel jeff141421@gmail.com)
038fb28: chore(beads): close ntm-vttg event logging framework (Jeff Emanuel jeff141421@gmail.com)
be8a74a: chore(beads): sync issue status updates (Jeff Emanuel jeff141421@gmail.com)
d350633: chore(beads): sync issue status updates (Jeff Emanuel jeff141421@gmail.com)
bed4a7e: chore(beads): sync issue status updates (Jeff Emanuel jeff141421@gmail.com)
bb1cf79: chore(beads): sync issue status updates (ntm-i5m, ntm-3bb) (Jeff Emanuel jeff141421@gmail.com)
16ae927: chore(beads): sync issue tracking state (Jeff Emanuel jeff141421@gmail.com)
09c17f5: chore(beads): sync issue tracking state (Jeff Emanuel jeff141421@gmail.com)
be21d3c: chore(beads): sync issue tracking state - close ntm-a8q (Jeff Emanuel jeff141421@gmail.com)
278b1dd: chore(beads): sync issue tracking state - close ntm-zu7j (Jeff Emanuel jeff141421@gmail.com)
5b6ca80: chore(beads): sync ntm-7pl completion and CASS task demotions (Jeff Emanuel jeff141421@gmail.com)
b9ee8fc: chore(beads): sync state - close ntm-4pp.4 (Jeff Emanuel jeff141421@gmail.com)
38e7ce8: chore(beads): sync state - close ntm-8h3.1 and ntm-bh5.1 (Jeff Emanuel jeff141421@gmail.com)
b464a2e: chore(cli): register extract command and clean up watch (Jeff Emanuel jeff141421@gmail.com)
715b138: chore(config): integrate notification config and promote go-isatty (Jeff Emanuel jeff141421@gmail.com)
b96ec3f: chore(tmux): remove obsolete pane title reproduction test (Jeff Emanuel jeff141421@gmail.com)
6507e22: refactor(palette): consolidate enhanced features into core model (Jeff Emanuel jeff141421@gmail.com)
cdee3f0: refactor(robot): improve agent type detection and input validation (Jeff Emanuel jeff141421@gmail.com)
ef003d3: refactor(robot): restructure PrintRecipes with detailed agent breakdown (Jeff Emanuel jeff141421@gmail.com)
72e4182: refactor(robot): use bv.BeadsSummary type from bv package (Jeff Emanuel jeff141421@gmail.com)
2fb68eb: refactor(status): simplify idle detection logic (Jeff Emanuel jeff141421@gmail.com)
b5b108b: refactor(test): simplify e2e test contains helper (Jeff Emanuel jeff141421@gmail.com)
bb1a401: security: use restrictive file permissions for tmux.conf (Jeff Emanuel jeff141421@gmail.com)
8676c66: test(bv): add unit tests for internal/bv package (ntm-r2k) (Jeff Emanuel jeff141421@gmail.com)
662fcd7: test(cass): add comprehensive tests for CASS client types and methods (Jeff Emanuel jeff141421@gmail.com)
b663acc: test(cli): add analytics command tests and close ntm-iq1l (Jeff Emanuel jeff141421@gmail.com)
a07e4ad: test(cli): add comprehensive unit tests for internal/cli package (ntm-4op) (Jeff Emanuel jeff141421@gmail.com)
b7ad91c: test(config): add comprehensive unit tests for config package (Jeff Emanuel jeff141421@gmail.com)
e534dcd: test(robot): update tests for PrintSnapshot signature change (Jeff Emanuel jeff141421@gmail.com)
c696519: test(status): add additional recovery manager tests (Jeff Emanuel jeff141421@gmail.com)
e37c0bc: test(status): add unified_test.go and sync beads (Jeff Emanuel jeff141421@gmail.com)
8c829fd: test(theme): add tests for semantic color palette (Jeff Emanuel jeff141421@gmail.com)

Full Changelog: ...v1.0.0

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