Knotflow Lens

VS Code extension for Knotflow MCP — manage documents, processes, and AI context directly from your IDE.

Features

• Documents & Processes: Browse, create, and inspect documents and process flows
• AI Context Portability: Backup and restore AI conversation context across IDEs
• Role-based Access: API key respects user org role (owner/admin/manager/member)
• Sidebar + Editor Panel: Works in narrow sidebar or full editor column

Setup

1. Install the extension
2. Run Knotflow: Configure API Key from the command palette
3. Enter your server URL and MCP API key (kf_...)

Generate an API Key

Step 1: Get your Knotflow Account

1. Go to https://knotflow.cloud
2. Sign up or log in to your account
3. Join or create an organization

Step 2: Generate MCP API Key

1. In Knotflow, go to Profile → MCP API Keys
2. Click "Generate New Key"
3. Give it a name (e.g., "Windsurf", "Cursor", "VS Code")
4. Copy the generated key (format: kf_...)
5. Important: Keep this key secure - it's like a password!

Step 3: Configure the Extension

1. Install the Knotflow Lens extension in your IDE
2. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
3. Run Knotflow: Configure API Key
4. Enter:
   • Server URL: https://api.knotflow.cloud
   • API Key: Your copied kf_... key
5. Restart your IDE '{"name": "My IDE Key"}'

## Usage in Your IDE

### In Windsurf/Cursor/VS Code

#### 1. Access Knotflow Lens
- Look for the **Knotflow icon** in the activity bar (sidebar)
- Or open Command Palette and search "Knotflow"

#### 2. Browse Your Content
- **Docs Tab**: View and create documents
- **Flows Tab**: Browse process workflows
- **Context Tab**: Manage AI context backups

#### 3. Work with AI Chat

**Backup Current Context:**
- When working on a project in Windsurf/Cursor
- Run `Knotflow: Backup AI Context` or click "Backup" in Context tab
- This saves:
  - Your AI conversations (user/assistant messages)
  - File index (paths, summaries, symbols)
  - Project metadata

**Switch IDEs without Losing Context:**
- Save context in Windsurf
- Open Cursor → Restore the same context
- Continue working seamlessly!

**Create Documentation from IDE:**
- Use `Knotflow: Open Canvas in Editor`
- Create structured docs without leaving your IDE
- Share with team members via public links

#### 4. Real Examples

**Document Your Code:**

You: "Create a document for my authentication system and save it on knotflow" AI: Uses Knotflow tools to create a structured process document

**Share Knowledge:**

You: "Backup my current context about the payment module knotflow" AI: Saves all conversations + file context Team member: "Restore payment module context" AI: Loads complete context in their IDE

**Generate Tutorials:**

You: "Create a tutorial for setting up the development environment" AI: Creates step-by-step process with checklists and videos

### Key Benefits

- **Zero Context Loss**: Switch between Windsurf, Cursor, VS Code seamlessly
- **Team Knowledge Sharing**: Backup your context, share with teammates
- **IDE-native Documentation**: Create docs without leaving your code editor
- **AI-powered**: Your AI assistant knows your entire organization's processes

## Commands

- `Knotflow: Configure API Key` — set server URL and API key
- `Knotflow: Backup AI Context` — save current project context
- `Knotflow: Restore AI Context` — restore a previous backup
- `Knotflow: Open Canvas in Editor` — open in full editor panel