codmir Extension

Connect your VS Code or Windsurf IDE to Codmir AI for intelligent code assistance.

Features

• Connect to Codmir Chat - Pair your IDE with the Codmir web/mobile app
• AI-Powered Tools - Let AI read files, apply patches, run commands
• Secure by Default - All operations require confirmation by default
• Real-time Sync - Changes appear in both IDE and chat interface

Installation

From Open VSX (works today)

1. Open https://open-vsx.org/extension/codmir/codmir-ide
2. Click Download to get the .vsix
3. Install it in your IDE:
   • VS Code: Command Palette → Extensions: Install from VSIX...
   • CLI: code --install-extension /path/to/codmir-ide-<version>.vsix --force

From VS Code Marketplace

code --install-extension codmir.codmir-ide

If this command cannot find the extension, use the Open VSX .vsix install method above.

From Source

cd apps/vscode-extension
pnpm install
pnpm run build
pnpm run package
# Then install the generated .vsix in VS Code/Windsurf

Quick Start

1. Sign In (optional but recommended)

   • Open Command Palette (Ctrl+Shift+P)
   • Run "Codmir: Sign In"

2. Connect to Codmir Chat

   • Go to codmir.com and open a chat
   • Click "Connect IDE" button
   • Copy the pairing code (e.g., F7KQ-2M9P)

3. Pair Your IDE

   • Open Command Palette (Ctrl+Shift+P)
   • Run "Codmir: Enter Pairing Code"
   • Enter the code from step 2

4. Start Coding!

   • Your IDE is now connected
   • AI can read/write files, run commands, etc.
   • Look for the Codmir status in the bottom status bar

Commands

Settings

Default Allowed Commands

• npm test, pnpm test, yarn test
• npm run lint, pnpm lint, yarn lint
• pnpm typecheck
• git status, git diff, git log

Security

The extension enforces security boundaries:

• Workspace Only - AI can only access files in your workspace
• Command Allowlist - Only whitelisted commands run without confirmation
• Blocked Commands - Dangerous commands like rm -rf are always blocked
• Write Confirmation - File writes require your approval by default

Blocked Commands (cannot be overridden)

• rm -rf
• curl | bash, wget | bash
• sudo rm
• format c:

Status Bar

The extension shows status in the bottom status bar:

• 🔴 Disconnected - Click to connect
• 🔄 Connecting - Establishing connection
• 📡 Pairing - Waiting for pairing code
• ✅ Paired - Connected and ready

Troubleshooting

"Connection failed"

1. Check your internet connection
2. Ensure codmir.serverUrl is correct
3. Try signing out and back in

"Pairing code invalid"

1. Codes expire after 2 minutes - generate a new one
2. Codes are case-insensitive
3. Dashes are optional (F7KQ2M9P = F7KQ-2M9P)

"Permission denied"

1. The file may be outside your workspace
2. The command may be blocked
3. Check settings for allowed commands

"Tool execution timeout"

1. Some operations take time (tests, builds)
2. Default timeout is 60 seconds
3. Long-running commands may need different approach

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Watch mode
pnpm run dev

# Package for distribution
pnpm run package

# Install locally by environment
pnpm run install:local:testing
pnpm run install:local:staging
pnpm run install:local:production
# Uses .env.testing / .env.staging / .env.production (+ optional .env)

# Publish (auto-detects tokens from env vars or local .env files)
pnpm run publish

Publish Tokens

pnpm run publish resolves tokens in this order:

1. Environment variables (CI): VSCE_PAT, OVSX_TOKEN
2. apps/vscode-extension/.env
3. repo .env
4. apps/web/.env

Use pnpm run publish:vsce or pnpm run publish:ovsx to force a single target.

License

MIT - See LICENSE file