tmux-team 2.2.0 → 3.0.0-alpha.1

package/README.md

@@ -2,7 +2,7 @@
 
 **The lightweight coordination layer for terminal-based AI agents.**
 
-tmux-team is a protocol-agnostic "Team Lead" that enables multi-agent collaboration directly within your existing tmux workflow. It provides the transport layer, synchronization, and project management needed to turn a collection of isolated terminal panes into a coordinated AI task force.
+tmux-team is a protocol-agnostic transport layer that enables multi-agent collaboration directly within your existing tmux workflow. It turns a collection of isolated terminal panes into a coordinated AI team.
 
 ---
 
@@ -34,32 +34,24 @@ Unlike heavyweight frameworks that require specific SDKs or cloud infrastructure
 
 ### 1. Deterministic Transport (`--delay` vs. `sleep`)
 
-**The Problem**: Tool allowlists typically approve one safe command (`tmux-team talk ...`) but not arbitrary shell commands. Using `sleep` is often blocked by security policies, requires shell availability and proper quoting, and creates a separate process that's hard to manage.
+**The Problem**: Tool allowlists typically approve one safe command (`tmux-team talk ...`) but not arbitrary shell commands. Using `sleep` is often blocked by security policies.
 
-**The Why**: Internal delay keeps the workflow as a single tool call. This guarantees "First-Packet Integrity"—the CLI validates units (`500ms`, `2s`) and ensures the TTY buffer is ready to receive input specifically for that agent. No shell dependency, no policy friction.
+**The Why**: Internal delay keeps the workflow as a single tool call. No shell dependency, no policy friction.
 
 ### 2. Stateless Handshakes (The "Nonce" Strategy)
 
-**The Problem**: Terminal panes are streams, not RPC channels. A simple `[DONE]` string could already be in scrollback, or the agent might say "I'm almost done" and trigger a false positive.
+**The Problem**: Terminal panes are streams, not RPC channels. A simple `[DONE]` string could already be in scrollback.
 
-**The Why**: We use a unique **Nonce** (Number used once) for every request: `{tmux-team-end:8f3a}`.
+**The Why**: We use a unique **Nonce** for every request: `{tmux-team-end:8f3a}`.
 - **Collision Avoidance** — Prevents matching markers from previous turns
-- **Completion Safety** — Ensures the agent has truly finished, not just paused mid-response
-- **Zero-API RPC** — Creates request/response semantics over a standard TTY without requiring agents to support a special protocol
-
-Combined with one-at-a-time locking, nonce markers ensure state stays consistent and debuggable.
+- **Completion Safety** — Ensures the agent has truly finished
+- **Zero-API RPC** — Creates request/response semantics over a standard TTY
 
 ### 3. Context Injection (Preambles)
 
-**The Problem**: AI agents are prone to "instruction drift." Over a long session, they might stop using your preferred format or forget constraints. Manually re-typing system instructions is a "token tax" on your own brain.
-
-**The Why**: Preambles act as a forced system prompt for CLI environments. By injecting these "hidden instructions" at the transport level, we ensure the agent remains in character (e.g., "You are the code reviewer, do not edit files") without cluttering the human's command history. It's about reducing **Cognitive Load**—the human focuses on intent, the CLI enforces protocol.
-
-### 4. Token-Efficient Polling
+**The Problem**: AI agents are prone to "instruction drift." Over a long session, they might forget constraints.
 
-**The Problem**: The `--wait` feature is powerful but higher-risk: long-running commands, more state to manage, potential for hung processes.
-
-**The Why**: Default to the simple mental model (send → manually check). Teams opt into `--wait` when they're ready. By capturing only the last few lines of the buffer and searching for the short, high-entropy nonce, we keep overhead near zero—we're looking for a single "heartbeat" at the TTY's edge, not re-parsing the whole history.
+**The Why**: Preambles act as a forced system prompt for CLI environments. By injecting these "hidden instructions" at the transport level, we ensure the agent remains in character.
 
 ---
 
@@ -69,7 +61,7 @@ Combined with one-at-a-time locking, nonce markers ensure state stays consistent
 npm install -g tmux-team
 ```
 
-**Requirements:** Node.js >= 16, tmux, macOS/Linux
+**Requirements:** Node.js >= 18, tmux, macOS/Linux
 
 ### Shell Completion
 
@@ -139,10 +131,8 @@ Once the plugin is installed, coordinate directly from your Claude Code session:
 | `update <name> --pane/--remark` | Update agent configuration |
 | `remove <name>` | Unregister an agent |
 | `init` | Create `tmux-team.json` in current directory |
-| `pm init --name "Project"` | Initialize project management |
-| `pm m add/list/done/delete` | Manage milestones |
-| `pm t add/list/update/done` | Manage tasks |
-| `pm log` | View audit event log |
+| `config [show/set/clear]` | View/modify settings |
+| `preamble [show/set/clear]` | Manage agent preambles |
 | `completion [zsh\|bash]` | Output shell completion script |
 
 ---
@@ -151,15 +141,14 @@ Once the plugin is installed, coordinate directly from your Claude Code session:
 
 ### Local Config (`./tmux-team.json`)
 
-Per-project agent registry with optional preambles and permissions:
+Per-project agent registry with optional preambles:
 
 ```json
 {
   "claude": {
     "pane": "10.0",
     "remark": "Frontend specialist",
-    "preamble": "Focus on UI components. Ask for review before merging.",
-    "deny": ["pm:task:update(status)"]
+    "preamble": "Focus on UI components. Ask for review before merging."
   },
   "codex": {
     "pane": "10.1",
@@ -174,7 +163,6 @@ Per-project agent registry with optional preambles and permissions:
 | `pane` | tmux pane ID (required) |
 | `remark` | Description shown in `list` |
 | `preamble` | Hidden instructions prepended to every message |
-| `deny` | Permission patterns to block (e.g., `pm:task:update(status)`) |
 
 ### Global Config (`~/.config/tmux-team/config.json`)
 
@@ -188,7 +176,7 @@ Global settings that apply to all projects:
     "timeout": 180,
     "pollInterval": 1,
     "captureLines": 100,
-    "hideOrphanTasks": false
+    "preambleEvery": 3
   }
 }
 ```
@@ -200,13 +188,11 @@ Global settings that apply to all projects:
 | `defaults.timeout` | Default --wait timeout in seconds |
 | `defaults.pollInterval` | Polling interval in seconds |
 | `defaults.captureLines` | Default lines for `check` command |
-| `defaults.hideOrphanTasks` | Hide tasks without milestone in `pm t list` |
-
-> **Note:** Agent-specific config (preamble, deny) lives in local `tmux-team.json` only.
+| `defaults.preambleEvery` | Inject preamble every N messages (default: 3) |
 
 ---
 
-## ✨ v2 Features
+## ✨ Features
 
 ### 📡 Enhanced `talk` Command
 
@@ -239,96 +225,22 @@ tmux-team preamble set gemini "..." # Set preamble
 tmux-team preamble clear gemini     # Remove preamble
 ```
 
-### 🔐 Agent Permissions
-
-Control what agents can do with `deny` patterns in `tmux-team.json`:
-
-```json
-{
-  "claude": {
-    "pane": "10.0",
-    "deny": ["pm:task:update(status)", "pm:milestone:update(status)"]
-  }
-}
-```
-
-Pattern format: `pm:<resource>:<action>(<fields>)`
-
-| Pattern | Effect |
-|---------|--------|
-| `pm:task:update(status)` | Block status changes only |
-| `pm:task:update(*)` | Block all task updates |
-| `pm:task:update` | Block entire update action |
-
-Permissions are enforced via pane identity—agents are identified by which tmux pane they run in, not environment variables.
-
-### 🎯 Project Management
-
-```bash
-# Initialize a team project
-tmux-team pm init --name "Auth Refactor"
-
-# Manage milestones and tasks
-tmux-team pm m add "MVP Release"
-tmux-team pm t add "Implement login" --milestone 1
-tmux-team pm t update 1 --status in_progress
-tmux-team pm t done 1
-
-# View audit log
-tmux-team pm log --limit 10
-```
-
 ---
 
 ## 🚫 Non-Goals
 
 tmux-team intentionally stays lightweight:
 
-- **Not an orchestrator** — No automatic task routing or agent selection
-- **Not a session manager** — Doesn't create/manage tmux sessions or git worktrees
+- **Not an orchestrator** — No automatic agent selection or routing
+- **Not a session manager** — Doesn't create/manage tmux sessions
 - **Not an LLM wrapper** — Doesn't process or route messages through AI
 
 It's the plumbing layer that lets humans and AI agents coordinate via tmux, nothing more.
 
 ---
 
-*Built for developers who live in the terminal and want their AIs to do the same.*
-
----
-
 ## 📖 Command Reference
 
-### Core Commands
-
-```
-tmux-team <command> [arguments]
-```
-
-| Command | Description |
-|---------|-------------|
-| `talk <target> <message>` | Send message to an agent (or `all` for broadcast) |
-| `check <target> [lines]` | Capture output from agent's pane (default: 100 lines) |
-| `list` | List all configured agents |
-| `add <name> <pane> [remark]` | Register a new agent |
-| `update <name> [options]` | Update an agent's config |
-| `remove <name>` | Unregister an agent |
-| `init` | Create empty `tmux-team.json` in current directory |
-| `config [show\|set\|clear]` | View/modify configuration settings |
-| `preamble [show\|set\|clear]` | Manage agent preambles |
-| `pm <subcommand>` | Project management commands |
-| `completion [zsh\|bash]` | Output shell completion script |
-| `help` | Show help message |
-
-**Aliases:** `send` = talk, `read` = check, `ls` = list, `rm` = remove
-
-### Global Options
-
-| Option | Description |
-|--------|-------------|
-| `--json` | Output in JSON format |
-| `--verbose` | Show detailed output |
-| `--force` | Skip warnings |
-
 ### talk Options
 
 | Option | Description |
@@ -342,12 +254,10 @@ tmux-team <command> [arguments]
 
 ```bash
 tmux-team config show                  # Show current config
-tmux-team config set <key> <value>     # Set a config value
 tmux-team config set mode wait         # Enable wait mode
 tmux-team config set preambleMode disabled  # Disable preambles
-tmux-team config set hideOrphanTasks true   # Hide tasks without milestone
+tmux-team config set preambleEvery 5   # Inject preamble every 5 messages
 tmux-team config clear <key>           # Clear a config value
-tmux-team config --global set ...      # Modify global config
 ```
 
 ### preamble Command
@@ -360,87 +270,7 @@ tmux-team preamble clear <agent>       # Clear agent's preamble
 
 ---
 
-### Project Management (`pm`)
-
-```
-tmux-team pm <subcommand>
-```
-
-**Shorthands:** `pm m` = milestone, `pm t` = task, `pm ls` = list
-
-#### pm init
-
-```bash
-tmux-team pm init --name "Project Name"
-tmux-team pm init --name "Sprint 1" --backend github --repo owner/repo
-```
-
-| Option | Description |
-|--------|-------------|
-| `--name <name>` | Project name (required) |
-| `--backend <fs\|github>` | Storage backend (default: `fs`) |
-| `--repo <owner/repo>` | GitHub repo (required for github backend) |
-
-#### pm list
-
-```bash
-tmux-team pm list                      # List all teams/projects
-tmux-team pm ls                        # Shorthand
-```
-
-#### pm milestone (shorthand: `pm m`)
-
-```bash
-tmux-team pm m                         # List all milestones
-tmux-team pm m add "Phase 1"           # Add milestone
-tmux-team pm m add "Phase 1" -d "..."  # Add with description
-tmux-team pm m list                    # List milestones
-tmux-team pm m done <id>               # Mark milestone complete
-tmux-team pm m delete <id>             # Delete milestone (or: rm)
-tmux-team pm m doc <id>                # Print milestone documentation
-tmux-team pm m doc <id> --edit         # Edit doc in $EDITOR
-tmux-team pm m doc <id> ref            # Print doc path/reference
-tmux-team pm m doc <id> --body "..."   # Set doc content directly
-tmux-team pm m doc <id> --body-file x  # Set doc content from file
-```
-
-#### pm task (shorthand: `pm t`)
-
-```bash
-tmux-team pm t                         # List all tasks
-tmux-team pm t add "Task title"        # Add task
-tmux-team pm t add "..." --milestone 1 # Add task to milestone
-tmux-team pm t add "..." --body "..."  # Add task with body
-tmux-team pm t add "..." -a @user      # Add task with assignee
-tmux-team pm t list                    # List tasks
-tmux-team pm t list --status pending   # Filter by status
-tmux-team pm t list --milestone 1      # Filter by milestone
-tmux-team pm t show <id>               # Show task details
-tmux-team pm t update <id> --status in_progress
-tmux-team pm t update <id> -a @user    # Assign task
-tmux-team pm t done <id>               # Mark task complete
-tmux-team pm t doc <id>                # Print task documentation
-tmux-team pm t doc <id> --edit         # Edit doc in $EDITOR
-tmux-team pm t doc <id> ref            # Print doc path/reference
-tmux-team pm t doc <id> --body "..."   # Set doc content directly
-tmux-team pm t doc <id> --body-file x  # Set doc content from file
-```
-
-#### pm log
-
-```bash
-tmux-team pm log                       # Show audit event log
-tmux-team pm log --limit 10            # Limit to 10 events
-```
-
----
-
-### Storage Backends
-
-| Backend | Description |
-|---------|-------------|
-| `fs` | Local filesystem (default). Tasks stored in `~/.config/tmux-team/teams/` |
-| `github` | GitHub Issues. Tasks become issues, milestones sync with GitHub |
+*Built for developers who live in the terminal and want their AIs to do the same.*
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmux-team",
-  "version": "2.2.0",
+  "version": "3.0.0-alpha.1",
   "description": "CLI tool for AI agent collaboration in tmux - manage cross-pane communication",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -17,7 +17,6 @@ import { cmdRemove } from './commands/remove.js';
 import { cmdTalk } from './commands/talk.js';
 import { cmdCheck } from './commands/check.js';
 import { cmdCompletion } from './commands/completion.js';
-import { cmdPm } from './pm/commands.js';
 import { cmdConfig } from './commands/config.js';
 import { cmdPreamble } from './commands/preamble.js';
 
@@ -203,10 +202,6 @@ function main(): void {
         cmdCheck(ctx, args[0], args[1] ? parseInt(args[1], 10) : undefined);
         break;
 
-      case 'pm':
-        await cmdPm(ctx, args);
-        break;
-
       case 'config':
         cmdConfig(ctx, args);
         break;

package/src/commands/config.ts

@@ -15,13 +15,11 @@ import {
 
 type EnumConfigKey = 'mode' | 'preambleMode';
 type NumericConfigKey = 'preambleEvery';
-type BoolConfigKey = 'hideOrphanTasks';
-type ConfigKey = EnumConfigKey | NumericConfigKey | BoolConfigKey;
+type ConfigKey = EnumConfigKey | NumericConfigKey;
 
 const ENUM_KEYS: EnumConfigKey[] = ['mode', 'preambleMode'];
 const NUMERIC_KEYS: NumericConfigKey[] = ['preambleEvery'];
-const BOOL_KEYS: BoolConfigKey[] = ['hideOrphanTasks'];
-const VALID_KEYS: ConfigKey[] = [...ENUM_KEYS, ...NUMERIC_KEYS, ...BOOL_KEYS];
+const VALID_KEYS: ConfigKey[] = [...ENUM_KEYS, ...NUMERIC_KEYS];
 
 const VALID_VALUES: Record<EnumConfigKey, string[]> = {
   mode: ['polling', 'wait'],
@@ -40,10 +38,6 @@ function isNumericKey(key: ConfigKey): key is NumericConfigKey {
   return NUMERIC_KEYS.includes(key as NumericConfigKey);
 }
 
-function isBoolKey(key: ConfigKey): key is BoolConfigKey {
-  return BOOL_KEYS.includes(key as BoolConfigKey);
-}
-
 function isValidValue(key: EnumConfigKey, value: string): boolean {
   return VALID_VALUES[key].includes(value);
 }
@@ -62,7 +56,6 @@ function showConfig(ctx: Context): void {
         mode: ctx.config.mode,
         preambleMode: ctx.config.preambleMode,
         preambleEvery: ctx.config.defaults.preambleEvery,
-        hideOrphanTasks: ctx.config.defaults.hideOrphanTasks,
         defaults: ctx.config.defaults,
       },
       sources: {
@@ -78,8 +71,6 @@ function showConfig(ctx: Context): void {
             : globalConfig.defaults?.preambleEvery !== undefined
               ? 'global'
               : 'default',
-        hideOrphanTasks:
-          globalConfig.defaults?.hideOrphanTasks !== undefined ? 'global' : 'default',
       },
       paths: {
         global: ctx.paths.globalConfig,
@@ -102,8 +93,6 @@ function showConfig(ctx: Context): void {
       : globalConfig.defaults?.preambleEvery !== undefined
         ? '(global)'
         : '(default)';
-  const hideOrphanSource =
-    globalConfig.defaults?.hideOrphanTasks !== undefined ? '(global)' : '(default)';
 
   ctx.ui.info('Current configuration:\n');
   ctx.ui.table(
@@ -112,7 +101,6 @@ function showConfig(ctx: Context): void {
       ['mode', ctx.config.mode, modeSource],
       ['preambleMode', ctx.config.preambleMode, preambleSource],
       ['preambleEvery', String(ctx.config.defaults.preambleEvery), preambleEverySource],
-      ['hideOrphanTasks', String(ctx.config.defaults.hideOrphanTasks), hideOrphanSource],
       ['defaults.timeout', String(ctx.config.defaults.timeout), '(global)'],
       ['defaults.pollInterval', String(ctx.config.defaults.pollInterval), '(global)'],
       ['defaults.captureLines', String(ctx.config.defaults.captureLines), '(global)'],
@@ -154,31 +142,6 @@ function setConfig(ctx: Context, key: string, value: string, global: boolean): v
     }
   }
 
-  if (isBoolKey(validKey)) {
-    if (value !== 'true' && value !== 'false') {
-      ctx.ui.error(`Invalid value for ${key}: ${value}. Use true or false.`);
-      ctx.exit(ExitCodes.ERROR);
-    }
-  }
-
-  if (key === 'hideOrphanTasks') {
-    const globalConfig = loadGlobalConfig(ctx.paths);
-    if (!globalConfig.defaults) {
-      globalConfig.defaults = {
-        timeout: 180,
-        pollInterval: 1,
-        captureLines: 100,
-        preambleEvery: ctx.config.defaults.preambleEvery,
-        hideOrphanTasks: value === 'true',
-      };
-    } else {
-      globalConfig.defaults.hideOrphanTasks = value === 'true';
-    }
-    saveGlobalConfig(ctx.paths, globalConfig);
-    ctx.ui.success(`Set ${key}=${value} in global config`);
-    return;
-  }
-
   if (global) {
     // Set in global config
     const globalConfig = loadGlobalConfig(ctx.paths);
@@ -193,7 +156,6 @@ function setConfig(ctx: Context, key: string, value: string, global: boolean): v
           pollInterval: 1,
           captureLines: 100,
           preambleEvery: parseInt(value, 10),
-          hideOrphanTasks: ctx.config.defaults.hideOrphanTasks,
         };
       } else {
         globalConfig.defaults.preambleEvery = parseInt(value, 10);
@@ -223,10 +185,6 @@ function clearConfig(ctx: Context, key?: string): void {
       ctx.ui.error(`Invalid key: ${key}. Valid keys: ${VALID_KEYS.join(', ')}`);
       ctx.exit(ExitCodes.ERROR);
     }
-    if (key === 'hideOrphanTasks') {
-      ctx.ui.error(`Cannot clear global-only key: ${key}. Edit global config instead.`);
-      ctx.exit(ExitCodes.ERROR);
-    }
 
     // Clear specific key from local settings
     const localConfigFile = loadLocalConfigFile(ctx.paths);

package/src/commands/help.ts

@@ -42,7 +42,6 @@ ${colors.yellow('COMMANDS')}
   ${colors.green('init')}                        Create empty tmux-team.json
   ${colors.green('config')} [show|set|clear]     View/modify settings
   ${colors.green('preamble')} [show|set|clear]   Manage agent preambles
-  ${colors.green('pm')} <subcommand>             Project management (run 'pm help')
   ${colors.green('completion')}                  Output shell completion script
   ${colors.green('help')}                        Show this help message
 
@@ -80,6 +79,5 @@ ${colors.yellow('CHANGE MODE')}
   tmux-team config set mode polling         ${colors.dim('Enable polling mode (local)')}
   tmux-team config set preambleMode disabled ${colors.dim('Disable preambles (local)')}
   tmux-team config set preambleEvery 5      ${colors.dim('Inject preamble every 5 messages')}
-  tmux-team config set hideOrphanTasks true ${colors.dim('Hide tasks without milestones (global)')}
 `);
 }