PromptBusPromptBus

Installation

Prerequisites

  • Node.js 18 or later
  • Claude Code installed and configured
  • An Anthropic API key or subscription

Install

Install PromptBus globally via npm:

Terminal
npm install -g @promptbus/promptbus

Verify the installation:

Terminal
promptbus --version

Configure Claude Code

Run the install command to configure Claude Code to route through PromptBus:

Terminal
promptbus install

This adds ANTHROPIC_BASE_URL=http://127.0.0.1:4701 to your ~/.claude/settings.json. The command shows a diff and asks for confirmation.

Tip: Use the --project flag to configure a specific project's settings instead of the global one:

bash
promptbus install --project /path/to/project

Start PromptBus

Start the proxy and dashboard as a background daemon:

Terminal
promptbus start

You can check the status at any time:

Terminal
promptbus status

Expected output:

Output
PromptBus is running
  Proxy:     http://127.0.0.1:4701
  Dashboard: http://127.0.0.1:4702
  Claude Code is configured to use PromptBus

Uninstall

To stop the daemon and revert the Claude Code configuration:

Terminal
promptbus stop
promptbus uninstall