Back to Details

ntm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

NTM — Named Tmux Manager

NTM — 命名式Tmux管理器

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.
一款Go CLI工具，可将tmux转变为多代理指挥中心，用于并行编排Claude Code、Codex和Gemini代理。通过精美的TUI、自动化上下文轮转以及与Agent Flywheel生态系统的深度集成，实现代理的创建、管理与协同。

Why This Exists

开发背景

Managing multiple AI coding agents is painful:
  • Window chaos: Each agent needs its own terminal
  • Context switching: Jumping between windows breaks flow
  • No orchestration: Same prompt to multiple agents requires manual copy-paste
  • Session fragility: Disconnecting from SSH loses all agent sessions
  • No visibility: Hard to see agent status at a glance
NTM solves all of this with one session containing many agents, persistent across SSH disconnections.
管理多个AI编码代理十分棘手：
  • 窗口混乱：每个代理都需要独立终端
  • 上下文切换：在窗口间切换会打断工作流
  • 无编排能力：向多个代理发送相同提示需要手动复制粘贴
  • 会话易失：断开SSH连接会丢失所有代理会话
  • 状态不透明：难以快速查看所有代理的状态
NTM通过在单个会话中管理多个代理解决了所有这些问题，且会话可在SSH断开后保持持久化。

Quick Start

快速开始

bash
undefined
bash
undefined

Install

安装

curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash

Add shell integration

添加Shell集成

echo 'eval "$(ntm init zsh)"' >> ~/.zshrc && source ~/.zshrc
echo 'eval "$(ntm init zsh)"' >> ~/.zshrc && source ~/.zshrc

Interactive tutorial

交互式教程

ntm tutorial
ntm tutorial

Check dependencies

检查依赖

ntm deps -v
ntm deps -v

Create multi-agent session

创建多代理会话

ntm spawn myproject --cc=2 --cod=1 --gmi=1
ntm spawn myproject --cc=2 --cod=1 --gmi=1

Send prompt to all Claude agents

向所有Claude代理发送提示

ntm send myproject --cc "Explore this codebase and summarize its architecture."
ntm send myproject --cc "探索此代码库并总结其架构。"

Open command palette (or press F6 after 
ntm bind
)

打开命令面板（或在
ntm bind
后按F6）

ntm palette myproject
undefined
ntm palette myproject
undefined

Session Creation

会话创建

Spawn Agents

生成代理

bash
ntm spawn myproject --cc=3 --cod=2 --gmi=1   # 3 Claude + 2 Codex + 1 Gemini
ntm quick myproject --template=go             # Full project scaffold + agents
ntm create myproject --panes=10               # Empty panes only
ntm spawn myproject --profiles=architect,implementer,tester
bash
ntm spawn myproject --cc=3 --cod=2 --gmi=1   # 3个Claude + 2个Codex + 1个Gemini
ntm quick myproject --template=go             # 完整项目脚手架 + 代理
ntm create myproject --panes=10               # 仅创建空面板
ntm spawn myproject --profiles=architect,implementer,tester

Agent Flags

代理参数

FlagAgentCLI Command
--cc=N
Claude Code
claude
--cod=N
Codex CLI
codex
--gmi=N
Gemini CLI
gemini
参数代理CLI命令
--cc=N
Claude Code
claude
--cod=N
Codex CLI
codex
--gmi=N
Gemini CLI
gemini

Add More Agents

添加更多代理

bash
ntm add myproject --cc=2              # Add 2 more Claude agents
ntm add myproject --cod=1 --gmi=1     # Add mixed agents
bash
ntm add myproject --cc=2              # 新增2个Claude代理
ntm add myproject --cod=1 --gmi=1     # 新增混合类型代理

Sending Prompts

发送提示

bash
ntm send myproject --cc "Implement user auth"     # To all Claude
ntm send myproject --cod "Write unit tests"       # To all Codex
ntm send myproject --gmi "Review and document"    # To all Gemini
ntm send myproject --all "Review current state"   # To ALL agents
ntm interrupt myproject                           # Ctrl+C to all
bash
ntm send myproject --cc "实现用户认证"     # 发送给所有Claude
ntm send myproject --cod "编写单元测试"       # 发送给所有Codex
ntm send myproject --gmi "评审并编写文档"    # 发送给所有Gemini
ntm send myproject --all "评审当前状态"   # 发送给所有代理
ntm interrupt myproject                           # 向所有代理发送Ctrl+C

Session Navigation

会话导航

CommandAliasDescription
ntm list
lnt
List all tmux sessions
ntm attach
rnt
Attach to session
ntm status
snt
Show pane details with agent counts
ntm view
vnt
Unzoom, tile layout, attach
ntm zoom
znt
Zoom to specific pane
ntm dashboard
dash
, 
d
Interactive visual dashboard
ntm kill
knt
Kill session (
-f
to force)
命令别名描述
ntm list
lnt
列出所有tmux会话
ntm attach
rnt
连接到会话
ntm status
snt
显示面板详情及代理数量
ntm view
vnt
取消缩放、分栏布局、连接会话
ntm zoom
znt
缩放至指定面板
ntm dashboard
dash
, 
d
交互式可视化仪表盘
ntm kill
knt
终止会话（
-f
参数强制终止）

Command Palette

命令面板

Fuzzy-searchable TUI with pre-configured prompts:
bash
ntm palette myproject    # Open palette
ntm bind                 # Set up F6 keybinding
ntm bind --key=F5        # Use different key
支持模糊搜索的TUI，内置预配置提示：
bash
ntm palette myproject    # 打开命令面板
ntm bind                 # 设置F6快捷键
ntm bind --key=F5        # 使用自定义快捷键

Palette Features

命令面板特性

  • Animated gradient banner with Catppuccin themes
  • Fuzzy search with live filtering
  • Pin/favorite commands (
    Ctrl+P
    / 
    Ctrl+F
    )
  • Live preview pane with metadata
  • Quick select with numbers 1-9
  • Visual target selector (All/Claude/Codex/Gemini)
  • 带有Catppuccin主题的渐变动画横幅
  • 实时过滤的模糊搜索
  • 固定/收藏命令（
    Ctrl+P
    / 
    Ctrl+F
    ）
  • 带元数据的实时预览面板
  • 数字1-9快速选择
  • 可视化目标选择器（全部/Claude/Codex/Gemini）

Palette Navigation

命令面板导航

KeyAction
↑/↓
or 
j/k
Navigate
1-9
Quick select
Enter
Select command
Esc
Back / Quit
?
Help overlay
Ctrl+P
Pin/unpin
Ctrl+F
Favorite
按键操作
↑/↓
或 
j/k
导航
1-9
快速选择
Enter
选择命令
Esc
返回 / 退出
?
显示帮助 overlay
Ctrl+P
固定/取消固定
Ctrl+F
收藏/取消收藏

Interactive Dashboard

交互式仪表盘

bash
ntm dashboard myproject   # Or: ntm dash myproject
bash
ntm dashboard myproject   # 或：ntm dash myproject

Dashboard Features

仪表盘特性

  • Visual pane grid with color-coded agent cards
  • Live agent counts (Claude/Codex/Gemini/User)
  • Token velocity badges (tokens-per-minute)
  • Context usage indicators (green/yellow/orange/red)
  • Real-time refresh with 
    r
  • 带颜色编码代理卡片的可视化面板网格
  • 实时代理数量统计（Claude/Codex/Gemini/用户）
  • 令牌速度徽章（每分钟令牌数）
  • 上下文使用指示器（绿/黄/橙/红）
  • 按
    r
    键实时刷新

Dashboard Navigation

仪表盘导航

KeyAction
↑/↓
or 
j/k
Navigate panes
1-9
Quick select
z
or 
Enter
Zoom to pane
r
Refresh
c
View context
m
Open Agent Mail
q
Quit
按键操作
↑/↓
或 
j/k
导航面板
1-9
快速选择
z
或 
Enter
缩放至面板
r
刷新
c
查看上下文
m
打开Agent Mail
q
退出

Output Capture

输出捕获

bash
ntm copy myproject:1              # Copy specific pane
ntm copy myproject --all          # Copy all panes
ntm copy myproject --cc           # Copy Claude panes only
ntm copy myproject --pattern 'ERROR'  # Filter by regex
ntm copy myproject --code         # Extract code blocks only
ntm copy myproject --output out.txt   # Save to file
ntm save myproject -o ~/logs      # Save all outputs
bash
ntm copy myproject:1              # 复制指定面板内容
ntm copy myproject --all          # 复制所有面板内容
ntm copy myproject --cc           # 仅复制Claude面板内容
ntm copy myproject --pattern 'ERROR'  # 按正则表达式过滤复制
ntm copy myproject --code         # 仅提取代码块
ntm copy myproject --output out.txt   # 保存至文件
ntm save myproject -o ~/logs      # 保存所有输出

Monitoring & Analysis

监控与分析

bash
ntm activity myproject --watch    # Real-time activity
ntm health myproject              # Health status
ntm watch myproject --cc          # Stream output
ntm extract myproject --lang=go   # Extract code blocks
ntm diff myproject cc_1 cod_1     # Compare panes
ntm grep 'error' myproject -C 3   # Search with context
ntm analytics --days 7            # Session statistics
ntm locks myproject --all-agents  # File reservations
bash
ntm activity myproject --watch    # 实时活动监控
ntm health myproject              # 健康状态检查
ntm watch myproject --cc          # 流式输出代理内容
ntm extract myproject --lang=go   # 提取指定语言的代码块
ntm diff myproject cc_1 cod_1     # 对比两个面板内容
ntm grep 'error' myproject -C 3   # 带上下文的搜索
ntm analytics --days 7            # 会话统计数据
ntm locks myproject --all-agents  # 文件锁定情况

Activity States

活动状态

StateIconDescription
WAITING●Idle, ready for work
GENERATING▶Producing output
THINKING◐Processing (no output yet)
ERROR✗Encountered error
STALLED◯Stopped unexpectedly
状态图标描述
WAITING●空闲，等待任务
GENERATING▶正在生成输出
THINKING◐正在处理（暂无输出）
ERROR✗发生错误
STALLED◯意外停止

Checkpoints

检查点

bash
ntm checkpoint save myproject -m "Before refactor"
ntm checkpoint list myproject
ntm checkpoint show myproject 20251210-143052
ntm checkpoint delete myproject 20251210-143052 -f
bash
ntm checkpoint save myproject -m "重构前" 
ntm checkpoint list myproject
ntm checkpoint show myproject 20251210-143052
ntm checkpoint delete myproject 20251210-143052 -f

Context Window Rotation

上下文窗口轮转

NTM monitors context usage and auto-rotates agents before exhausting context.
NTM会监控上下文使用情况，并在上下文耗尽前自动轮转代理。

How It Works

工作原理

  1. Monitoring: Token usage estimated per agent
  2. Warning: Alert at 80% usage
  3. Compaction: Try 
    /compact
    or summarization first
  4. Rotation: Fresh agent with handoff summary if needed
  1. 监控：估算每个代理的令牌使用量
  2. 警告：在使用量达80%时发出警报
  3. 压缩：首先尝试
    /compact
    命令或摘要压缩
  4. 轮转：若需要则启动新代理并传递上下文摘要

Context Indicators

上下文指示器

ColorUsageStatus
Green< 40%Plenty of room
Yellow40-60%Comfortable
Orange60-80%Approaching threshold
Red> 80%Needs attention
颜色使用占比状态
绿色< 40%剩余空间充足
黄色40-60%空间适中
橙色60-80%接近阈值
红色> 80%需要关注

Automatic Compaction Recovery

自动压缩恢复

When context is compacted, NTM sends a recovery prompt:
toml
[context_rotation.recovery]
enabled = true
prompt = "Reread AGENTS.md so it's still fresh in your mind. Use ultrathink."
include_bead_context = true   # Include project state from bv
当上下文被压缩后，NTM会发送恢复提示：
toml
[context_rotation.recovery]
enabled = true
prompt = "重新阅读AGENTS.md以保持记忆清晰。使用ultrathink模式。"
include_bead_context = true   # 包含来自bv的项目状态

Robot Mode (AI Automation)

机器人模式（AI自动化）

Machine-readable JSON output for AI agents and automation.
为AI代理和自动化场景提供机器可读的JSON输出。

State Inspection

状态检查

bash
ntm --robot-status              # Sessions, panes, agent states
ntm --robot-context=SESSION     # Context window usage
ntm --robot-snapshot            # Unified state: sessions + beads + mail
ntm --robot-tail=SESSION        # Recent pane output
ntm --robot-inspect-pane=SESS   # Detailed pane inspection
ntm --robot-files=SESSION       # File changes with attribution
ntm --robot-metrics=SESSION     # Session metrics
ntm --robot-plan                # bv execution plan
ntm --robot-dashboard           # Dashboard summary
ntm --robot-health              # Project health
bash
ntm --robot-status              # 会话、面板、代理状态
ntm --robot-context=SESSION     # 上下文窗口使用情况
ntm --robot-snapshot            # 统一状态：会话 + beads + 邮件
ntm --robot-tail=SESSION        # 面板近期输出
ntm --robot-inspect-pane=SESS   # 面板详细检查
ntm --robot-files=SESSION       # 带归属的文件变更
ntm --robot-metrics=SESSION     # 会话指标
ntm --robot-plan                # bv执行计划
ntm --robot-dashboard           # 仪表盘摘要
ntm --robot-health              # 项目健康状态

Agent Control

代理控制

bash
ntm --robot-send=SESSION --msg="Fix auth" --type=claude
ntm --robot-spawn=SESSION --spawn-cc=2 --spawn-wait
ntm --robot-interrupt=SESSION
ntm --robot-assign=SESSION --assign-beads=bd-1,bd-2
ntm --robot-replay=SESSION --replay-id=ID
bash
ntm --robot-send=SESSION --msg="修复认证问题" --type=claude
ntm --robot-spawn=SESSION --spawn-cc=2 --spawn-wait
ntm --robot-interrupt=SESSION
ntm --robot-assign=SESSION --assign-beads=bd-1,bd-2
ntm --robot-replay=SESSION --replay-id=ID

Bead Management

Bead管理

bash
ntm --robot-bead-claim=BEAD_ID --bead-assignee=agent
ntm --robot-bead-create --bead-title="Fix bug" --bead-type=bug
ntm --robot-bead-show=BEAD_ID
ntm --robot-bead-close=BEAD_ID --bead-close-reason="Fixed"
bash
ntm --robot-bead-claim=BEAD_ID --bead-assignee=agent
ntm --robot-bead-create --bead-title="修复Bug" --bead-type=bug
ntm --robot-bead-show=BEAD_ID
ntm --robot-bead-close=BEAD_ID --bead-close-reason="已修复"

CASS Integration

CASS集成

bash
ntm --robot-cass-search="auth error" --cass-since=7d
ntm --robot-cass-context="how to implement auth"
ntm --robot-cass-status
bash
ntm --robot-cass-search="认证错误" --cass-since=7d
ntm --robot-cass-context="如何实现认证"
ntm --robot-cass-status

Exit Codes

退出码

CodeMeaning
0
Success
1
Error
2
Unavailable/Not implemented
代码含义
0
成功
1
错误
2
不可用/未实现

Work Distribution

工作分配

Integration with BV for intelligent work assignment:
bash
ntm work triage               # Full triage with recommendations
ntm work triage --by-label    # Group by domain
ntm work triage --quick       # Quick wins only
ntm work alerts               # Stale issues, priority drift, cycles
ntm work search "JWT auth"    # Semantic search
ntm work impact src/api/*.go  # Impact analysis
ntm work next                 # Single best next action
与BV集成实现智能工作分配：
bash
ntm work triage               # 完整分类并提供建议
ntm work triage --by-label    # 按领域分组
ntm work triage --quick       # 仅显示快速任务
ntm work alerts               # 陈旧任务、优先级漂移、循环问题
ntm work search "JWT认证"    # 语义搜索
ntm work impact src/api/*.go  # 影响分析
ntm work next                 # 推荐最佳下一步操作

Intelligent Assignment

智能分配策略

bash
ntm --robot-assign=myproject --assign-strategy=balanced  # Default
ntm --robot-assign=myproject --assign-strategy=speed     # Maximize throughput
ntm --robot-assign=myproject --assign-strategy=quality   # Best agent-task match
ntm --robot-assign=myproject --assign-strategy=dependency # Unblock downstream
bash
ntm --robot-assign=myproject --assign-strategy=balanced  # 默认：均衡分配
ntm --robot-assign=myproject --assign-strategy=speed     # 最大化吞吐量
ntm --robot-assign=myproject --assign-strategy=quality   # 最优代理-任务匹配
ntm --robot-assign=myproject --assign-strategy=dependency # 解除下游阻塞

Agent Capability Matrix

代理能力矩阵

AgentBest At
ClaudeAnalysis, refactoring, documentation, architecture
CodexFeature implementation, bug fixes, quick tasks
GeminiDocumentation, analysis, features
代理擅长领域
Claude分析、重构、文档编写、架构设计
Codex功能实现、Bug修复、快速任务
Gemini文档编写、分析、功能开发

Profiles & Personas

配置文件与角色

bash
ntm profiles list                    # List profiles
ntm profiles show architect          # Show details
ntm spawn myproject --profiles=architect,implementer,tester
ntm spawn myproject --profile-set=backend-team
bash
ntm profiles list                    # 列出所有角色配置
ntm profiles show architect          # 查看角色详情
ntm spawn myproject --profiles=architect,implementer,tester
ntm spawn myproject --profile-set=backend-team

Built-in Profiles

内置角色

architect
, 
implementer
, 
reviewer
, 
tester
, 
documenter
architect
, 
implementer
, 
reviewer
, 
tester
, 
documenter

Agent Mail Integration

Agent Mail集成

bash
ntm mail send myproject --to GreenCastle "Review API changes"
ntm mail send myproject --all "Checkpoint: sync status"
ntm mail inbox myproject
ntm mail read myproject --agent BlueLake
ntm mail ack myproject 42
bash
ntm mail send myproject --to GreenCastle "评审API变更"
ntm mail send myproject --all "检查点：同步状态"
ntm mail inbox myproject
ntm mail read myproject --agent BlueLake
ntm mail ack myproject 42

Pre-commit Guard

提交前防护

bash
ntm hooks guard install    # Prevent conflicting commits
ntm hooks guard uninstall
bash
ntm hooks guard install    # 防止冲突提交
ntm hooks guard uninstall

Notifications

通知

Multi-channel notifications for events:
toml
[notifications]
enabled = true
events = ["agent.error", "agent.crashed", "agent.rate_limit"]

[notifications.desktop]
enabled = true

[notifications.webhook]
enabled = true
url = "https://hooks.slack.com/..."
支持多渠道事件通知：
toml
[notifications]
enabled = true
events = ["agent.error", "agent.crashed", "agent.rate_limit"]

[notifications.desktop]
enabled = true

[notifications.webhook]
enabled = true
url = "https://hooks.slack.com/..."

Event Types

事件类型

agent.error
, 
agent.crashed
, 
agent.rate_limit
, 
rotation.needed
, 
session.created
, 
session.killed
, 
health.degraded
agent.error
, 
agent.crashed
, 
agent.rate_limit
, 
rotation.needed
, 
session.created
, 
session.killed
, 
health.degraded

Alerting System

告警系统

Alert Types

告警类型

TypeSeverityDescription
unhealthy
HighAgent enters unhealthy state
degraded
MediumAgent performance degrades
rate_limited
MediumAPI rate limit detected
restart_failed
HighRestart attempt failed
max_restarts
CriticalRestart limit exceeded
bash
ntm --robot-alerts
ntm --robot-dismiss-alert=ALERT_ID
类型严重程度描述
unhealthy
高代理进入不健康状态
degraded
中代理性能下降
rate_limited
中检测到API速率限制
restart_failed
高重启尝试失败
max_restarts
严重超出最大重启次数限制
bash
ntm --robot-alerts
ntm --robot-dismiss-alert=ALERT_ID

Command Hooks

命令钩子

toml
undefined
toml
undefined

~/.config/ntm/hooks.toml

~/.config/ntm/hooks.toml

[[command_hooks]] event = "post-spawn" command = "notify-send 'NTM' 'Agents spawned'"
[[command_hooks]] event = "pre-send" command = "echo "$(date): $NTM_MESSAGE" >> ~/.ntm-send.log"
undefined
[[command_hooks]] event = "post-spawn" command = "notify-send 'NTM' '代理已生成'"
[[command_hooks]] event = "pre-send" command = "echo "$(date): $NTM_MESSAGE" >> ~/.ntm-send.log"
undefined

Available Events

支持的事件

pre-spawn
, 
post-spawn
, 
pre-send
, 
post-send
, 
pre-add
, 
post-add
, 
pre-shutdown
, 
post-shutdown
pre-spawn
, 
post-spawn
, 
pre-send
, 
post-send
, 
pre-add
, 
post-add
, 
pre-shutdown
, 
post-shutdown

Safety System

安全系统

Blocks dangerous commands from AI agents:
bash
ntm safety status              # Protection status
ntm safety check "git reset --hard"
ntm safety install             # Install git wrapper + Claude hook
ntm safety uninstall
阻止AI代理执行危险命令：
bash
ntm safety status              # 防护状态
ntm safety check "git reset --hard"
ntm safety install             # 安装git包装器 + Claude钩子
ntm safety uninstall

Protected Commands

受保护命令

PatternRiskAction
git reset --hard
Loses uncommitted changesBlock
git push --force
Overwrites remote historyBlock
rm -rf /
Catastrophic deletionBlock
DROP TABLE
Database destructionBlock
模式风险操作
git reset --hard
丢失未提交变更阻止
git push --force
覆盖远程历史阻止
rm -rf /
灾难性删除阻止
DROP TABLE
数据库破坏阻止

Multi-Agent Strategies

多代理策略

Divide and Conquer

分而治之

bash
ntm send myproject --cc "design the database schema"
ntm send myproject --cod "implement the models"
ntm send myproject --gmi "write tests"
bash
ntm send myproject --cc "设计数据库架构"
ntm send myproject --cod "实现数据模型"
ntm send myproject --gmi "编写测试用例"

Competitive Comparison

竞争性对比

bash
ntm send myproject --all "implement a rate limiter"
ntm view myproject  # Compare side-by-side
bash
ntm send myproject --all "实现速率限制器"
ntm view myproject  # 并排对比结果

Review Pipeline

评审流水线

bash
ntm send myproject --cc "implement feature X"
ntm send myproject --cod "review Claude's code"
ntm send myproject --gmi "write tests for edge cases"
bash
ntm send myproject --cc "实现功能X"
ntm send myproject --cod "评审Claude的代码"
ntm send myproject --gmi "编写边缘场景测试用例"

Configuration

配置

bash
ntm config init          # Create ~/.config/ntm/config.toml
ntm config show          # Show current config
ntm config project init  # Create .ntm/config.toml in project
bash
ntm config init          # 创建~/.config/ntm/config.toml
ntm config show          # 查看当前配置
ntm config project init  # 在项目中创建.ntm/config.toml

Example Config

配置示例

toml
projects_base = "~/Developer"

[agents]
claude = 'claude --dangerously-skip-permissions'
codex = "codex --dangerously-bypass-approvals-and-sandbox"
gemini = "gemini --yolo"

[tmux]
default_panes = 10
palette_key = "F6"

[context_rotation]
enabled = true
warning_threshold = 0.80
rotate_threshold = 0.95
toml
projects_base = "~/Developer"

[agents]
claude = 'claude --dangerously-skip-permissions'
codex = "codex --dangerously-bypass-approvals-and-sandbox"
gemini = "gemini --yolo"

[tmux]
default_panes = 10
palette_key = "F6"

[context_rotation]
enabled = true
warning_threshold = 0.80
rotate_threshold = 0.95

Environment Variables

环境变量

VariableDescription
NTM_PROJECTS_BASE
Base directory for projects
NTM_THEME
Color theme: 
auto
, 
mocha
, 
latte
, 
nord
, 
plain
NTM_ICONS
Icon set: 
nerd
, 
unicode
, 
ascii
NTM_REDUCE_MOTION
Disable animations
NTM_PROFILE
Enable performance profiling
变量描述
NTM_PROJECTS_BASE
项目基础目录
NTM_THEME
颜色主题：
auto
, 
mocha
, 
latte
, 
nord
, 
plain
NTM_ICONS
图标集：
nerd
, 
unicode
, 
ascii
NTM_REDUCE_MOTION
禁用动画
NTM_PROFILE
启用性能分析

Themes & Display

主题与显示

Color Themes

颜色主题

ThemeDescription
auto
Detect light/dark
mocha
Default dark, warm
latte
Light variant
nord
Arctic-inspired
plain
No color
主题描述
auto
自动检测明暗模式
mocha
默认深色暖色调
latte
浅色变体
nord
北极风格
plain
无颜色

Agent Colors

代理颜色

AgentColor
ClaudeMauve (Purple)
CodexBlue
GeminiYellow
UserGreen
代理颜色
Claude紫丁香色（紫色）
Codex蓝色
Gemini黄色
用户绿色

Display Width Tiers

显示宽度层级

WidthBehavior
<120 colsStacked layout
120-199 colsList/detail split
200-239 colsWider gutters
240+ colsFull detail
宽度行为
<120列堆叠布局
120-199列列表/详情拆分
200-239列更宽的 gutter
240+列完整详情

Pane Naming Convention

面板命名规则

Pattern: 
<project>__<agent>_<number>
  • myproject__cc_1
    - First Claude
  • myproject__cod_2
    - Second Codex
  • myproject__gmi_1
    - First Gemini
Status indicators: C = Claude, X = Codex, G = Gemini, U = User
格式：
<项目名>__<代理类型>_<编号>
  • myproject__cc_1
    - 第一个Claude代理
  • myproject__cod_2
    - 第二个Codex代理
  • myproject__gmi_1
    - 第一个Gemini代理
状态指示器：C = Claude, X = Codex, G = Gemini, U = 用户

Shell Aliases

Shell别名

After 
eval "$(ntm init zsh)"
:
CategoryAliases
Agent Launch
cc
, 
cod
, 
gmi
Session
cnt
, 
sat
, 
qps
Agent Mgmt
ant
, 
bp
, 
int
Navigation
rnt
, 
lnt
, 
snt
, 
vnt
, 
znt
Dashboard
dash
, 
d
Output
cpnt
, 
svnt
Utilities
ncp
, 
knt
, 
cad
执行
eval "$(ntm init zsh)"
后生效：
分类别名
代理启动
cc
, 
cod
, 
gmi
会话管理
cnt
, 
sat
, 
qps
代理管理
ant
, 
bp
, 
int
导航
rnt
, 
lnt
, 
snt
, 
vnt
, 
znt
仪表盘
dash
, 
d
输出管理
cpnt
, 
svnt
工具
ncp
, 
knt
, 
cad

Installation

安装方式

bash
undefined
bash
undefined

One-liner (recommended)

一键安装（推荐）

curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/ntm/main/install.sh | bash

Homebrew

Homebrew安装

brew install dicklesworthstone/tap/ntm
brew install dicklesworthstone/tap/ntm

Go install

Go安装

go install github.com/Dicklesworthstone/ntm/cmd/ntm@latest
go install github.com/Dicklesworthstone/ntm/cmd/ntm@latest

Docker

Docker安装

docker pull ghcr.io/dicklesworthstone/ntm:latest
undefined
docker pull ghcr.io/dicklesworthstone/ntm:latest
undefined

Upgrade

升级

bash
ntm upgrade              # Check and install updates
ntm upgrade --check      # Check only
ntm upgrade --yes        # Auto-confirm
bash
ntm upgrade              # 检查并安装更新
ntm upgrade --check      # 仅检查更新
ntm upgrade --yes        # 自动确认升级

Tmux Essentials

Tmux基础操作

KeysAction
Ctrl+B, D
Detach
Ctrl+B, [
Scroll/copy mode
Ctrl+B, z
Toggle zoom
Ctrl+B, Arrow
Navigate panes
F6
Open NTM palette (after 
ntm bind
)
按键操作
Ctrl+B, D
断开连接
Ctrl+B, [
滚动/复制模式
Ctrl+B, z
切换缩放
Ctrl+B, 方向键
导航面板
F6
打开NTM命令面板（执行
ntm bind
后）

Integration with Flywheel

与Flywheel集成

ToolIntegration
Agent MailMessage routing, file reservations, pre-commit guard
BVWork distribution, triage, assignment strategies
CASSSearch past sessions via robot mode
CMProcedural memory for agent handoffs
DCGSafety system integration
UBSAuto-scanning on file changes
工具集成内容
Agent Mail消息路由、文件锁定、提交前防护
BV工作分配、分类、分配策略
CASS通过机器人模式搜索历史会话
CM代理交接的过程记忆
DCG安全系统集成
UBS文件变更自动扫描