Skip to content

Repository files navigation

ToolBraid logo

ToolBraid Companion

Your AI's connection to the browser, Windows and the work between them.

Available on Microsoft Store Release 0.3.1 Apache License 2.0 Source and documentation checks

Website · Install · Full specs · Architecture · Build from source · What's new

Follow @ToolBraidComp on X Buy me a coffee — optional support

ToolBraid combines a WebMCP-enabled browser extension and a local Windows companion. Connect it to your existing Codex session or another MCP client, or use the optional ChatGPT side-panel chat. Your assistant can work with real pages, desktop controls, approved files and repeatable workflows.

This is the official source, releases and documentation repository for the public edition. The browser extension, Windows companion, tests and packaging scripts are available under Apache 2.0.

Updated 26 September 2026: 0.3.1 is out of release candidate, with a native WebMCP execution fix and clean-Windows installation, update and browser integration tests. What's new · Validation and limits.

Get started

Get it from Microsoft Store · Browser extension · Manual Windows ZIP · Source ZIP · Checksums

  1. Install the companion from Microsoft Store on Windows 11 x64, open it from Start and choose Connect browsers.
  2. Download and extract the separate browser extension. In Chrome or Edge, enable Developer mode → Load unpacked and select the extracted folder containing manifest.json.
  3. Enable your chosen site in ToolBraid, use Check connection in the companion and connect your AI.

Free · Store companion 0.3.3.0 · Manual companion and extension 0.3.1. The Store installs the Windows companion, not the browser extension. The 0.3.1 manual ZIP launcher is unsigned; release status does not confer a signing certificate. See installation, edition differences and Code signing policy.

What it can do

Area Capabilities
Browser & WebMCP Read pages, navigate tabs, fill forms, scroll, upload granted files and use native tools on compatible sites.
Windows & files Inspect desktop accessibility controls; read, create, move and archive within approved local folders.
Visual & media Screenshots, accessibility handles, configured visual analysis and local FFmpeg editing jobs.
Research & memory Multi-tab evidence, source-linked snapshots, citation bundles and bounded local records.
Workflows Checkpointed missions, reusable demonstrations, shadow replay and scheduled tool calls.
Community tools X mentions, replies, requested posts, media and article drafts, plus other site-aware adapters.

Full capabilities and requirements → · How the components connect →

Use the AI you already work with

  • Existing Codex session or another MCP client: keep chatting and choosing models in that client.
  • Optional panel chat: sign in to Codex with your ChatGPT account. Your Codex allowance applies; no API key for this route.
  • Local models: use a tool-capable model in an external MCP host. The panel is not a universal provider or local-model selector.

Ask an assistant with tools on your Windows PC to help set it up:

Install and configure ToolBraid Companion using https://toolbraid.pages.dev/agent-setup.txt. Check my existing installation, verify the official download's SHA-256, preserve other MCP settings, and finish with a read-only connection test.

Copy the complete setup prompt · Manual setup. Browser permissions and account sign-in may still need you.

ToolBraid — From intent to evidence. Cyan and pink strands connect across a dark background.

Real Windows demo

ToolBraid-real-Windows-demo-1080p.mp4

Real pages and model responses, an X reply draft, and browser navigation. 1:23 · No audio. Edited for pace; no live X post in the recording.

Website player and video description · 4K export

Token-efficient context

ToolBraid-Token-Efficient-Context-1080p.mp4

The same seven public X posts: 821 tokens with ToolBraid Companion versus 5,094 in a full browser DOM snapshot. 83.9% less returned context, preserving the messages, authors and links. A custom browser extraction returned 661 tokens; this is one measured sample, not a claim about total usage or every workflow. 15 seconds · 1080p · Sound effects, no voice.

Measurement and video description · Watch on the website

The interface

Optional agent chatCommunity & site tools
ToolBraid agent chat — offline UI preview; select to enlarge. ToolBraid community and WebMCP controls — offline UI preview; select to enlarge.

Documentation

Develop

Requires Node.js 24 LTS. The runtime and unit tests use Node built-ins; no dependency installation is needed for these commands.

git clone https://github.com/Maharajahu/ToolBraid-Companion.git
cd ToolBraid-Companion
npm run validate

Load dist/toolbraid-extension in Chrome or Edge. Windows packaging, optional browser integration tests and the source layout are covered in the development guide. See contributing for changes and regression tests.

Feedback and support

Report a bug or suggest a feature. Issues are public; use the Feedback form for non-public contact and security reports. Never include credentials or private page content. Source and documentation pull requests are welcome; CI checks the public identity, unit tests, extension build and documentation.

Built by Maharajahu. Apache 2.0; bundled Node.js licensing is included in the Windows package. Donations are optional and unlock no features.

About

WebMCP-enabled browser extension and Windows tools for your AI. Official ToolBraid Companion source, releases, tests and build instructions.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages