tmux-team 2.1.0 → 2.2.0

package/README.md

@@ -24,7 +24,7 @@ Unlike heavyweight frameworks that require specific SDKs or cloud infrastructure
 - **Model Agnostic** — Works with Claude Code, Gemini CLI, Codex, Aider, or any CLI tool
 - **Zero Infrastructure** — No servers, no MCP setup, no complex configuration. If it runs in tmux, tmux-team can talk to it
 - **Whitelist-Friendly** — A single `tmux-team talk:*` prefix covers all operations, keeping AI tool permissions simple and safe
-- **Local-First** — Per-project `tmux-team.json` lives with your repo; global config in `~/.tmux-team/` (v2)
+- **Local-First** — Per-project `tmux-team.json` lives with your repo; global config in `~/.config/tmux-team/`
 
 ---
 
@@ -140,7 +140,7 @@ Once the plugin is installed, coordinate directly from your Claude Code session:
 | `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` | Manage milestones |
+| `pm m add/list/done/delete` | Manage milestones |
 | `pm t add/list/update/done` | Manage tasks |
 | `pm log` | View audit event log |
 | `completion [zsh\|bash]` | Output shell completion script |
@@ -151,33 +151,59 @@ Once the plugin is installed, coordinate directly from your Claude Code session:
 
 ### Local Config (`./tmux-team.json`)
 
-Per-project agent registry:
+Per-project agent registry with optional preambles and permissions:
 
 ```json
 {
-  "claude": { "pane": "10.0", "remark": "Frontend specialist" },
-  "codex": { "pane": "10.1", "remark": "Backend engineer" }
+  "claude": {
+    "pane": "10.0",
+    "remark": "Frontend specialist",
+    "preamble": "Focus on UI components. Ask for review before merging.",
+    "deny": ["pm:task:update(status)"]
+  },
+  "codex": {
+    "pane": "10.1",
+    "remark": "Code reviewer",
+    "preamble": "You are the code quality guard. Review changes thoroughly."
+  }
 }
 ```
 
+| Field | Description |
+|-------|-------------|
+| `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`)
 
+Global settings that apply to all projects:
+
 ```json
 {
   "mode": "polling",
   "preambleMode": "always",
   "defaults": {
-    "timeout": 60000,
-    "pollInterval": 1000
-  },
-  "agents": {
-    "gemini": {
-      "preamble": "Do not edit files until explicitly asked."
-    }
+    "timeout": 180,
+    "pollInterval": 1,
+    "captureLines": 100,
+    "hideOrphanTasks": false
   }
 }
 ```
 
+| Field | Description |
+|-------|-------------|
+| `mode` | Default mode: `polling` (manual check) or `wait` (auto-wait) |
+| `preambleMode` | `always` (inject preambles) or `disabled` |
+| `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.
+
 ---
 
 ## ✨ v2 Features
@@ -194,18 +220,48 @@ tmux-team talk codex "message" --wait --timeout 60
 
 ### 📜 Agent Preambles
 
-Inject hidden instructions into every message:
+Inject hidden instructions into every message via local `tmux-team.json`:
 
 ```json
 {
-  "agents": {
-    "gemini": {
-      "preamble": "Always explain your reasoning. Do not edit files directly."
-    }
+  "gemini": {
+    "pane": "10.2",
+    "preamble": "Always explain your reasoning. Do not edit files directly."
   }
 }
 ```
 
+Use the CLI to manage preambles:
+
+```bash
+tmux-team preamble show gemini      # View current preamble
+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
@@ -238,6 +294,156 @@ It's the plumbing layer that lets humans and AI agents coordinate via tmux, noth
 
 *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 |
+|--------|-------------|
+| `--delay <seconds>` | Wait before sending (whitelist-friendly alternative to `sleep`) |
+| `--wait` | Block until agent responds (nonce-based completion detection) |
+| `--timeout <seconds>` | Max wait time (default: 180s) |
+| `--no-preamble` | Skip agent preamble for this message |
+
+### config Command
+
+```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 clear <key>           # Clear a config value
+tmux-team config --global set ...      # Modify global config
+```
+
+### preamble Command
+
+```bash
+tmux-team preamble show <agent>        # Show agent's preamble
+tmux-team preamble set <agent> "..."   # Set agent's preamble
+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 |
+
+---
+
 ## License
 
 MIT

package/package.json

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

package/src/commands/add.ts

@@ -3,9 +3,9 @@
 // ─────────────────────────────────────────────────────────────
 
 import fs from 'fs';
-import type { Context } from '../types.js';
+import type { Context, PaneEntry } from '../types.js';
 import { ExitCodes } from '../exits.js';
-import { saveLocalConfig } from '../config.js';
+import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
 
 export function cmdAdd(ctx: Context, name: string, pane: string, remark?: string): void {
   const { ui, config, paths, flags, exit } = ctx;
@@ -23,12 +23,16 @@ export function cmdAdd(ctx: Context, name: string, pane: string, remark?: string
     exit(ExitCodes.ERROR);
   }
 
-  config.paneRegistry[name] = { pane };
+  // Load existing config to preserve all fields (preamble, deny, etc.)
+  const localConfig = loadLocalConfigFile(paths);
+
+  const newEntry: PaneEntry = { pane };
   if (remark) {
-    config.paneRegistry[name].remark = remark;
+    newEntry.remark = remark;
   }
+  localConfig[name] = newEntry;
 
-  saveLocalConfig(paths, config.paneRegistry);
+  saveLocalConfigFile(paths, localConfig);
 
   if (flags.json) {
     ui.json({ added: name, pane, remark });

package/src/commands/config.ts

@@ -13,11 +13,17 @@ import {
   clearLocalSettings,
 } from '../config.js';
 
-type ConfigKey = 'mode' | 'preambleMode';
+type EnumConfigKey = 'mode' | 'preambleMode';
+type NumericConfigKey = 'preambleEvery';
+type BoolConfigKey = 'hideOrphanTasks';
+type ConfigKey = EnumConfigKey | NumericConfigKey | BoolConfigKey;
 
-const VALID_KEYS: ConfigKey[] = ['mode', 'preambleMode'];
+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_VALUES: Record<ConfigKey, string[]> = {
+const VALID_VALUES: Record<EnumConfigKey, string[]> = {
   mode: ['polling', 'wait'],
   preambleMode: ['always', 'disabled'],
 };
@@ -26,7 +32,19 @@ function isValidKey(key: string): key is ConfigKey {
   return VALID_KEYS.includes(key as ConfigKey);
 }
 
-function isValidValue(key: ConfigKey, value: string): boolean {
+function isEnumKey(key: ConfigKey): key is EnumConfigKey {
+  return ENUM_KEYS.includes(key as EnumConfigKey);
+}
+
+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);
 }
 
@@ -43,6 +61,8 @@ function showConfig(ctx: Context): void {
       resolved: {
         mode: ctx.config.mode,
         preambleMode: ctx.config.preambleMode,
+        preambleEvery: ctx.config.defaults.preambleEvery,
+        hideOrphanTasks: ctx.config.defaults.hideOrphanTasks,
         defaults: ctx.config.defaults,
       },
       sources: {
@@ -52,6 +72,14 @@ function showConfig(ctx: Context): void {
           : globalConfig.preambleMode
             ? 'global'
             : 'default',
+        preambleEvery:
+          localSettings?.preambleEvery !== undefined
+            ? 'local'
+            : globalConfig.defaults?.preambleEvery !== undefined
+              ? 'global'
+              : 'default',
+        hideOrphanTasks:
+          globalConfig.defaults?.hideOrphanTasks !== undefined ? 'global' : 'default',
       },
       paths: {
         global: ctx.paths.globalConfig,
@@ -68,6 +96,14 @@ function showConfig(ctx: Context): void {
     : globalConfig.preambleMode
       ? '(global)'
       : '(default)';
+  const preambleEverySource =
+    localSettings?.preambleEvery !== undefined
+      ? '(local)'
+      : globalConfig.defaults?.preambleEvery !== undefined
+        ? '(global)'
+        : '(default)';
+  const hideOrphanSource =
+    globalConfig.defaults?.hideOrphanTasks !== undefined ? '(global)' : '(default)';
 
   ctx.ui.info('Current configuration:\n');
   ctx.ui.table(
@@ -75,6 +111,8 @@ 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)'],
@@ -95,11 +133,50 @@ function setConfig(ctx: Context, key: string, value: string, global: boolean): v
     ctx.exit(ExitCodes.ERROR);
   }
 
-  if (!isValidValue(key, value)) {
-    ctx.ui.error(
-      `Invalid value for ${key}: ${value}. Valid values: ${VALID_VALUES[key].join(', ')}`
-    );
-    ctx.exit(ExitCodes.ERROR);
+  const validKey = key as ConfigKey;
+
+  // Validate enum keys
+  if (isEnumKey(validKey)) {
+    if (!isValidValue(validKey, value)) {
+      ctx.ui.error(
+        `Invalid value for ${key}: ${value}. Valid values: ${VALID_VALUES[validKey].join(', ')}`
+      );
+      ctx.exit(ExitCodes.ERROR);
+    }
+  }
+
+  // Validate numeric keys
+  if (isNumericKey(validKey)) {
+    const numValue = parseInt(value, 10);
+    if (isNaN(numValue) || numValue < 0) {
+      ctx.ui.error(`Invalid value for ${key}: ${value}. Must be a non-negative integer.`);
+      ctx.exit(ExitCodes.ERROR);
+    }
+  }
+
+  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) {
@@ -109,6 +186,18 @@ function setConfig(ctx: Context, key: string, value: string, global: boolean): v
       globalConfig.mode = value as 'polling' | 'wait';
     } else if (key === 'preambleMode') {
       globalConfig.preambleMode = value as 'always' | 'disabled';
+    } else if (key === 'preambleEvery') {
+      if (!globalConfig.defaults) {
+        globalConfig.defaults = {
+          timeout: 180,
+          pollInterval: 1,
+          captureLines: 100,
+          preambleEvery: parseInt(value, 10),
+          hideOrphanTasks: ctx.config.defaults.hideOrphanTasks,
+        };
+      } else {
+        globalConfig.defaults.preambleEvery = parseInt(value, 10);
+      }
     }
     saveGlobalConfig(ctx.paths, globalConfig);
     ctx.ui.success(`Set ${key}=${value} in global config`);
@@ -118,6 +207,8 @@ function setConfig(ctx: Context, key: string, value: string, global: boolean): v
       updateLocalSettings(ctx.paths, { mode: value as 'polling' | 'wait' });
     } else if (key === 'preambleMode') {
       updateLocalSettings(ctx.paths, { preambleMode: value as 'always' | 'disabled' });
+    } else if (key === 'preambleEvery') {
+      updateLocalSettings(ctx.paths, { preambleEvery: parseInt(value, 10) });
     }
     ctx.ui.success(`Set ${key}=${value} in local config (repo override)`);
   }
@@ -132,6 +223,10 @@ 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

@@ -78,6 +78,8 @@ ${colors.yellow('CONFIG')}
 ${colors.yellow('CHANGE MODE')}
   tmux-team config set mode wait            ${colors.dim('Enable wait mode (local)')}
   tmux-team config set mode polling         ${colors.dim('Enable polling mode (local)')}
-  tmux-team config set timeout 120          ${colors.dim('Set timeout to 120s')}
+  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)')}
 `);
 }

package/src/commands/preamble.ts

@@ -1,10 +1,10 @@
 // ─────────────────────────────────────────────────────────────
-// Preamble command - manage agent preambles
+// Preamble command - manage agent preambles (local config only)
 // ─────────────────────────────────────────────────────────────
 
 import type { Context } from '../types.js';
 import { ExitCodes } from '../context.js';
-import { loadGlobalConfig, saveGlobalConfig } from '../config.js';
+import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
 
 /**
  * Show preamble(s) for agent(s).
@@ -57,25 +57,27 @@ function showPreamble(ctx: Context, agentName?: string): void {
 }
 
 /**
- * Set preamble for an agent.
+ * Set preamble for an agent (in local config).
  */
 function setPreamble(ctx: Context, agentName: string, preamble: string): void {
-  const { ui, paths, flags } = ctx;
-
-  const globalConfig = loadGlobalConfig(paths);
+  const { ui, paths, flags, config } = ctx;
 
-  // Ensure agents object exists
-  if (!globalConfig.agents) {
-    globalConfig.agents = {};
+  // Check if agent exists in pane registry
+  if (!config.paneRegistry[agentName]) {
+    ui.error(`Agent '${agentName}' not found in local config`);
+    ui.error('Add the agent with: tmux-team add <agent> <pane>');
+    ctx.exit(ExitCodes.ERROR);
   }
 
-  // Ensure agent config exists
-  if (!globalConfig.agents[agentName]) {
-    globalConfig.agents[agentName] = {};
+  const localConfig = loadLocalConfigFile(paths);
+
+  // Update preamble in local config
+  const agentEntry = localConfig[agentName] as { pane: string; preamble?: string } | undefined;
+  if (agentEntry) {
+    agentEntry.preamble = preamble;
   }
 
-  globalConfig.agents[agentName].preamble = preamble;
-  saveGlobalConfig(paths, globalConfig);
+  saveLocalConfigFile(paths, localConfig);
 
   if (flags.json) {
     ui.json({ agent: agentName, preamble, status: 'set' });
@@ -85,22 +87,17 @@ function setPreamble(ctx: Context, agentName: string, preamble: string): void {
 }
 
 /**
- * Clear preamble for an agent.
+ * Clear preamble for an agent (in local config).
  */
 function clearPreamble(ctx: Context, agentName: string): void {
   const { ui, paths, flags } = ctx;
 
-  const globalConfig = loadGlobalConfig(paths);
-
-  if (globalConfig.agents?.[agentName]?.preamble) {
-    delete globalConfig.agents[agentName].preamble;
-
-    // Clean up empty agent config
-    if (Object.keys(globalConfig.agents[agentName]).length === 0) {
-      delete globalConfig.agents[agentName];
-    }
+  const localConfig = loadLocalConfigFile(paths);
+  const agentEntry = localConfig[agentName] as { pane?: string; preamble?: string } | undefined;
 
-    saveGlobalConfig(paths, globalConfig);
+  if (agentEntry?.preamble) {
+    delete agentEntry.preamble;
+    saveLocalConfigFile(paths, localConfig);
 
     if (flags.json) {
       ui.json({ agent: agentName, status: 'cleared' });

package/src/commands/remove.ts

@@ -4,7 +4,7 @@
 
 import type { Context } from '../types.js';
 import { ExitCodes } from '../exits.js';
-import { saveLocalConfig } from '../config.js';
+import { loadLocalConfigFile, saveLocalConfigFile } from '../config.js';
 
 export function cmdRemove(ctx: Context, name: string): void {
   const { ui, config, paths, flags, exit } = ctx;
@@ -14,8 +14,10 @@ export function cmdRemove(ctx: Context, name: string): void {
     exit(ExitCodes.PANE_NOT_FOUND);
   }
 
-  delete config.paneRegistry[name];
-  saveLocalConfig(paths, config.paneRegistry);
+  // Load existing config to preserve other agents' fields (preamble, deny, etc.)
+  const localConfig = loadLocalConfigFile(paths);
+  delete localConfig[name];
+  saveLocalConfigFile(paths, localConfig);
 
   if (flags.json) {
     ui.json({ removed: name });