ntm
starsforks
How to install ntm?
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/ntm
$npx -y skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ntmNamed Tmux Manager - Multi-agent orchestration for Claude Code, Codex, and Gemini in tiled tmux panes. Visual dashboards, command palette, context rotation, robot mode API, work assignment, safety system. Go CLI.
SKILL.md
| 1 | # NTM — Named Tmux Manager |
| 2 | |
| 3 | A Go CLI that transforms tmux into a **multi-agent command center** for orchestrating Claude Code, Codex, and Gemini agents in parallel. Spawn, manage, and coordinate AI agents across tiled panes with stunning TUI, automated context rotation, and deep integrations with the Agent Flywheel ecosystem. |
| 4 | |
| 5 | ## Why This Exists |
| 6 | |
| 7 | Managing multiple AI coding agents is painful: |
| 8 | - **Window chaos**: Each agent needs its own terminal |
| 9 | - **Context switching**: Jumping between windows breaks flow |
| 10 | - **No orchestration**: Same prompt to multiple agents requires manual copy-paste |
| 11 | - **Session fragility**: Disconnecting from SSH loses all agent sessions |
| 12 | - **No visibility**: Hard to see agent status at a glance |
| 13 | |
| 14 | NTM solves all of this with one session containing many agents, persistent across SSH disconnections. |
| 15 | |
| 16 | ## Quick Start |
| 17 | |
| 18 | ```bash |
| 19 | # Install |
| 20 | curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash |
| 21 | |
| 22 | # Add shell integration |
| 23 | echo 'eval "$(ntm init zsh)"' >> ~/.zshrc && source ~/.zshrc |
| 24 | |
| 25 | # Interactive tutorial |
| 26 | ntm tutorial |
| 27 | |
| 28 | # Check dependencies |
| 29 | ntm deps -v |
| 30 | |
| 31 | # Create multi-agent session (agy = Antigravity CLI, NTM-pinned to "Gemini 3.1 Pro (High)") |
| 32 | ntm spawn myproject --cc=2 --cod=1 --agy=1 |
| 33 | |
| 34 | # Send prompt to all Claude agents |
| 35 | ntm send myproject --cc "Explore this codebase and summarize its architecture." |
| 36 | |
| 37 | # Open command palette (or press F6 after `ntm bind`) |
| 38 | ntm palette myproject |
| 39 | ``` |
| 40 | |
| 41 | ## Session Creation |
| 42 | |
| 43 | ### Spawn Agents |
| 44 | |
| 45 | ```bash |
| 46 | ntm spawn myproject --cc=3 --cod=2 --agy=1 # 3 Claude + 2 Codex + 1 Gemini (via agy) |
| 47 | ntm quick myproject --template=go # Full project scaffold + agents |
| 48 | ntm create myproject --panes=10 # Empty panes only |
| 49 | ntm spawn myproject --profiles=architect,implementer,tester |
| 50 | ``` |
| 51 | |
| 52 | ### Agent Flags |
| 53 | |
| 54 | | Flag | Agent | CLI Command | |
| 55 | |------|-------|-------------| |
| 56 | | `--cc=N` | Claude Code | `claude` | |
| 57 | | `--cod=N` | Codex CLI | `codex` | |
| 58 | | `--agy=N` | Antigravity CLI (pinned to "Gemini 3.1 Pro (High)") | `agy` | |
| 59 | | `--gmi=N` | Gemini CLI (legacy, retiring — prefer `--agy=N`) | `gemini` | |
| 60 | |
| 61 | ### Add More Agents |
| 62 | |
| 63 | ```bash |
| 64 | ntm add myproject --cc=2 # Add 2 more Claude agents |
| 65 | ntm add myproject --cod=1 --agy=1 # Add mixed agents |
| 66 | ``` |
| 67 | |
| 68 | ## Sending Prompts |
| 69 | |
| 70 | ```bash |
| 71 | ntm send myproject --cc "Implement user auth" # To all Claude |
| 72 | ntm send myproject --cod "Write unit tests" # To all Codex |
| 73 | ntm send myproject --agy "Review and document" # To all Antigravity (Gemini 3.1 Pro) |
| 74 | ntm send myproject --all "Review current state" # To ALL agents |
| 75 | ntm interrupt myproject # Ctrl+C to all |
| 76 | ``` |
| 77 | |
| 78 | ## Session Navigation |
| 79 | |
| 80 | | Command | Alias | Description | |
| 81 | |---------|-------|-------------| |
| 82 | | `ntm list` | `lnt` | List all tmux sessions | |
| 83 | | `ntm attach` | `rnt` | Attach to session | |
| 84 | | `ntm status` | `snt` | Show pane details with agent counts | |
| 85 | | `ntm view` | `vnt` | Unzoom, tile layout, attach | |
| 86 | | `ntm zoom` | `znt` | Zoom to specific pane | |
| 87 | | `ntm dashboard` | `dash`, `d` | Interactive visual dashboard | |
| 88 | | `ntm kill` | `knt` | Kill session (`-f` to force) | |
| 89 | |
| 90 | ## Command Palette |
| 91 | |
| 92 | Fuzzy-searchable TUI with pre-configured prompts: |
| 93 | |
| 94 | ```bash |
| 95 | ntm palette myproject # Open palette |
| 96 | ntm bind # Set up F6 keybinding |
| 97 | ntm bind --key=F5 # Use different key |
| 98 | ``` |
| 99 | |
| 100 | ### Palette Features |
| 101 | |
| 102 | - Animated gradient banner with Catppuccin themes |
| 103 | - Fuzzy search with live filtering |
| 104 | - Pin/favorite commands (`Ctrl+P` / `Ctrl+F`) |
| 105 | - Live preview pane with metadata |
| 106 | - Quick select with numbers 1-9 |
| 107 | - Visual target selector (All/Claude/Codex/Gemini) |
| 108 | |
| 109 | ### Palette Navigation |
| 110 | |
| 111 | | Key | Action | |
| 112 | |-----|--------| |
| 113 | | `↑/↓` or `j/k` | Navigate | |
| 114 | | `1-9` | Quick select | |
| 115 | | `Enter` | Select command | |
| 116 | | `Esc` | Back / Quit | |
| 117 | | `?` | Help overlay | |
| 118 | | `Ctrl+P` | Pin/unpin | |
| 119 | | `Ctrl+F` | Favorite | |
| 120 | |
| 121 | ## Interactive Dashboard |
| 122 | |
| 123 | ```bash |
| 124 | ntm dashboard myproject # Or: ntm dash myproject |
| 125 | ``` |
| 126 | |
| 127 | ### Dashboard Features |
| 128 | |
| 129 | - Visual pane grid with color-coded agent cards |
| 130 | - Live agent counts (Claude/Codex/Gemini/User) |
| 131 | - Token velocity badges (tokens-per-minute) |
| 132 | - Context usage indicators (green/yellow/orange/red) |
| 133 | - Real-time refresh with `r` |
| 134 | |
| 135 | ### Dashboard Navigation |
| 136 | |
| 137 | | Key | Action | |
| 138 | |-----|--------| |
| 139 | | `↑/↓` or `j/k` | Navigate panes | |
| 140 | | `1-9` | Quick select | |
| 141 | | `z` or `Enter` | Zoom to pane | |
| 142 | | `r` | Refresh | |
| 143 | | `c` | View context | |
| 144 | | `m` | Open Agent Mail | |
| 145 | | `q` | Quit | |
| 146 | |
| 147 | ## Output Capture |
| 148 | |
| 149 | ```bash |
| 150 | ntm copy myproject:1 # Copy specific pane |
| 151 | ntm copy myproject --all # Copy all panes |
| 152 | ntm copy myproject --cc # Copy Claude panes only |
| 153 | ntm copy myproject --pattern 'ERROR' # Filter by regex |
| 154 | ntm copy myproject --code # Extract code blocks only |
| 155 | ntm copy myproject --output out.txt # Save |
People who liked this also viewed
6 picksType
- hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026
- request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026
- explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026
- ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
