package.json

{
  "name": "herdex",
  "displayName": "Herdex",
  "description": "Native VS Code client for Herdr — manage AI coding agents, workspaces, and their live state without leaving the editor.",
  "version": "0.1.0",
  "publisher": "mkellerman",
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "https://github.com/mkellerman/herdex"
  },
  "bugs": {
    "url": "https://github.com/mkellerman/herdex/issues"
  },
  "homepage": "https://github.com/mkellerman/herdex#readme",
  "engines": {
    "vscode": "^1.85.0"
  },
  "categories": [
    "Other",
    "SCM Providers"
  ],
  "keywords": [
    "herdr",
    "ai agents",
    "coding agent",
    "claude",
    "codex",
    "terminal",
    "tmux",
    "worktree"
  ],
  "galleryBanner": {
    "color": "#1e1e1e",
    "theme": "dark"
  },
  "activationEvents": [
    "onStartupFinished"
  ],
  "main": "./dist/extension.js",
  "contributes": {
    "viewsContainers": {
      "activitybar": [
        {
          "id": "herdex",
          "title": "Herdex",
          "icon": "media/herd-icon.svg"
        }
      ]
    },
    "views": {
      "herdex": [
        {
          "id": "herdex.workspaces",
          "name": "Workspaces",
          "icon": "media/herd-icon.svg"
        },
        {
          "id": "herdex.agents",
          "name": "Agents",
          "icon": "media/herd-icon.svg"
        }
      ]
    },
    "viewsWelcome": [
      {
        "view": "herdex.workspaces",
        "when": "!herdex.connected",
        "contents": "Not connected to a Herdr server.\n\nMake sure Herdr is running (`herdr status`), then reconnect.\n[Reconnect](command:herdex.reconnect)"
      },
      {
        "view": "herdex.workspaces",
        "when": "herdex.connected",
        "contents": "No workspaces yet.\n[Add Workspace from Folder…](command:herdex.addWorkspace)"
      },
      {
        "view": "herdex.agents",
        "when": "!herdex.connected",
        "contents": "Not connected to a Herdr server.\n[Reconnect](command:herdex.reconnect)"
      },
      {
        "view": "herdex.agents",
        "when": "herdex.connected",
        "contents": "No agents in this workspace.\n[Start Agent](command:herdex.startAgent)\n[Show all workspaces](command:herdex.agentsScopeAll)"
      }
    ],
    "commands": [
      {
        "command": "herdex.reconnect",
        "title": "Herdex: Reconnect to Herdr server",
        "icon": "$(refresh)"
      },
      {
        "command": "herdex.refresh",
        "title": "Herdex: Refresh",
        "icon": "$(refresh)"
      },
      {
        "command": "herdex.addWorkspace",
        "title": "Herdex: Add Workspace from Folder…",
        "icon": "$(add)"
      },
      {
        "command": "herdex.startAgent",
        "title": "Herdex: Start Agent…",
        "icon": "$(person-add)"
      },
      {
        "command": "herdex.focusAgent",
        "title": "Herdex: Focus Agent",
        "icon": "$(eye)"
      },
      {
        "command": "herdex.openTerminal",
        "title": "Herdex: Open Pane Terminal",
        "icon": "$(terminal)"
      },
      {
        "command": "herdex.openTerminalAttachMirror",
        "title": "Herdex: Open Terminal (attach+mirror)",
        "icon": "$(split-horizontal)"
      },
      {
        "command": "herdex.selectTerminalMode",
        "title": "Herdex: Select Terminal Mode…",
        "icon": "$(settings-gear)"
      },
      {
        "command": "herdex.sendSelection",
        "title": "Herdex: Send Selection to Agent",
        "icon": "$(arrow-right)"
      },
      {
        "command": "herdex.promptAgent",
        "title": "Herdex: Prompt Agent…",
        "icon": "$(comment)"
      },
      {
        "command": "herdex.stopAgent",
        "title": "Herdex: Interrupt Agent (Ctrl-C)",
        "icon": "$(stop-circle)"
      },
      {
        "command": "herdex.focusWorkspace",
        "title": "Herdex: Focus Workspace"
      },
      {
        "command": "herdex.openWorkspace",
        "title": "Herdex: Open Workspace"
      },
      {
        "command": "herdex.openTab",
        "title": "Herdex: Open Tab"
      },
      {
        "command": "herdex.filterAgents",
        "title": "Herdex: Filter Agents…",
        "icon": "$(filter)"
      },
      {
        "command": "herdex.clearAgentFilter",
        "title": "Herdex: Clear Agent Filter",
        "icon": "$(clear-all)"
      },
      {
        "command": "herdex.agentsScopeAll",
        "title": "Herdex: Show Agents from All Workspaces"
      },
      {
        "command": "herdex.showLogs",
        "title": "Herdex: Show Logs",
        "icon": "$(output)"
      }
    ],
    "menus": {
      "view/title": [
        {
          "command": "herdex.addWorkspace",
          "when": "view == herdex.workspaces",
          "group": "navigation@1"
        },
        {
          "command": "herdex.startAgent",
          "when": "view == herdex.workspaces",
          "group": "navigation@2"
        },
        {
          "command": "herdex.filterAgents",
          "when": "view == herdex.agents",
          "group": "navigation@1"
        },
        {
          "command": "herdex.clearAgentFilter",
          "when": "view == herdex.agents && herdex.agentsFiltered",
          "group": "navigation@2"
        },
        {
          "command": "herdex.refresh",
          "when": "view == herdex.workspaces || view == herdex.agents",
          "group": "navigation@3"
        }
      ],
      "commandPalette": [
        { "command": "herdex.openWorkspace", "when": "false" },
        { "command": "herdex.openTab", "when": "false" },
        { "command": "herdex.focusWorkspace", "when": "false" }
      ],
      "view/item/context": [
        {
          "command": "herdex.startAgent",
          "when": "view == herdex.workspaces && viewItem == herdex.workspace",
          "group": "inline@1"
        },
        {
          "command": "herdex.startAgent",
          "when": "view == herdex.workspaces && viewItem == herdex.workspace",
          "group": "1_actions@1"
        },
        {
          "command": "herdex.focusWorkspace",
          "when": "view == herdex.workspaces && viewItem == herdex.workspace",
          "group": "1_nav@1"
        },
        {
          "command": "herdex.startAgent",
          "when": "view == herdex.workspaces && viewItem =~ /herdex.pane/",
          "group": "1_actions@1"
        },
        {
          "command": "herdex.openTerminal",
          "when": "viewItem =~ /herdex.pane/",
          "group": "1_actions@2"
        },
        {
          "command": "herdex.openTerminalAttachMirror",
          "when": "viewItem =~ /herdex.pane/",
          "group": "1_actions@3"
        },
        {
          "command": "herdex.promptAgent",
          "when": "viewItem =~ /herdex.agent/",
          "group": "1_actions@1"
        },
        {
          "command": "herdex.sendSelection",
          "when": "viewItem =~ /herdex.agent/",
          "group": "1_actions@2"
        },
        {
          "command": "herdex.openTerminal",
          "when": "viewItem =~ /herdex.agent/",
          "group": "1_actions@3"
        },
        {
          "command": "herdex.openTerminalAttachMirror",
          "when": "viewItem =~ /herdex.agent/",
          "group": "1_actions@4"
        },
        {
          "command": "herdex.selectTerminalMode",
          "when": "viewItem =~ /herdex.agent/ || viewItem =~ /herdex.pane/",
          "group": "1_actions@5"
        },
        {
          "command": "herdex.focusAgent",
          "when": "viewItem =~ /herdex.agent/",
          "group": "1_nav@1"
        },
        {
          "command": "herdex.stopAgent",
          "when": "viewItem =~ /herdex.agent/",
          "group": "2_danger@1"
        }
      ],
      "editor/context": [
        {
          "command": "herdex.sendSelection",
          "when": "editorHasSelection",
          "group": "herd@1"
        }
      ]
    },
    "configuration": {
      "title": "Herdex",
      "properties": {
        "herdex.socketPath": {
          "type": "string",
          "default": "",
          "description": "Path to the Herdr server socket. Leave empty to use $HERDR_SOCK or ~/.config/herdr/herdr.sock."
        },
        "herdex.terminalRefreshMs": {
          "type": "number",
          "default": 400,
          "description": "Poll interval (ms) for refreshing an attached pane terminal mirror. The Herdr API has no push event for terminal output, so mirrors poll pane.read."
        },
        "herdex.debug": {
          "type": "boolean",
          "default": false,
          "description": "Log view/model changes to the 'Herdex' output channel (for diagnosing refresh/flicker)."
        },
        "herdex.statusPollMs": {
          "type": "number",
          "default": 2000,
          "description": "Poll interval (ms) for refreshing agent status via session.snapshot. Continuous agent-status changes are not pushed globally by Herdr, so status is polled. Set to 0 to disable polling (topology still updates from events)."
        },
        "herdex.terminalMode": {
          "type": "string",
          "enum": ["control", "mirror", "observe", "attach", "attach+mirror"],
          "enumDescriptions": [
            "Recommended. Real terminal running 'herdr terminal session control --takeover'. Full width + reflow AND native text selection (raw stream, no mouse capture). Single terminal.",
            "Read-only poll of pane.read. Native text selection; width capped to Herdr's grid; non-intrusive.",
            "Live raw stream via 'herdr terminal session observe'. Native text selection, no polling; width capped to Herdr's grid.",
            "Real terminal running 'herdr agent attach'. Full width and reflow, but a mouse-capturing TUI (no native text selection).",
            "Opens an 'attach' terminal that drives the pane width (resize/maximize it) plus a 'mirror' terminal that shows the same content with native text selection."
          ],
          "default": "control",
          "description": "How the pane terminal is presented. 'control' is recommended (full width + selection in one terminal); others are kept for comparison."
        },
        "herdex.herdrPath": {
          "type": "string",
          "default": "herdr",
          "description": "Path to the herdr CLI (used by the 'observe' and 'attach' terminal modes). Leave as 'herdr' to resolve via PATH."
        }
      }
    }
  },
  "scripts": {
    "vscode:prepublish": "node esbuild.js --production",
    "bundle": "node esbuild.js --production",
    "build": "node esbuild.js",
    "watch": "node esbuild.js --watch",
    "typecheck": "tsc --noEmit",
    "lint": "eslint src",
    "format": "prettier --write \"src/**/*.ts\"",
    "format:check": "prettier --check \"src/**/*.ts\"",
    "test": "vitest run",
    "package": "node esbuild.js --production && npx --yes @vscode/vsce package --no-dependencies",
    "install:vsix": "code --install-extension \"$(ls -t herdex-*.vsix | head -1)\" --force"
  },
  "pnpm": {
    "onlyBuiltDependencies": ["esbuild"]
  },
  "devDependencies": {
    "@eslint/js": "^9.9.0",
    "@types/node": "^20.11.0",
    "@types/vscode": "^1.85.0",
    "@vscode/vsce": "^3.2.0",
    "esbuild": "^0.20.0",
    "eslint": "^9.9.0",
    "eslint-config-prettier": "^9.1.0",
    "prettier": "^3.3.0",
    "typescript": "^5.4.0",
    "typescript-eslint": "^8.0.0",
    "vitest": "^2.0.0"
  }
}