m8s VS Code Extension

Connect your IDE to the m8s platform for seamless task deployment and AI-assisted development.

Features

🔐 Secure Pairing - One-time pairing code connects your IDE to m8s
📁 Project Browser - Browse your company's projects and PRDs from the sidebar
🚀 Push Notifications - Receive tasks instantly when PM clicks "Deploy Code"
📦 Context Packaging - Auto-generates task files with PRD + Architecture
🤖 Tool Handoff - Send to Claude Code, Cursor, or clipboard

Getting Started

1. Generate a Pairing Code

Go to m8s Settings
Click "IDE Connection" tab
Click "Connect New IDE"
Copy the generated pairing code

2. Connect Your IDE

Open VS Code or Cursor
Click the m8s icon in the sidebar (or run m8s: Login from Command Palette)
Enter your email, password, and pairing code
Done! You're connected.

Usage

Browse Projects (Pull Flow)

Click the m8s icon in the sidebar
Expand a project to see its documents
Click a document to preview
Right-click and select "Start Implementation"

Receive Tasks (Push Flow)

When a PM clicks "Deploy Code" in m8s web app
You'll receive a notification in VS Code
Click "Start Implementation" to begin
Choose your preferred tool (Claude, Cursor, or Clipboard)

Configuration

Setting	Default	Description
`m8s.serverUrl`	`https://app.m8s.dev`	m8s server URL
`m8s.preferredTool`	`ask`	Default handoff tool (ask, claude, cursor, clipboard)
`m8s.taskFolder`	`.m8s`	Folder for task context files
`m8s.autoConnect`	`true`	Auto-connect WebSocket on startup
`m8s.showNotifications`	`true`	Show notifications for incoming tasks

Commands

Command	Description
`m8s: Login`	Connect to m8s with pairing code
`m8s: Logout`	Disconnect from m8s
`m8s: Refresh Projects`	Refresh the projects tree
`m8s: Open Document`	Preview a document
`m8s: Start Implementation`	Generate context and start coding
`m8s: Open Settings`	Open extension settings
`m8s: Reconnect`	Reconnect WebSocket

Task Context Files

When you start implementation, the extension creates a context file:

.m8s/
└── project-name/
    └── task-feature-name.md

This file contains:

Full PRD content
Architecture document (if available)
Developer instructions
Metadata (project, company, task ID)

Multi-Tenant Architecture

m8s supports multiple companies (tenants). Your extension:

Only sees projects from your company
Only receives deploy events for your company
Context files include company name for clarity

Requirements

VS Code 1.80+ or Cursor
m8s account with IDE Connection access
Internet connection

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Run tests
npm test

# Package extension
npm run package

M8S - AI Development Platform

Idan Ayalon