-
securityF
license-
qualityFacilitates real-time tool discovery and documentation retrieval for command-line tools within a VSCode extension, using Express and SSE for secure and dynamic content streaming.
Last updated -
7
Automatic detection and execution of Bun scripts with real-time monitoring and log management
Auto-detects and executes Flutter commands with integrated monitoring and log management
Provides full support for Lerna monorepo projects with script detection and execution
Auto-detects and runs .NET commands with intelligent monitoring and log management
Auto-detects and executes Node.js commands with intelligent monitoring and real-time log analysis
Automatic detection and execution of npm scripts with real-time monitoring and log management
Auto-detects and executes PHP commands with integrated monitoring and log management
Automatic detection and execution of pnpm scripts with support for pnpm workspaces in monorepos
Auto-detects and executes Python commands with intelligent monitoring and log management
Auto-detects and executes Ruby commands with integrated monitoring and log management
Auto-detects and executes Rust commands with intelligent monitoring and log management
Automatic detection and execution of Yarn scripts with support for Yarn workspaces in monorepos
๐ Brummer
Your Terminal UI Development Buddy with intelligent monitoring
A TUI (Terminal User Interface) for managing npm/yarn/pnpm/bun scripts with integrated MCP server for external tool access. Brummer provides intelligent log management, real-time monitoring, and seamless integration with development tools.
๐ Documentation
๐ Full documentation available at:
Quick links:
Features
Multi-Package Manager Support: Automatically detects and uses npm, yarn, pnpm, or bun
Monorepo Support: Full support for pnpm workspaces, npm workspaces, yarn workspaces, Lerna, Nx, and Rush
Multi-Language Detection: Auto-detects commands for Node.js, Go, Rust, Java (Gradle/Maven), .NET, Python, Ruby, PHP, Flutter, and more
Interactive TUI: Navigate through scripts, monitor processes, and view logs in real-time
Smart Log Management:
Automatic error detection and prioritization
Log filtering and search capabilities
Build event and test result detection
MCP Server Integration: Allows external tools (VSCode, Claude Code, etc.) to:
Access log output and errors
Execute commands asynchronously
Monitor process status
Process Management: Start, stop, and monitor multiple processes simultaneously
VS Code Tasks: Detects and runs VS Code tasks from .vscode/tasks.json
Environment Variable Management (Planned):
Unified .env file management with multi-format support
TUI view for browsing and editing environment variables
Automatic injection for scripts and AI agents
Secret detection and masking for security
Installation
Quick Install (One-Liner)
curl -sSL https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.sh | bash
Or with wget:
wget -qO- https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.sh | bash
irm https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.ps1 | iex
Package Managers
# Run directly with npx (no installation)
npx @standardbeagle/brum
# Install globally
npm install -g @standardbeagle/brum
# Or with yarn
yarn global add @standardbeagle/brum
# Or with pnpm
pnpm add -g @standardbeagle/brum
go install github.com/standardbeagle/brummer/cmd/brum@latest
Install from Source
# Clone the repository
git clone https://github.com/standardbeagle/brummer
cd brummer
# Using Make (recommended)
make install-user # Install for current user (~/.local/bin)
# OR
make install # Install system-wide (requires sudo)
# Using the interactive installer
./install.sh
# Manual build
go build -o brum ./cmd/brum
mv brum ~/.local/bin/ # Add to PATH
Usage
Basic Usage
In a directory with a package.json file:
brum
Options
brum [flags]
Flags:
-d, --dir string Working directory containing package.json (default ".")
-p, --port int MCP server port (default 7777)
--no-mcp Disable MCP server
--settings Show current configuration settings with sources
-h, --help help for brum
TUI Navigation
Tab: Switch between views (Scripts, Processes, Logs, Errors, URLs, Settings)
โ/โ or j/k: Navigate items
Enter: Select/execute
n: Open run command dialog (from Scripts tab)
Esc or q: Go back
/: Search logs
p: Toggle high-priority logs
Process Management
Navigate: Use โ/โ arrows to select a process (shows status with colored indicators)
s: Stop selected process (only works on running processes ๐ข)
r: Restart selected process (stops then starts the same script)
Ctrl+R: Restart all running processes
Enter: View logs for selected process
Process Status Indicators:
๐ข Running - Process is active (can stop/restart)
๐ด Stopped - Process was manually stopped
โ Failed - Process exited with error
โ Success - Process completed successfully
โธ๏ธ Pending - Process is starting up
Automatic Cleanup:
All running processes are automatically stopped when Brummer exits
Use Ctrl+C or 'q' to quit with graceful cleanup
Process count shown in header: "Running Processes (2)"
Log Management
c: Copy most recent error to clipboard
f: View/manage filters
Other
?: Show help
Ctrl+C: Quit
Configuration
Brummer supports hierarchical configuration through .brum.toml files. Configuration is loaded in the following order (later values override earlier ones):
~/.brum.toml(global user settings)Project root and parent directories (walking up to root)
Current working directory
.brum.toml
Viewing Current Configuration
# Show current settings with source files
brum --settings
# Create a configuration file from current settings
brum --settings > .brum.example.toml
Configuration Options
Create a .brum.toml file in your project or home directory:
# Package manager preference
preferred_package_manager = "pnpm" # npm, yarn, pnpm, bun
# MCP Server settings
mcp_port = 7777
no_mcp = false
# Proxy settings
proxy_port = 19888
proxy_mode = "reverse" # "reverse" or "full"
proxy_url = "http://localhost:3000" # Optional: auto-proxy this URL
standard_proxy = false
no_proxy = false
Settings Tab
The Settings tab provides:
Package Manager Selection: Choose between npm, yarn, pnpm, or bun
MCP Server Installation: One-click installation for development tools:
Claude Desktop โ
Claude Code โ
Cursor โ
VSCode (with MCP extension) โ
Cline โ
Windsurf โ
Roo Code (experimental)
Augment (experimental)
Cody (experimental)
MCP Hub Mode ๐
Brummer Hub Mode enables MCP clients to discover and control multiple brummer instances through a single connection:
Quick Setup
Configure your MCP client once:
{ "servers": { "brummer-hub": { "command": "brum", "args": ["--mcp"] } } }Run brummer in each project:
cd ~/projects/frontend && brum cd ~/projects/backend && brumUse hub tools in your MCP client:
instances/list- See all running instancesinstances/connect- Connect to a specific instanceAll instance tools become available with prefixes
๐ Full Hub Mode Documentation
MCP Server Integration
The MCP server runs on port 7777 by default and implements the official MCP Streamable HTTP transport protocol:
Transport Protocol
Single Endpoint: http://localhost:7777/mcp
Connection Types:
Standard JSON-RPC (POST with
Accept: application/json)Server-Sent Events (GET with
Accept: text/event-stream)SSE Response (POST with
Accept: text/event-stream)
Example Connection
// SSE streaming connection
const eventSource = new EventSource('http://localhost:7777/mcp');
eventSource.onmessage = (event) => {
const msg = JSON.parse(event.data);
console.log('Received:', msg);
};
// Send JSON-RPC requests
fetch('http://localhost:7777/mcp', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Accept': 'application/json'
},
body: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/list'
})
});
Available Tools
Script Management: scripts_list, scripts_run, scripts_stop, scripts_status
Log Management: logs_stream, logs_search
Browser Tools: browser_open, browser_screenshot, browser_navigate, repl_execute
Proxy Tools: proxy_requests
Telemetry: telemetry_sessions, telemetry_events
Examples
Run in a specific directory
brum -d ~/projects/my-app
Run with custom MCP port
brum -p 8888
Run without MCP server (TUI only)
brum --no-mcp
Run in headless mode (MCP server only)
brum --no-tui
Development
Project Structure
brummer/
โโโ cmd/brum/ # Main application entry point
โโโ internal/
โ โโโ tui/ # Terminal UI components
โ โโโ process/ # Process management
โ โโโ mcp/ # MCP server implementation
โ โโโ logs/ # Log storage and detection
โ โโโ parser/ # Package.json parsing
โโโ pkg/
โ โโโ events/ # Event system
โ โโโ filters/ # Log filtering
โโโ go.mod
Building
go build -o brum ./cmd/brum
Testing
go test ./...
License
MIT
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Allows external tools (VSCode, Claude Code, etc.) to access log output and errors, execute commands asynchronously, and monitor process status.
Related MCP Servers
- AsecurityAlicenseAqualityShell and file edit capabilities tightly coupled to provide a powerful coding experience. You can work with different modes: architect and code-writer for separate plan and implementation phase. You can get it to invoke any cli command, e.g., compiling, type checking, linting, github cli, pythonLast updated -6602Apache 2.0
- -securityAlicense-qualityProvides Claude with real-time system monitoring capabilities, including CPU, memory, disk, network, battery, and internet speed metrics.Last updated -1MIT License
- -securityAlicense-qualityTransform your local machine into a powerful code command center. Automate file handling, run terminal commands, and leverage AI to enhance your development workflowsโall securely and instantly, without cloud latency.Last updated -13MIT License