Calmo Local Bridge

Calmo Local Bridge is a desktop application that creates a secure connection between your local machine and the Calmo AI platform. It enables AI agents to execute commands, access local files, and leverage MCP (Model Context Protocol) servers—all while keeping you in control.

Overview

The Local Bridge transforms how you interact with Calmo by providing:

Secure Local Command Execution - Run kubectl, git, npm, and other CLI tools directly from Calmo
Human-in-the-Loop Approval - Review and approve commands before they execute on your machine
Local Workspace Access - Give Calmo context about your local projects and repositories
MCP Server Integration - Extend Calmo’s capabilities with external MCP servers
Real-Time Activity Logs - Monitor all bridge activity and command execution

Calmo Local Bridge main interface showing connected state

Key Features

Command Approval

Review every command before it runs. Deny risky operations or auto-approve trusted patterns like kubectl logs

Local Workspaces

Add your Git repositories, Terraform projects, and CI/CD setups as workspace context for the AI

MCP Servers

Connect external MCP servers for documentation lookup, sequential thinking, and more

Activity Logs

View detailed logs of all bridge activity, command execution, and MCP server connections

System Requirements

Platform	Supported
macOS	✅ macOS 11+ (Intel & Apple Silicon)
Windows	✅ Windows 10/11
Linux	🔜Ubuntu & CentOS

Browser Compatibility:

Chrome, Firefox, Edge (recommended)
Safari and Brave have limited support

Installation

Download Calmo Bridge

Download the latest version from app.getcalmo.com/integrations/bridge or from the Local Bridge Devices selector in any chat.

Install the Application

macOS:

Open the downloaded .dmg file
Drag Calmo Bridge to your Applications folder
Launch from Applications or Spotlight

Windows:

Run the downloaded installer
Follow the installation wizard
Launch from Start Menu

Launch and Pair

When first launched, the bridge shows a “DISCONNECTED” status. You’ll need to pair it with your Calmo account.

Calmo Local Bridge in disconnected state

Pairing Your Device

Pairing securely connects your local machine to your Calmo account using a 6-digit code.

Generate Pairing Code

In your Calmo chat, click the device selector (showing Local Bridge Devices) and click Generate Pairing Code. A 6-digit code will appear.

Calmo web interface showing pairing code generation

Enter Code in Bridge App

In the Calmo Bridge app, enter the 6-digit code shown on the web interface.

Confirm Connection

Once paired:

The bridge displays a green CONNECTED status with your device code
The web interface shows your device under Connected Devices
You can now use local bridge capabilities in your Calmo chats

The pairing code expires after 10 minutes. If it expires, generate a new code from the web interface.

Using the Bridge

Once connected, Calmo can execute commands on your local machine. Every command goes through an approval flow:

Command Approval Flow

When Calmo requests to run a command, you’ll see it in the Pending Commands section with three options:

Action	Description
Deny	Reject the command. Calmo will be notified it was denied.
Always Allow	Approve and add the command pattern to auto-approve list. Future matching commands run automatically.
Allow once	Approve just this execution. Same command will require approval again next time.

Commands are color-coded by risk level:

🟢 LOW - Safe read operations (e.g., kubectl get pods)
🟡 MEDIUM - Write operations that modify state (e.g., kubectl delete pod)
🔴 HIGH - Potentially dangerous operations

Command History

The Bridge tab shows your command history with execution status:

Status	Meaning
✅ APPROVED	Manually approved by you
✅ AUTO-APPROVED	Matched an always-allow pattern
❌ DENIED	Rejected by you

Managing Auto-Approved Commands

Click the settings icon next to Pending Commands to view and manage your always-allowed command patterns:

Patterns like kubectl logs and kubectl get will auto-approve any command starting with that prefix.

Application Tabs

The bridge has four main tabs:

Bridge Tab

The main interface showing:

Connection status and device code
Command history
Pending commands awaiting approval

Workspaces Tab

Configure local directories that Calmo can access:

Add paths to your:

Git repositories
Terraform projects
CI/CD configurations
Any directory you want Calmo to have context about

MCP Tools Tab

View and manage connected MCP servers:

MCP Servers panel showing connected servers

See all connected servers and their available tools. Click Edit MCP Config to modify the configuration.

Logs Tab

Detailed activity log for debugging and monitoring:

Activity log showing detailed bridge events

The log shows:

Connection events
Command execution details
MCP server status
Error messages and warnings

Security

Calmo Local Bridge is designed with security as a priority:

Human-in-the-Loop - You approve every command before execution (unless auto-approved)
Local Execution Only - Commands run on your machine with your user permissions
No Internet Exposure - Bridge doesn’t expose your system to the internet
Secure Pairing - 6-digit codes ensure only authorized sessions connect
Audit Trail - Complete history of all command executions

Always review commands before approving, especially those marked as MEDIUM or HIGH risk. Be cautious with commands that modify or delete resources.

When you close the bridge window, it continues running in the background:

macOS: Look for the bridge icon in the menu bar
Windows: Check the system tray

Click the icon to reopen the main window. The bridge maintains its connection while minimized.

“Close window to minimize to menu bar. Bridge keeps running.” - You can safely close the window without disconnecting.

Next Steps

CLI Tools Reference

Learn about the command execution capabilities and supported tools

MCP Configuration

Configure MCP servers to extend Calmo’s capabilities

Best Practices

Security recommendations and workflow tips

Troubleshooting

Common issues and solutions

For assistance with Local Bridge, contact our support team at [email protected].

Get Started

Local Bridge

Integrations