tmux-team 4.0.0 → 4.2.0

package/src/commands/completion.ts

@@ -16,15 +16,15 @@ _tmux-team() {
     'add:Add a new agent'
     'update:Update agent config'
     'remove:Remove an agent'
-    'init:Create empty tmux-team.json'
+    'migrate:Copy legacy tmux-team.json registry into tmux metadata'
+    'team:Manage shared teams'
+    'init:Create empty legacy tmux-team.json'
     '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
+    agents=(\${(f)"$(tmux-team list --json 2>/dev/null | node -e 'let s="";process.stdin.on("data",d=>s+=d);process.stdin.on("end",()=>{try{const j=JSON.parse(s); console.log(Object.keys(j.agents||{}).join("\\n"))}catch{}})')"})
   }
 
   if (( CURRENT == 2 )); then
@@ -64,16 +64,14 @@ const bashCompletion = `_tmux_team() {
   cur="\${COMP_WORDS[COMP_CWORD]}"
   prev="\${COMP_WORDS[COMP_CWORD-1]}"
 
-  commands="talk check list add update remove init completion help"
+  commands="talk check list add update remove migrate team init 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
+        agents=$(tmux-team list --json 2>/dev/null | node -e 'let s="";process.stdin.on("data",d=>s+=d);process.stdin.on("end",()=>{try{const j=JSON.parse(s); console.log(Object.keys(j.agents||{}).join(" "))}catch{}})')
         if [[ "\${prev}" == "talk" ]]; then
           agents="\${agents} all"
         fi

package/src/commands/config-command.test.ts

@@ -51,6 +51,13 @@ function createCtx(
     capture: vi.fn(),
     listPanes: vi.fn(() => []),
     getCurrentPaneId: vi.fn(() => null),
+    resolvePaneTarget: vi.fn((target: string) => target),
+    getAgentRegistry: vi.fn(() => ({ paneRegistry: {}, agents: {} })),
+    setAgentRegistration: vi.fn(),
+    clearAgentRegistration: vi.fn(() => false),
+    listTeams: vi.fn(() => ({})),
+    listTeamPanes: vi.fn(() => []),
+    removeTeam: vi.fn(() => ({ removed: 0, agents: [] })),
   };
   return {
     argv: [],
@@ -167,10 +174,7 @@ describe('cmdConfig', () => {
 
   it('shows sources in table mode with local settings', () => {
     const ctx = createCtx(testDir);
-    fs.writeFileSync(
-      ctx.paths.localConfig,
-      JSON.stringify({ $config: { mode: 'wait' } })
-    );
+    fs.writeFileSync(ctx.paths.localConfig, JSON.stringify({ $config: { mode: 'wait' } }));
     cmdConfig(ctx, ['show']);
     expect(ctx.ui.table).toHaveBeenCalled();
     // The table call should include (local) source
@@ -181,10 +185,7 @@ describe('cmdConfig', () => {
   it('shows sources in table mode with global settings', () => {
     const ctx = createCtx(testDir);
     fs.mkdirSync(ctx.paths.globalDir, { recursive: true });
-    fs.writeFileSync(
-      ctx.paths.globalConfig,
-      JSON.stringify({ mode: 'wait' })
-    );
+    fs.writeFileSync(ctx.paths.globalConfig, JSON.stringify({ mode: 'wait' }));
     cmdConfig(ctx, ['show']);
     expect(ctx.ui.table).toHaveBeenCalled();
     const tableCall = (ctx.ui.table as ReturnType<typeof vi.fn>).mock.calls[0];

package/src/commands/config.ts

@@ -114,11 +114,7 @@ function showConfig(ctx: Context): void {
       ['mode', ctx.config.mode, modeSource],
       ['preambleMode', ctx.config.preambleMode, preambleSource],
       ['preambleEvery', String(ctx.config.defaults.preambleEvery), preambleEverySource],
-      [
-        'pasteEnterDelayMs',
-        String(ctx.config.defaults.pasteEnterDelayMs),
-        pasteEnterDelaySource,
-      ],
+      ['pasteEnterDelayMs', String(ctx.config.defaults.pasteEnterDelayMs), pasteEnterDelaySource],
       ['defaults.timeout', String(ctx.config.defaults.timeout), '(global)'],
       ['defaults.pollInterval', String(ctx.config.defaults.pollInterval), '(global)'],
       ['defaults.captureLines', String(ctx.config.defaults.captureLines), '(global)'],

package/src/commands/help.ts

@@ -47,11 +47,13 @@ ${colors.yellow('USAGE')}
 ${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('list')} [team|pane]             List workspace, team, or pane status
   ${colors.green('add')} <name> <pane> [remark]  Add a new agent
   ${colors.green('this')} <name> [remark]       Register current pane as an agent
   ${colors.green('update')} <name> [options]     Update an agent's config
   ${colors.green('remove')} <name>               Remove an agent
+  ${colors.green('migrate')} [--dry-run]          Copy legacy JSON registry to tmux metadata
+  ${colors.green('team')} [ls|add|rm|panes]       Manage shared teams
   ${colors.green('install')} [claude|codex]       Install tmux-team for an AI agent
   ${colors.green('init')}                        Create empty tmux-team.json
   ${colors.green('config')} [show|set|clear]     View/modify settings
@@ -86,12 +88,15 @@ ${colors.yellow('EXAMPLES')}${
   tmux-team check codex                     ${colors.dim('← read response later')}`
   }
   tmux-team list --json
+  tmux-team list acme-app
+  tmux-team list main.1.0
   tmux-team add codex 10.1 "Code review specialist"
 
 ${colors.yellow('CONFIG')}
-  Local:  ./tmux-team.json (pane registry + $config override)
+  Runtime: tmux pane metadata (agent registry)
+  Local:  ./tmux-team.json (legacy registry + $config override)
   Global: ~/.config/tmux-team/config.json (settings)
-  Teams:  ~/.config/tmux-team/teams/<name>.json (shared teams)
+  Teams:  tmux pane metadata; team panes shows cwd + workspace/team scopes
 
 ${colors.yellow('CHANGE MODE')}
   tmux-team config set mode wait            ${colors.dim('Enable wait mode (local)')}

package/src/commands/install.test.ts

@@ -26,7 +26,14 @@ function createCtx(testDir: string, overrides?: Partial<{ flags: Partial<Flags>
   const config: ResolvedConfig = {
     mode: 'polling',
     preambleMode: 'always',
-    defaults: { timeout: 180, pollInterval: 1, captureLines: 100, maxCaptureLines: 2000, preambleEvery: 3, pasteEnterDelayMs: 500 },
+    defaults: {
+      timeout: 180,
+      pollInterval: 1,
+      captureLines: 100,
+      maxCaptureLines: 2000,
+      preambleEvery: 3,
+      pasteEnterDelayMs: 500,
+    },
     agents: {},
     paneRegistry: {},
   };
@@ -36,6 +43,13 @@ function createCtx(testDir: string, overrides?: Partial<{ flags: Partial<Flags>
     capture: vi.fn(),
     listPanes: vi.fn(() => []),
     getCurrentPaneId: vi.fn(() => null),
+    resolvePaneTarget: vi.fn((target: string) => target),
+    getAgentRegistry: vi.fn(() => ({ paneRegistry: {}, agents: {} })),
+    setAgentRegistration: vi.fn(),
+    clearAgentRegistration: vi.fn(() => false),
+    listTeams: vi.fn(() => ({})),
+    listTeamPanes: vi.fn(() => []),
+    removeTeam: vi.fn(() => ({ removed: 0, agents: [] })),
   };
   return {
     argv: [],

package/src/commands/list.ts

@@ -3,9 +3,22 @@
 // ─────────────────────────────────────────────────────────────
 
 import type { Context } from '../types.js';
+import { listPaneStatus, listTeamMembers } from './team.js';
 
-export function cmdList(ctx: Context): void {
+export function cmdList(ctx: Context, target?: string): void {
   const { ui, config, flags } = ctx;
+
+  if (target) {
+    const teams = ctx.tmux.listTeams();
+    if (teams[target]) {
+      listTeamMembers(ctx, [target]);
+      return;
+    }
+
+    listPaneStatus(ctx, target);
+    return;
+  }
+
   const agents = Object.entries(config.paneRegistry);
 
   if (flags.json) {
@@ -15,7 +28,9 @@ export function cmdList(ctx: Context): void {
 
   if (agents.length === 0) {
     if (flags.team) {
-      ui.info(`No agents in team "${flags.team}". Use 'tmt this <name> --team ${flags.team}' to add one.`);
+      ui.info(
+        `No agents in team "${flags.team}". Use 'tmt this <name> --team ${flags.team}' to add one.`
+      );
     } else {
       ui.info("No agents configured. Use 'tmux-team add <name> <pane>' to add one.");
     }
@@ -26,6 +41,10 @@ export function cmdList(ctx: Context): void {
   if (flags.team) {
     console.log(`Team: ${flags.team}`);
     console.log();
+  } else if (config.registrySource === 'legacy') {
+    ui.warn(
+      'Using legacy tmux-team.json registry. Run `tmt migrate` to store registrations in tmux.'
+    );
   }
   ui.table(
     ['NAME', 'PANE', 'REMARK'],

package/src/commands/migrate.ts

@@ -0,0 +1,84 @@
+// ─────────────────────────────────────────────────────────────
+// migrate command - copy legacy JSON registry into tmux metadata
+// ─────────────────────────────────────────────────────────────
+
+import type { Context, PaneEntry } from '../types.js';
+import { ExitCodes } from '../exits.js';
+import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
+import { getRegistryScope, registrationFromEntry, scopeLabel } from '../registry.js';
+
+interface MigrationItem {
+  agent: string;
+  fromPane: string;
+  pane: string;
+  remark?: string;
+  status: 'ready' | 'migrated';
+}
+
+export function cmdMigrate(ctx: Context, args: string[]): void {
+  const dryRun = args.includes('--dry-run');
+  const cleanup = args.includes('--cleanup');
+  const { ui, paths, flags, tmux, exit } = ctx;
+  const localConfig = loadLocalConfigFile(paths);
+  const scope = getRegistryScope(ctx);
+  const items: MigrationItem[] = [];
+
+  for (const [agentName, rawEntry] of Object.entries(localConfig)) {
+    if (agentName === '$config') continue;
+    const entry = rawEntry as PaneEntry | undefined;
+    if (!entry?.pane) continue;
+
+    const pane = tmux.resolvePaneTarget(entry.pane);
+    if (!pane) {
+      ui.error(`Pane '${entry.pane}' for agent '${agentName}' not found. Is tmux running?`);
+      exit(ExitCodes.PANE_NOT_FOUND);
+    }
+    const paneId = pane as string;
+
+    items.push({
+      agent: agentName,
+      fromPane: entry.pane,
+      pane: paneId,
+      ...(entry.remark !== undefined && { remark: entry.remark }),
+      status: dryRun ? 'ready' : 'migrated',
+    });
+
+    if (!dryRun) {
+      tmux.setAgentRegistration(paneId, scope, registrationFromEntry(agentName, entry));
+    }
+  }
+
+  if (!dryRun && cleanup && items.length > 0) {
+    for (const item of items) {
+      delete localConfig[item.agent];
+    }
+    saveLocalConfigFile(paths, localConfig);
+  }
+
+  if (flags.json) {
+    ui.json({
+      dryRun,
+      cleanup,
+      scope,
+      migrated: dryRun ? 0 : items.length,
+      items,
+    });
+    return;
+  }
+
+  if (items.length === 0) {
+    ui.info(`No legacy agents found in ${paths.localConfig}`);
+    return;
+  }
+
+  const action = dryRun ? 'Would migrate' : 'Migrated';
+  ui.success(`${action} ${items.length} agent(s) to ${scopeLabel(scope)}`);
+  ui.table(
+    ['AGENT', 'FROM', 'PANE', 'REMARK'],
+    items.map((item) => [item.agent, item.fromPane, item.pane, item.remark ?? '-'])
+  );
+
+  if (!dryRun && !cleanup) {
+    ui.info('Legacy JSON was left in place. Use --cleanup to remove migrated agent entries.');
+  }
+}

package/src/commands/preamble.test.ts

@@ -14,7 +14,12 @@ import { cmdPreamble } from './preamble.js';
 // Test utilities
 // ─────────────────────────────────────────────────────────────
 
-function createMockUI(): UI & { errors: string[]; warnings: string[]; infos: string[]; jsonOutput: unknown[] } {
+function createMockUI(): UI & {
+  errors: string[];
+  warnings: string[];
+  infos: string[];
+  jsonOutput: unknown[];
+} {
   const mock = {
     errors: [] as string[],
     warnings: [] as string[],
@@ -48,7 +53,8 @@ function createDefaultConfig(): ResolvedConfig {
       pollInterval: 1,
       captureLines: 100,
       maxCaptureLines: 2000,
-      preambleEvery: 3, pasteEnterDelayMs: 500,
+      preambleEvery: 3,
+      pasteEnterDelayMs: 500,
     },
     agents: {},
     paneRegistry: {
@@ -64,6 +70,13 @@ function createMockTmux(): Tmux {
     capture: vi.fn(() => ''),
     listPanes: vi.fn(() => []),
     getCurrentPaneId: vi.fn(() => null),
+    resolvePaneTarget: vi.fn((target: string) => target),
+    getAgentRegistry: vi.fn(() => ({ paneRegistry: {}, agents: {} })),
+    setAgentRegistration: vi.fn(),
+    clearAgentRegistration: vi.fn(() => false),
+    listTeams: vi.fn(() => ({})),
+    listTeamPanes: vi.fn(() => []),
+    removeTeam: vi.fn(() => ({ removed: 0, agents: [] })),
   };
 }
 

package/src/commands/preamble.ts

@@ -5,6 +5,7 @@
 import type { Context } from '../types.js';
 import { ExitCodes } from '../context.js';
 import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
+import { getRegistryScope, registrationFromEntry } from '../registry.js';
 
 /**
  * Show preamble(s) for agent(s).
@@ -60,7 +61,7 @@ function showPreamble(ctx: Context, agentName?: string): void {
  * Set preamble for an agent (in local config).
  */
 function setPreamble(ctx: Context, agentName: string, preamble: string): void {
-  const { ui, paths, flags, config } = ctx;
+  const { ui, paths, flags, config, tmux } = ctx;
 
   // Check if agent exists in pane registry
   if (!config.paneRegistry[agentName]) {
@@ -69,15 +70,19 @@ function setPreamble(ctx: Context, agentName: string, preamble: string): void {
     ctx.exit(ExitCodes.ERROR);
   }
 
-  const localConfig = loadLocalConfigFile(paths);
-
-  // Update preamble in local config
-  const agentEntry = localConfig[agentName] as { pane: string; preamble?: string } | undefined;
-  if (agentEntry) {
-    agentEntry.preamble = preamble;
+  const pane = tmux.resolvePaneTarget(config.paneRegistry[agentName].pane);
+  if (!pane) {
+    ui.error(`Pane '${config.paneRegistry[agentName].pane}' not found. Is tmux running?`);
+    ctx.exit(ExitCodes.PANE_NOT_FOUND);
   }
 
-  saveLocalConfigFile(paths, localConfig);
+  const nextEntry = { ...config.paneRegistry[agentName], pane, preamble };
+  tmux.setAgentRegistration(
+    pane,
+    getRegistryScope(ctx),
+    registrationFromEntry(agentName, nextEntry)
+  );
+  updateLegacyPreambleIfPresent(paths, agentName, preamble);
 
   if (flags.json) {
     ui.json({ agent: agentName, preamble, status: 'set' });
@@ -90,14 +95,28 @@ function setPreamble(ctx: Context, agentName: string, preamble: string): void {
  * Clear preamble for an agent (in local config).
  */
 function clearPreamble(ctx: Context, agentName: string): void {
-  const { ui, paths, flags } = ctx;
-
-  const localConfig = loadLocalConfigFile(paths);
-  const agentEntry = localConfig[agentName] as { pane?: string; preamble?: string } | undefined;
-
-  if (agentEntry?.preamble) {
-    delete agentEntry.preamble;
-    saveLocalConfigFile(paths, localConfig);
+  const { ui, paths, flags, config, tmux } = ctx;
+
+  const entry = config.paneRegistry[agentName];
+  const hasPreamble =
+    entry?.preamble !== undefined ||
+    config.agents[agentName]?.preamble !== undefined ||
+    legacyHasPreamble(paths, agentName);
+
+  if (entry && hasPreamble) {
+    const pane = tmux.resolvePaneTarget(entry.pane);
+    if (!pane) {
+      ui.error(`Pane '${entry.pane}' not found. Is tmux running?`);
+      ctx.exit(ExitCodes.PANE_NOT_FOUND);
+    }
+    const nextEntry = { ...entry, pane };
+    delete nextEntry.preamble;
+    tmux.setAgentRegistration(
+      pane,
+      getRegistryScope(ctx),
+      registrationFromEntry(agentName, nextEntry)
+    );
+    clearLegacyPreambleIfPresent(paths, agentName);
 
     if (flags.json) {
       ui.json({ agent: agentName, status: 'cleared' });
@@ -113,6 +132,32 @@ function clearPreamble(ctx: Context, agentName: string): void {
   }
 }
 
+function updateLegacyPreambleIfPresent(
+  paths: Context['paths'],
+  agentName: string,
+  preamble: string
+): void {
+  const localConfig = loadLocalConfigFile(paths);
+  const agentEntry = localConfig[agentName] as { pane?: string; preamble?: string } | undefined;
+  if (!agentEntry) return;
+  agentEntry.preamble = preamble;
+  saveLocalConfigFile(paths, localConfig);
+}
+
+function clearLegacyPreambleIfPresent(paths: Context['paths'], agentName: string): void {
+  const localConfig = loadLocalConfigFile(paths);
+  const agentEntry = localConfig[agentName] as { pane?: string; preamble?: string } | undefined;
+  if (!agentEntry || !Object.prototype.hasOwnProperty.call(agentEntry, 'preamble')) return;
+  delete agentEntry.preamble;
+  saveLocalConfigFile(paths, localConfig);
+}
+
+function legacyHasPreamble(paths: Context['paths'], agentName: string): boolean {
+  const localConfig = loadLocalConfigFile(paths);
+  const agentEntry = localConfig[agentName] as { pane?: string; preamble?: string } | undefined;
+  return Boolean(agentEntry && Object.prototype.hasOwnProperty.call(agentEntry, 'preamble'));
+}
+
 /**
  * Preamble command entry point.
  */

package/src/commands/remove.ts

@@ -5,22 +5,26 @@
 import type { Context } from '../types.js';
 import { ExitCodes } from '../exits.js';
 import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
+import { getRegistryScope } from '../registry.js';
 
 export function cmdRemove(ctx: Context, name: string): void {
-  const { ui, config, paths, flags, exit } = ctx;
+  const { ui, config, paths, flags, tmux, exit } = ctx;
 
   if (!config.paneRegistry[name]) {
     ui.error(`Agent '${name}' not found.`);
     exit(ExitCodes.PANE_NOT_FOUND);
   }
 
-  // Load existing config to preserve other agents' fields (preamble, deny, etc.)
-  const localConfig = loadLocalConfigFile(paths);
-  delete localConfig[name];
-  saveLocalConfigFile(paths, localConfig);
+  const removedFromTmux = tmux.clearAgentRegistration(name, getRegistryScope(ctx));
+  if (!removedFromTmux) {
+    // Legacy fallback: remove from tmux-team.json when this scope still uses it.
+    const localConfig = loadLocalConfigFile(paths);
+    delete localConfig[name];
+    saveLocalConfigFile(paths, localConfig);
+  }
 
   if (flags.json) {
-    ui.json({ removed: name });
+    ui.json({ removed: name, source: removedFromTmux ? 'tmux' : 'legacy' });
   } else {
     ui.success(`Removed agent '${name}'`);
   }