Getting Started

Get up and running with BridgeMind in under five minutes. Create your account, connect your first agent, and ship something.

You don't need to be an expert to get started — if you can install an app and paste a config snippet, you're good.

This guide walks you through setting up BridgeMind from scratch. By the end, you'll have an AI coding agent connected to the BridgeMind platform, ready to manage projects and ship code through natural language.

BridgeCode is still pre-launch, so this guide focuses on the BridgeMind workflow you can use today with currently available agents like Cursor, Claude Code, Windsurf, and Codex CLI.

Prerequisites

• A BridgeMind account — sign up at bridgemind.ai
• An AI coding agent — Cursor, Claude Code, Windsurf, Codex CLI, or BridgeCode when it ships
• Node.js 18+ (for running the MCP server locally today; BridgeCode is planned to include this flow once it ships)

Step 1: Create Your Account

Head to bridgemind.ai and sign in with Google OAuth. Once you're in, you'll land on the BridgeMind dashboard where you can manage projects, tasks, and API keys.

Step 2: Generate an API Key

From the dashboard:

1. Navigate to Settings → API Keys
2. Click Generate New Key
3. Give your key a descriptive name (e.g., "Cursor MCP" or "Claude Code")
4. Copy the key — you'll need it in the next step

Your API key is scoped to your account. Any agent using this key can access your projects and tasks.

Step 3: Connect BridgeMCP

BridgeMCP is the bridge between your AI agent and the BridgeMind platform. Once connected, your agent can read your projects, pick up tasks, and report progress — all without you switching windows.

Follow the BridgeMCP Installation guide to connect your agent (Cursor, Claude Code, Windsurf, or Codex CLI today, and BridgeCode once it ships). It takes about a minute.

Step 4: Create Your First Project

With BridgeMCP connected, your agent now has access to BridgeMind tools. Projects are how you organize work — think of them as folders that hold tasks for your agent. Ask your agent to create one:

"Create a new BridgeMind project called 'My First App' with a description of 'A starter project to learn vibe coding.'"

Your agent will use the create_project tool to set this up. You'll see the project appear in your BridgeMind dashboard.

Step 5: Create a Task

Tasks are instructions for your agent — describe what you want built, and the agent handles execution. Create your first one:

"Create a task in the 'My First App' project: Build a simple REST API with Express that has a health check endpoint and a users CRUD endpoint. Use TypeScript."

The agent will create the task with your instructions. For more complex work, you can attach "knowledge" — extra context like architecture decisions, tech stack preferences, or reference material that helps the agent ship the right thing:

"Add this knowledge to the task: We're using PostgreSQL for the database, Drizzle ORM for queries, and Zod for input validation. The project should follow a clean architecture pattern."

Step 6: Ship It

This is the fun part — tell your agent to pick up the task and start building:

"Pick up the first task in 'My First App' and start working on it."

The agent will:

1. Read the task instructions and knowledge
2. Update the task status to in-progress
3. Start writing code, creating files, and running commands
4. Mark the task in-review when it's done

Review the work, request changes if needed, and mark the task complete when you're happy.

What's Next

You're shipping. Here's where to go from here:

• BridgeMCP — Explore all available tools and advanced task workflows.
• BridgeCode — Preview the upcoming AI coding agent for terminal-first vibe coding.
• BridgeSpace — One native app for terminals, code editing, and agent-driven task management.
• BridgeVoice — Add voice dictation to your workflow.