Bugzapper Worker

Bugzapper Worker is a local component that enables Bugzapper AI agents to access your local resources, such as files on your local host.

Installation

System Requirements

• Node.js version 20 or higher

Quick Start

Run instantly in your working directory without installation:

npx @bugzapper/worker

Global Installation

Install globally using npm:

npm install -g @bugzapper/worker

Once installed, navigate to the directory you want to grant Bugzapper agents access to and run:

bugzapper-worker

Architecture

MCP Servers

By default, Bugzapper Worker already provides basic tools for working with your local files. You can also extend the toolset by using external MCP servers.

To use external MCP servers, add their definitions into the ~/.bugzapper/settings.json file:

{
    "mcpServers": {
        "serverName": {
            "command": "path/to/server",
            "args": ["--arg1", "value1"],
            "env": {
                "API_KEY": "$MY_API_TOKEN"
            },
            "cwd": "./server-directory",
            "timeout": 30000,
            "trust": false
        }
    }
}

The configuration requires one of the following properties:

• command (string): Path to the executable for Stdio transport
• url (string): SSE endpoint URL (e.g., "http://localhost:8080/sse")
• httpUrl (string): HTTP streaming endpoint URL

Sandboxing

You can execute Bugzapper Worker within a isolated environment to prevent potentially unsafe operations by using the --sandbox or -s flag:

bugzapper-worker --sandbox <sandbox-method>

Supported sandboxing methods: sandbox-exec (MacOS only), docker, podman.

The sandbox-exec method uses the lightweight MacOS Seatbelt with default profile permissive-open: restricts writes outside working directory but allows most other operations.

Your host needs to have Docker/Podman installed if you want to use to docker or podman sandboxing method. By default, Bugzapper Worker will use the pre-built bugzapper-worker/sandbox image. It will pull that image to your host on first use.