tmux-team 1.0.0

package/README.md

@@ -0,0 +1,70 @@
+# tmux-team
+
+CLI for multi-agent collaboration in tmux. Coordinate AI agents (Claude, Codex, Gemini) working in different panes.
+
+## Installation
+
+```bash
+npm install -g tmux-team
+```
+
+### Shell Completion
+
+```bash
+# Zsh (add to ~/.zshrc)
+eval "$(tmux-team completion zsh)"
+
+# Bash (add to ~/.bashrc)
+eval "$(tmux-team completion bash)"
+```
+
+### Claude Code Plugin
+
+```
+/plugin marketplace add anthropics/tmux-team
+/plugin install tmux-team@tmux-team
+```
+
+## Quick Start
+
+```bash
+# Setup agents
+tmux-team add claude 10.0 "Frontend"
+tmux-team add codex 10.1 "Backend"
+tmux-team add gemini 10.2 "Testing"
+
+# Talk to agents
+tmux-team talk codex "Review the auth module"
+tmux-team talk all "Starting the refactor"
+
+# Read responses
+tmux-team check codex
+
+# Manage agents
+tmux-team list
+tmux-team remove gemini
+```
+
+## From Claude Code
+
+```
+/team codex "Can you review my changes?"
+/team all "I'm refactoring the database schema"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `talk <agent> <msg>` | Send message to agent (or "all") |
+| `check <agent> [lines]` | Read agent's output |
+| `list` | List configured agents |
+| `add <name> <pane> [remark]` | Add agent |
+| `update <name> --pane/--remark` | Update agent |
+| `remove <name>` | Remove agent |
+| `init` | Create tmux-team.json |
+| `completion [zsh\|bash]` | Output completion script |
+
+## License
+
+MIT

package/bin/tmux-team

@@ -0,0 +1,432 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync, spawn } = require('child_process');
+
+const CONFIG_FILE = './tmux-team.json';
+const VERSION = '1.0.0';
+
+// ─────────────────────────────────────────────────────────────
+// Colors (only when stdout is a TTY)
+// ─────────────────────────────────────────────────────────────
+const isTTY = process.stdout.isTTY;
+const colors = {
+  red: (s) => isTTY ? `\x1b[31m${s}\x1b[0m` : s,
+  green: (s) => isTTY ? `\x1b[32m${s}\x1b[0m` : s,
+  yellow: (s) => isTTY ? `\x1b[33m${s}\x1b[0m` : s,
+  blue: (s) => isTTY ? `\x1b[34m${s}\x1b[0m` : s,
+  cyan: (s) => isTTY ? `\x1b[36m${s}\x1b[0m` : s,
+};
+
+// ─────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────
+function error(msg) {
+  console.error(`${colors.red('❌ Error:')} ${msg}`);
+  process.exit(1);
+}
+
+function success(msg) {
+  console.log(`${colors.green('✓')} ${msg}`);
+}
+
+function info(msg) {
+  console.log(`${colors.blue('ℹ')} ${msg}`);
+}
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    error(`${CONFIG_FILE} not found. Run 'tmux-team init' to create one.`);
+  }
+  return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+}
+
+function saveConfig(config) {
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+
+// ─────────────────────────────────────────────────────────────
+// Commands
+// ─────────────────────────────────────────────────────────────
+function showHelp() {
+  console.log(`
+${colors.cyan('tmux-team')} v${VERSION} - AI agent collaboration in tmux
+
+${colors.yellow('USAGE')}
+  tmux-team <command> [arguments]
+
+${colors.yellow('COMMANDS')}
+  ${colors.green('talk')} <target> <message>     Send message to an agent (or "all")
+  ${colors.green('check')} <target> [lines]      Capture output from agent's pane
+  ${colors.green('list')}                        List all configured agents
+  ${colors.green('add')} <name> <pane> [remark]  Add a new agent
+  ${colors.green('update')} <name> [options]     Update an agent's config
+  ${colors.green('remove')} <name>               Remove an agent
+  ${colors.green('init')}                        Create empty tmux-team.json
+  ${colors.green('init-claude')}                 Show Claude Code plugin install instructions
+  ${colors.green('completion')}                  Output shell completion script
+  ${colors.green('help')}                        Show this help message
+
+${colors.yellow('EXAMPLES')}
+  tmux-team talk codex "Please review the PR"
+  tmux-team talk all "Sync meeting in 5 minutes"
+  tmux-team check gemini 50
+  tmux-team list
+  tmux-team add codex 10.1 "Code review specialist"
+  tmux-team update codex --pane 10.2
+  tmux-team update codex --remark "New description"
+  tmux-team remove codex
+
+${colors.yellow('CONFIG FILE')}
+  Uses ./tmux-team.json in current directory:
+  {
+    "codex": { "pane": "10.1", "remark": "Code reviewer" },
+    "gemini": { "pane": "10.2", "remark": "Implementation" }
+  }
+`);
+}
+
+function cmdInit() {
+  if (fs.existsSync(CONFIG_FILE)) {
+    error(`${CONFIG_FILE} already exists. Remove it first if you want to reinitialize.`);
+  }
+  fs.writeFileSync(CONFIG_FILE, '{}\n');
+  success(`Created ${CONFIG_FILE}`);
+}
+
+function cmdCompletion(shell) {
+  const zshCompletion = `#compdef tmux-team
+
+_tmux-team() {
+  local -a commands agents
+
+  commands=(
+    'talk:Send message to an agent'
+    'check:Capture output from agent pane'
+    'list:List all configured agents'
+    'add:Add a new agent'
+    'update:Update agent config'
+    'remove:Remove an agent'
+    'init:Create empty tmux-team.json'
+    'init-claude:Show Claude Code plugin install instructions'
+    'completion:Output shell completion script'
+    'help:Show help message'
+  )
+
+  _get_agents() {
+    if [[ -f ./tmux-team.json ]]; then
+      agents=(\${(f)"$(node -e "console.log(Object.keys(JSON.parse(require('fs').readFileSync('./tmux-team.json'))).join('\\\\n'))" 2>/dev/null)"})
+    fi
+  }
+
+  if (( CURRENT == 2 )); then
+    _describe -t commands 'tmux-team commands' commands
+  elif (( CURRENT == 3 )); then
+    case \${words[2]} in
+      talk|check|update|remove|rm)
+        _get_agents
+        if [[ -n "\$agents" ]]; then
+          _describe -t agents 'agents' agents
+        fi
+        if [[ "\${words[2]}" == "talk" ]]; then
+          compadd "all"
+        fi
+        ;;
+      completion)
+        compadd "zsh" "bash"
+        ;;
+    esac
+  elif (( CURRENT == 4 )); then
+    case \${words[2]} in
+      update)
+        compadd -- "--pane" "--remark"
+        ;;
+    esac
+  fi
+}
+
+_tmux-team "\$@"`;
+
+  const bashCompletion = `_tmux_team() {
+  local cur prev commands agents
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  commands="talk check list add update remove init init-claude completion help"
+
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "\${commands}" -- \${cur}) )
+  elif [[ \${COMP_CWORD} -eq 2 ]]; then
+    case "\${prev}" in
+      talk|check|update|remove|rm)
+        if [[ -f ./tmux-team.json ]]; then
+          agents=$(node -e "console.log(Object.keys(JSON.parse(require('fs').readFileSync('./tmux-team.json'))).join(' '))" 2>/dev/null)
+        fi
+        if [[ "\${prev}" == "talk" ]]; then
+          agents="\${agents} all"
+        fi
+        COMPREPLY=( $(compgen -W "\${agents}" -- \${cur}) )
+        ;;
+      completion)
+        COMPREPLY=( $(compgen -W "zsh bash" -- \${cur}) )
+        ;;
+    esac
+  elif [[ \${COMP_CWORD} -eq 3 ]]; then
+    case "\${COMP_WORDS[1]}" in
+      update)
+        COMPREPLY=( $(compgen -W "--pane --remark" -- \${cur}) )
+        ;;
+    esac
+  fi
+}
+
+complete -F _tmux_team tmux-team`;
+
+  if (shell === 'bash') {
+    console.log(bashCompletion);
+  } else if (shell === 'zsh') {
+    console.log(zshCompletion);
+  } else {
+    console.log(`
+${colors.cyan('Shell Completion Setup')}
+
+${colors.yellow('Zsh')} (add to ~/.zshrc):
+  eval "$(tmux-team completion zsh)"
+
+${colors.yellow('Bash')} (add to ~/.bashrc):
+  eval "$(tmux-team completion bash)"
+
+Then restart your shell or run: source ~/.zshrc (or ~/.bashrc)
+`);
+  }
+}
+
+function cmdInitClaude() {
+  console.log(`
+${colors.cyan('To install the tmux-team plugin in Claude Code:')}
+
+  ${colors.green('1.')} Open Claude Code
+  ${colors.green('2.')} Run these commands:
+
+     ${colors.yellow('/plugin marketplace add anthropics/tmux-team')}
+     ${colors.yellow('/plugin install tmux-team@tmux-team')}
+
+  ${colors.green('3.')} Use the slash command:
+
+     ${colors.yellow('/team codex "your message"')}
+     ${colors.yellow('/team gemini "please review this PR"')}
+`);
+}
+
+function cmdList() {
+  const config = loadConfig();
+  const agents = Object.keys(config);
+
+  if (agents.length === 0) {
+    info("No agents configured. Use 'tmux-team add <name> <pane>' to add one.");
+    return;
+  }
+
+  console.log(`\n${colors.cyan('Configured agents:')}\n`);
+  console.log(`  ${colors.yellow('NAME'.padEnd(12))} ${colors.yellow('PANE'.padEnd(10))} REMARK`);
+  console.log(`  ${'─'.repeat(12)} ${'─'.repeat(10)} ${'─'.repeat(32)}`);
+
+  for (const [name, data] of Object.entries(config)) {
+    console.log(`  ${name.padEnd(12)} ${data.pane.padEnd(10)} ${data.remark || '-'}`);
+  }
+  console.log();
+}
+
+function cmdAdd(name, pane, remark) {
+  let config = {};
+
+  if (fs.existsSync(CONFIG_FILE)) {
+    config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+  } else {
+    info(`Created ${CONFIG_FILE}`);
+  }
+
+  if (config[name]) {
+    error(`Agent '${name}' already exists. Use 'tmux-team update' to modify.`);
+  }
+
+  config[name] = { pane };
+  if (remark) {
+    config[name].remark = remark;
+  }
+
+  saveConfig(config);
+  success(`Added agent '${name}' at pane ${pane}`);
+}
+
+function cmdUpdate(name, args) {
+  const config = loadConfig();
+
+  if (!config[name]) {
+    error(`Agent '${name}' not found. Use 'tmux-team add' to create.`);
+  }
+
+  let newPane = null;
+  let newRemark = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--pane' && args[i + 1]) {
+      newPane = args[++i];
+    } else if (args[i] === '--remark' && args[i + 1]) {
+      newRemark = args[++i];
+    }
+  }
+
+  if (!newPane && !newRemark) {
+    error('No updates specified. Use --pane or --remark.');
+  }
+
+  if (newPane) {
+    config[name].pane = newPane;
+    success(`Updated '${name}' pane to ${newPane}`);
+  }
+
+  if (newRemark) {
+    config[name].remark = newRemark;
+    success(`Updated '${name}' remark`);
+  }
+
+  saveConfig(config);
+}
+
+function cmdRemove(name) {
+  const config = loadConfig();
+
+  if (!config[name]) {
+    error(`Agent '${name}' not found.`);
+  }
+
+  delete config[name];
+  saveConfig(config);
+  success(`Removed agent '${name}'`);
+}
+
+function sendToPane(paneId, message, agentName) {
+  // Special handling: Gemini doesn't like exclamation marks
+  if (agentName === 'gemini') {
+    message = message.replace(/!/g, '');
+  }
+
+  console.log(`${colors.green('🚀')} Sending to ${colors.cyan(agentName)} (${paneId})`);
+
+  try {
+    execSync(`tmux send-keys -t "${paneId}" ${JSON.stringify(message)}`, { stdio: 'inherit' });
+    execSync(`tmux send-keys -t "${paneId}" Enter`, { stdio: 'inherit' });
+  } catch (e) {
+    error(`Failed to send to pane ${paneId}. Is tmux running?`);
+  }
+}
+
+function cmdTalk(target, message) {
+  const config = loadConfig();
+
+  if (target === 'all') {
+    for (const [name, data] of Object.entries(config)) {
+      sendToPane(data.pane, message, name);
+    }
+    return;
+  }
+
+  if (!config[target]) {
+    const available = Object.keys(config).join(', ');
+    error(`Agent '${target}' not found. Available: ${available}`);
+  }
+
+  sendToPane(config[target].pane, message, target);
+}
+
+function cmdCheck(target, lines = 100) {
+  const config = loadConfig();
+
+  if (!config[target]) {
+    const available = Object.keys(config).join(', ');
+    error(`Agent '${target}' not found. Available: ${available}`);
+  }
+
+  const pane = config[target].pane;
+  console.log(`${colors.cyan(`─── Output from ${target} (${pane}) ───`)}`);
+
+  try {
+    execSync(`tmux capture-pane -t "${pane}" -p -S -${lines}`, { stdio: 'inherit' });
+  } catch (e) {
+    error(`Failed to capture pane ${pane}. Is tmux running?`);
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (!command || command === 'help' || command === '--help' || command === '-h') {
+  showHelp();
+  process.exit(0);
+}
+
+switch (command) {
+  case 'init':
+    cmdInit();
+    break;
+
+  case 'init-claude':
+    cmdInitClaude();
+    break;
+
+  case 'completion':
+    cmdCompletion(args[1]);
+    break;
+
+  case 'list':
+  case 'ls':
+    cmdList();
+    break;
+
+  case 'add':
+    if (args.length < 3) {
+      error('Usage: tmux-team add <name> <pane> [remark]');
+    }
+    cmdAdd(args[1], args[2], args[3]);
+    break;
+
+  case 'update':
+    if (args.length < 2) {
+      error('Usage: tmux-team update <name> --pane <pane> | --remark <remark>');
+    }
+    cmdUpdate(args[1], args.slice(2));
+    break;
+
+  case 'remove':
+  case 'rm':
+    if (args.length < 2) {
+      error('Usage: tmux-team remove <name>');
+    }
+    cmdRemove(args[1]);
+    break;
+
+  case 'talk':
+  case 'send':
+    if (args.length < 3) {
+      error('Usage: tmux-team talk <target> <message>');
+    }
+    cmdTalk(args[1], args[2]);
+    break;
+
+  case 'check':
+  case 'read':
+    if (args.length < 2) {
+      error('Usage: tmux-team check <target> [lines]');
+    }
+    cmdCheck(args[1], parseInt(args[2]) || 100);
+    break;
+
+  default:
+    error(`Unknown command: ${command}. Run 'tmux-team help' for usage.`);
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "tmux-team",
+  "version": "1.0.0",
+  "description": "CLI tool for AI agent collaboration in tmux - manage cross-pane communication",
+  "bin": {
+    "tmux-team": "./bin/tmux-team"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "tmux",
+    "cli",
+    "ai",
+    "agent",
+    "collaboration",
+    "multi-agent"
+  ],
+  "author": "Ben Hsieh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthropics/tmux-team.git"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "files": [
+    "bin"
+  ]
+}