SideButton: Open Source AI Agent Platform

What is SideButton: the open source AI agent platform

SideButton is an open-source AI agent platform and MCP server. It provides AI agent tools for the full lifecycle: browser control, workflow automation, knowledge packs, and plugins.

• MCP Server: 28 built-in AI agent tools for real-browser control, workflow execution, run logs, and artifacts. Your favorite AI coding agent (Claude Code, Cursor, Copilot, Windsurf) connects over stdio or HTTP + SSE, with MCP OAuth 2.1.
• Workflow Engine: define agentic workflows in YAML: 45 step types across browser actions, shell commands, LLM calls, and control flow, with nested workflows and retries.
• Knowledge Packs: domain knowledge that turns coding agents into an AI software engineer, QA engineer, or product manager. Workflows, selectors, data models, and 15 built-in roles per web app.
• REST API + Dashboard: 60+ endpoints to trigger any workflow from your own webhooks, cron jobs, or apps, plus a local dashboard with live run logs and a skill-pack manager.

Use SideButton for AI code review, automated testing, ticket triage, or any task that needs browser context. Tracker and chat steps work across Jira, Linear, GitHub, and Slack. The provider is auto-detected from your environment.

How agentic coding works with SideButton

1. Install SideButton
   $ npx sidebutton@latest
2. Connect Chrome extension from the Chrome Web Store.
3. Connect your AI agent (Claude Code, Cursor, Copilot, Windsurf, or any MCP client).
   $ claude mcp add sidebutton --transport http http://localhost:9876/mcp
4. Install a skill pack for any web app with sidebutton registry add, or create your own. Installed packs live in ~/.sidebutton/skills/. Learn how to create a skill pack.
5. Agent works on its own, running workflows, making LLM decisions where reasoning is needed, logging every step.

Everything runs and is configured locally: your browser, your sessions, your API keys.

Knowledge Packs

Knowledge packs (skill packs) are simple markdown files, easy to manage and extend. Create a new pack by asking Claude to capture knowledge from your current session, or scaffold one with sidebutton init and share it through a registry: a local folder or a git repo. Installed packs live in ~/.sidebutton/skills/ and load on startup. Workflows, roles, and domain targets merge with your local configuration. Knowledge packs power enterprise AI agents across teams and projects. Browse available skills or create a skill for agentic AI.

Plugins

Extend the MCP server with custom tools in any language. A plugin is a folder with a manifest and a handler script in ~/.sidebutton/plugins/, loaded on startup next to the built-in tools. SideButton ships with two: screen-record (capture agent sessions to MP4) and writing-quality (score content before it goes out). Read the plugin guide.

Feedback

Found a bug or have a feature request? Submit an issue on GitHub or use the Report Bug button at sidebutton.com.

What's next

The platform is stable and production-ready. What we're building next:

• Native apps: SideButton for iOS and Android, coming to the App Store and Google Play
• Knowledge-pack marketplace: a public registry to discover and share skill packs across teams