Quick Start

This guide assumes you've already installed the desktop app and it's running.

Connect Your IDE

Add to ~/.codeium/windsurf/mcp_config.json:

mcp_config.json

{
  "mcpServers": {
    "agents-machine": {
      "serverUrl": "http://localhost:3000/mcp"
    }
  }
}

Restart Windsurf, then open Cascade (Cmd/Ctrl+L).

Add to .cursor/mcp.json in your project root:

mcp.json

{
  "mcpServers": {
    "agents-machine": {
      "serverUrl": "http://localhost:3000/mcp"
    }
  }
}

Restart Cursor.

Run in your terminal:

claude mcp add --transport http agents-machine http://localhost:3000/mcp

Store Project Context

Persistent memory is the killer feature. Everything you store persists across sessions, IDE restarts, and even machine changes (data is in PostgreSQL + Qdrant).

In your IDE's AI chat, tell it about your project:

Store this in memory: Our project uses React + TypeScript frontend,
Elysia.js backend, Drizzle ORM with PostgreSQL, and deploys via Docker.
Category: architecture
Tags: stack, react, elysia, drizzle

Use Agents

Spawn a specialized agent for complex tasks:

Spawn the architect agent to design a new authentication system for our API.

Create a Skill

Skills are reusable AI tools you can invoke by name:

Create a skill called "code-reviewer" that reviews code for:
- TypeScript best practices
- Security vulnerabilities
- Performance issues

Then invoke it anytime:

Invoke the code-reviewer skill on the auth middleware.

Manage Secrets

Store API keys in the encrypted vault — never hardcode them:

Store secret OPENROUTER_API_KEY with value sk-or-...
Category: api_key

Skills can automatically inject vault secrets at runtime via environment variable mapping. No manual retrieval needed.

Organize with Kanban

Track work with AI-powered task boards:

Create a board called "auth-feature".
Create task auth-01: "Design JWT authentication flow" with priority P1.
Assign it to the architect agent.

What's Next?

Desktop App Guide

Full walkthrough of the desktop application.

IDE Setup

Detailed setup for Windsurf, Cursor, and Claude Code.

Memory Deep Dive

Advanced memory management and best practices.

Agents

Agent orchestration, custom agents, and parallel execution.