Agent setup

Connect an agent

The easiest setup is Nib → Set up agents…. Select Claude Code, Codex, or Claude Desktop and click Apply. Nib preserves the rest of each config and creates a .bak backup before changing an existing file.

The installed MCP command is:

command: /Applications/Nib.app/Contents/MacOS/Nib
args:
  - /Applications/Nib.app/Contents/Resources/mcp-shim/shim.js
  - --agent
  - <agent-name>
env:
  ELECTRON_RUN_AS_NODE: "1"

Use claudeCodeCLI, codexCLI, or claudeDesktop for <agent-name>. The shim launches Nib automatically when the app is closed and then connects over its local Unix socket.

Config blocks

{
  "mcpServers": {
    "nib": {
      "command": "/Applications/Nib.app/Contents/MacOS/Nib",
      "args": [
        "/Applications/Nib.app/Contents/Resources/mcp-shim/shim.js",
        "--agent",
        "claudeCodeCLI"
      ],
      "env": { "ELECTRON_RUN_AS_NODE": "1" },
      "type": "stdio"
    }
  }
}

[mcp_servers.nib]
command = "/Applications/Nib.app/Contents/MacOS/Nib"
args = ["/Applications/Nib.app/Contents/Resources/mcp-shim/shim.js", "--agent", "codexCLI"]
startup_timeout_sec = 120
tool_timeout_sec = 300

[mcp_servers.nib.env]
ELECTRON_RUN_AS_NODE = "1"

{
  "mcpServers": {
    "nib": {
      "command": "/Applications/Nib.app/Contents/MacOS/Nib",
      "args": [
        "/Applications/Nib.app/Contents/Resources/mcp-shim/shim.js",
        "--agent",
        "claudeDesktop"
      ],
      "env": { "ELECTRON_RUN_AS_NODE": "1" },
      "type": "stdio"
    }
  }
}

Per-agent values

Agent	`--agent` value
Claude Code	`claudeCodeCLI`
Codex	`codexCLI`
Claude Desktop	`claudeDesktop`

Paths must use /Applications/Nib.app — never node_modules.

After changing config

Restart the agent. If tools are missing, rerun Nib → Set up agents….