tmux-team 3.2.3 → 3.3.0

package/README.md

@@ -16,60 +16,75 @@ npm install -g tmux-team
 
 ```bash
 # 1. Install for your AI agent
-tmux-team install claude   # or: tmux-team install codex
+tmt install claude   # or: tmt install codex
 
-# 2. Run the setup wizard (auto-detects panes)
-tmux-team setup
+# 2. Go to working folder and initialize
+tmt init
 
-# 3. Talk to agents
-tmux-team talk codex "Review this code" --wait
+# 3. Register agents (run inside each agent's pane)
+tmt this claude      # registers current pane as "claude"
+tmt this codex       # registers current pane as "codex"
+
+# 4. Talk to agents
+tmt talk codex "Review this code"    # waits for response by default
+
+# 5. Update or remove an agent
+tmt update codex --pane 2.3
+tmt rm codex
+```
+
+> **Tip:** Most AI agents support `!` to run bash commands. From inside Claude Code, Codex, or Gemini CLI, you can run `!tmt this myname` to quickly register that pane.
+
+## Cross-Folder Collaboration
+
+Agents don't need to be in the same folder to collaborate. You can add an agent from one project to another:
+
+```bash
+# In project-a folder, add an agent that's running in project-b
+tmt add codex-reviewer 5.1    # Use the pane ID from the other project
 ```
 
-The `--wait` flag blocks until the agent responds, returning the response directly.
+Find pane IDs with: `tmux display-message -p "#{pane_id}"`
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `install [claude\|codex]` | Install tmux-team for an AI agent |
-| `setup` | Interactive wizard to configure agents |
-| `talk <agent> "msg" --wait` | Send message and wait for response |
-| `talk all "msg" --wait` | Broadcast to all agents |
-| `check <agent> [lines]` | Read agent's pane output (fallback if --wait times out) |
+| `this <name> [remark]` | Register current pane as an agent |
+| `talk <agent> "msg"` | Send message and wait for response |
+| `talk all "msg"` | Broadcast to all agents |
+| `check <agent> [lines]` | Read agent's pane output |
 | `list` | Show configured agents |
 | `learn` | Show educational guide |
 
-**Options for `talk --wait`:**
+**Options for `talk`:**
 - `--timeout <seconds>` - Max wait time (default: 180s)
 - `--lines <number>` - Lines to capture from response (default: 100)
 
-Run `tmux-team help` for all commands and options.
+Run `tmt help` for all commands and options.
 
 ## Managing Your Team
 
 Configuration lives in `tmux-team.json` in your project root.
 
-**Create** - Run the setup wizard to auto-detect agents:
-```bash
-tmux-team setup
-```
-
-**Read** - List configured agents:
+**List** - Show configured agents:
 ```bash
-tmux-team list
+tmt ls
 ```
 
-**Update** - Edit `tmux-team.json` directly or re-run setup:
+**Edit** - Modify `tmux-team.json` directly:
 ```json
 {
-  "codex": { "pane": "%1", "remark": "Code reviewer" },
-  "gemini": { "pane": "%2", "remark": "Documentation" }
+  "codex": { "pane": "1.1", "remark": "Code reviewer" },
+  "gemini": { "pane": "1.2", "remark": "Documentation" }
 }
 ```
 
-**Delete** - Remove an agent entry from `tmux-team.json` or delete the file entirely.
-
-Find pane IDs: `tmux display-message -p "#{pane_id}"`
+**Remove** - Delete an agent:
+```bash
+tmt rm codex
+```
 
 ## Claude Code Plugin
 
@@ -88,8 +103,8 @@ Run this once when starting a session. Claude will understand how to coordinate
 
 **`/team`** - Talk to other agents
 ```
-/team talk codex "Review my authentication changes" --wait
-/team talk all "I'm starting the database migration" --wait
+/team talk codex "Review my authentication changes"
+/team talk all "I'm starting the database migration"
 /team list
 ```
 Use this to delegate tasks, ask for reviews, or broadcast updates.
@@ -97,8 +112,8 @@ Use this to delegate tasks, ask for reviews, or broadcast updates.
 ## Learn More
 
 ```bash
-tmux-team learn   # Comprehensive guide
-tmux-team help    # All commands and options
+tmt learn   # Comprehensive guide
+tmt help    # All commands and options
 ```
 
 ## License

package/bin/tmux-team

@@ -3,17 +3,24 @@
 // Thin wrapper that uses tsx to run the TypeScript CLI
 // tsx is a runtime dependency for v2
 import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 import { dirname, join } from 'path';
-import { existsSync } from 'fs';
+import { createRequire } from 'module';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const cliPath = join(__dirname, '..', 'src', 'cli.ts');
 
 // Prefer Node's --import hook over the tsx CLI (sandbox-friendly).
-// Use an absolute path so it works regardless of the user's cwd.
-const localTsxImport = join(__dirname, '..', 'node_modules', 'tsx', 'dist', 'esm', 'index.mjs');
-const tsxImport = existsSync(localTsxImport) ? localTsxImport : 'tsx';
+// Resolve `tsx` relative to *this installed package*, not the user's cwd.
+const require = createRequire(import.meta.url);
+let tsxImport;
+try {
+  tsxImport = pathToFileURL(require.resolve('tsx')).href;
+} catch {
+  console.error('Error: failed to resolve the `tsx` dependency from the tmux-team installation.');
+  console.error('Try reinstalling tmux-team (or ensure it was installed with its dependencies).');
+  process.exit(1);
+}
 
 const child = spawn(process.execPath, ['--import', tsxImport, cliPath, ...process.argv.slice(2)], {
   stdio: 'inherit',

package/package.json

@@ -1,12 +1,25 @@
 {
   "name": "tmux-team",
-  "version": "3.2.3",
+  "version": "3.3.0",
   "description": "CLI tool for AI agent collaboration in tmux - manage cross-pane communication",
   "type": "module",
   "bin": {
     "tmux-team": "./bin/tmux-team",
     "tmt": "./bin/tmux-team"
   },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "tmt": "./bin/tmux-team",
+    "test": "pnpm test:run",
+    "test:watch": "vitest",
+    "test:run": "vitest run --coverage && node scripts/check-coverage.mjs --threshold 95",
+    "lint": "oxlint src/",
+    "lint:fix": "oxlint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "type:check": "tsc --noEmit",
+    "check": "pnpm type:check && pnpm lint && pnpm format:check"
+  },
   "keywords": [
     "tmux",
     "cli",
@@ -24,6 +37,7 @@
   "engines": {
     "node": ">=18"
   },
+  "packageManager": "pnpm@9.15.4",
   "os": [
     "darwin",
     "linux"
@@ -43,18 +57,5 @@
     "prettier": "^3.7.4",
     "typescript": "^5.3.0",
     "vitest": "^1.2.0"
-  },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "tmt": "./bin/tmux-team",
-    "test": "pnpm test:run",
-    "test:watch": "vitest",
-    "test:run": "vitest run --coverage && node scripts/check-coverage.mjs --threshold 95",
-    "lint": "oxlint src/",
-    "lint:fix": "oxlint src/ --fix",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/",
-    "type:check": "tsc --noEmit",
-    "check": "pnpm type:check && pnpm lint && pnpm format:check"
   }
-}
+}

package/skills/README.md

@@ -29,7 +29,7 @@ tmux-team install claude
 tmux-team install codex
 ```
 
-After installation, run `tmux-team setup` to configure your agents interactively.
+After installation, run `tmux-team add <name> <pane>` to register your agents, or use `tmux-team this <name>` inside each agent's tmux pane.
 
 ## Claude Code
 

package/src/bin-wrapper.test.ts

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest';
+import { spawnSync } from 'node:child_process';
+import { copyFileSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+describe('bin/tmux-team wrapper', () => {
+  it('runs from a non-project cwd with hoisted tsx', () => {
+    const repoRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+    const tempRoot = mkdtempSync(join(repoRoot, '.tmp-bin-wrapper-'));
+
+    try {
+      const projectRoot = join(tempRoot, 'project');
+      const userCwd = join(tempRoot, 'cwd');
+
+      const installedPkgRoot = join(projectRoot, 'node_modules', 'tmux-team');
+      const installedBin = join(installedPkgRoot, 'bin', 'tmux-team');
+      const installedCli = join(installedPkgRoot, 'src', 'cli.ts');
+
+      mkdirSync(join(installedPkgRoot, 'bin'), { recursive: true });
+      mkdirSync(join(installedPkgRoot, 'src'), { recursive: true });
+      mkdirSync(join(projectRoot, 'node_modules'), { recursive: true });
+      mkdirSync(userCwd, { recursive: true });
+
+      // Ensure Node treats the extensionless bin file as ESM (like a real install).
+      writeFileSync(
+        join(installedPkgRoot, 'package.json'),
+        JSON.stringify({ name: 'tmux-team', version: '0.0.0-test', type: 'module' })
+      );
+
+      copyFileSync(join(repoRoot, 'bin', 'tmux-team'), installedBin);
+      writeFileSync(installedCli, 'process.exit(0);\n');
+
+      // Simulate hoisting: tsx is present at the project root, not inside tmux-team/node_modules.
+      const require = createRequire(import.meta.url);
+      const tsxDir = dirname(require.resolve('tsx/package.json'));
+      symlinkSync(tsxDir, join(projectRoot, 'node_modules', 'tsx'), 'dir');
+
+      const result = spawnSync(process.execPath, [installedBin, '--help'], {
+        cwd: userCwd,
+        encoding: 'utf8',
+      });
+
+      expect(result.status).toBe(0);
+    } finally {
+      rmSync(tempRoot, { recursive: true, force: true });
+    }
+  });
+});