vibeopshub-agent

Self-hosted agent for VibeOpsHub. Connects outbound to the relay server via WebSocket, enabling remote tool execution from the VibeOpsHub macOS/iOS app.

Install

npm install -g vibeopshub-agent

Usage

vibeopshub-agent --token <setup-token> --allow "pm2 *,git *,ls,cat,node *"

Options

| Flag | Required | Description | |------|----------|-------------| | --token | Yes | Setup token from your VibeOpsHub account | | --relay | No | Relay WebSocket URL (default: wss://relay.vibeopshub.com) | | --name | No | Agent display name (default: hostname) | | --allow | No | Comma-separated allowed command prefixes |

Allow List

The --allow flag controls which terminal commands the agent can execute. Without it, all commands are denied.

# Allow specific commands
--allow "pm2 *,git *,ls,cat,node *,npm *"

# Allow everything (not recommended for production)
--allow "*"

Run with PM2

pm2 start vibeopshub-agent -- --token YOUR_TOKEN --allow "pm2 *,git *,ls"

Supported Tools

• run_terminal — Execute shell commands (filtered by allow list)
• read_file — Read file contents
• write_file — Write file contents
• list_directory — List directory contents
• run_git — Execute git commands

Requirements

• Node.js >= 18