Open-source AI agent platform for agentic coding — MCP server, knowledge packs, and AI workflow automation.
sidebutton.com ·
Run AI coding agents with agentic workflows, knowledge packs, and real browser control. Connect Claude Code, Codex, Cursor, ChatGPT, or any MCP client.
Open-source MCP server with browser automation and knowledge packs for AI agents
npx sidebutton@latest
# Dashboard at http://localhost:9876
What you get
MCP Server
AI agent tools for browser control, workflow execution, and knowledge pack access. Stdio and SSE transports.
REST API
Trigger workflows remotely from webhooks, cron jobs, mobile apps, or other agents.
Workflow Engine
AI workflow automation with browser, git, issue-tracking, LLM, shell, and control-flow steps. Define agentic workflows in YAML.
Knowledge Packs
Installable domain knowledge — CSS selectors, data models, state machines. Role playbooks turn coding agents into an AI software engineer, QA, or PM.
Chrome Extension
Browser commands with real DOM access via WebSocket, not screenshots. Recording mode.
Dashboard
Svelte UI — workflow browser, run logs, skill pack manager, system status.
Quick Start
# Install and start
npx sidebutton@latest
# Or from source
pnpm install && pnpm build && pnpm start
# Open http://localhost:9876
CLI
pnpm cli serve # Start server with dashboard
pnpm cli serve --stdio # Start with stdio transport (for Claude Desktop)
pnpm cli list # List available workflows
pnpm cli status # Check server status
# Skill pack management
pnpm cli registry add <path|url> # Install skill packs from a registry
pnpm cli registry update [name] # Update installed packs
pnpm cli registry remove <name> # Uninstall packs and remove registry
pnpm cli search [query] # Search available skill packs
# Creating skill packs
pnpm cli init [domain] # Scaffold a new skill pack
pnpm cli validate [path] # Validate pack structure
pnpm cli publish [source] # Publish to a registry
MCP Server
SideButton is an open-source MCP server for AI coding agents. Agents connect to it directly for browser control, workflow automation, and domain knowledge.
Works with Claude Code, Codex, Cursor, Claude Desktop, VS Code, Windsurf, ChatGPT — any MCP client.
Claude Code
claude mcp add sidebutton --transport http http://localhost:9876/mcp
Publish evidence (screenshots, reports) from a session
get_browser_status
Check browser extension connection
capture_page
Capture selectors from current page
navigate
Navigate browser to URL
snapshot
Get page accessibility snapshot
click
Click an element
type
Type text into an element
press_key
Send keyboard keys
scroll
Scroll the page
extract
Extract text from element
screenshot
Capture page screenshot (pass path to write a PNG file instead of returning image bytes)
select_option
Select dropdown option
fill
Fill input value (React-compatible)
wait
Wait for element or delay
exists
Check if element exists
extract_all
Extract all matching elements
extract_map
Extract structured data from repeated elements
scroll_into_view
Scroll element into viewport
hover
Hover over element
inject_css
Inject CSS into the page (blur/hide elements before a screenshot)
evaluate
Execute JavaScript in browser
browser_batch
Run a sequence of browser actions in one call
set_basic_auth
Set HTTP Basic Auth credentials for the connected tab
clear_basic_auth
Clear stored HTTP Basic Auth credentials
REST API
JSON endpoints for external integrations. The same workflows are available via MCP locally and via REST remotely.
# Run a workflow
curl -X POST http://localhost:9876/api/workflows/check_ticket/run \
-H "Content-Type: application/json" \
-d '{"params": {"ticket_id": "PROJ-123"}}'
# List workflows
curl http://localhost:9876/api/workflows
# Get run log
curl http://localhost:9876/api/runs/latest
Trigger workflows from webhooks, cron jobs, mobile apps, or other agents on different machines.
Workflow Engine
YAML-first orchestration for agentic workflows. Step types by family:
Installable domain knowledge (skill packs) per web app or domain. Knowledge packs power AI code review, automated testing, and enterprise AI agent deployments.
Also referred to as skill packs in code and CLI commands.
Selectors — CSS selectors for UI elements
Data models — entity types, fields, relationships, valid states
State machines — valid transitions per state
Role playbooks — role-specific procedures (QA, SE, PM, SD)
Common tasks — step-by-step procedures, gotchas, edge cases
pnpm install # Install dependencies
pnpm build # Build all packages
pnpm start # Start server
pnpm cli list # List workflows
pnpm cli status # Check status
Watch Mode
pnpm dev # Full dev mode (all packages)
pnpm dev:server # Server with auto-restart on :9876
pnpm dev:dashboard # Dashboard watch build
pnpm dev:core # Core library watch build
Platform Automation Disclaimer
SideButton is a general-purpose browser automation framework. When automating third-party platforms:
Review Terms of Service: Many platforms prohibit or restrict automation. You are responsible for complying with the terms of any platform you automate.
Account Risk: Automation may result in account restrictions or suspension on some platforms.
Use Responsibly: Only automate actions you would perform manually. Respect rate limits and platform guidelines.
The authors do not endorse or encourage violations of third-party terms of service.
License
This project uses mixed licensing — see LICENSING.md:
Engine, server, CLI, dashboard — Apache-2.0
Browser extension — FSL-1.1-Apache-2.0 (converts to Apache-2.0 on 2029-03-15)