Quick Start

Who is this for? New users setting up Rosetta for the first time.

When should I read this? When you want to go from zero to a working setup.

Step 1: Connect Rosetta MCP

[!WARNING] You must receive a prior approval from your manager and company to use it.

[!WARNING] Use Sonnet 4.6, GPT-5.3-codex-medium, gemini-3.1-pro or better models. Avoid Auto model selection.

[!NOTE] Rosetta is designed to never use or see data or IP. Instead it uses inversion of control, by providing a “menu” to AI coding agents.

Rosetta uses HTTP MCP transport with OAuth. Pick your IDE and add the configuration.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "Rosetta": {
      "url": "[rosetta MCP production server URL]"
    }
  }
}
Claude Code 
claude mcp add --transport http Rosetta [rosetta MCP production server URL]

Authenticate inside a claude session with /mcp, select Rosetta, Authenticate, and complete the OAuth flow.

Codex 
codex mcp add Rosetta --url [rosetta MCP production server URL]
codex mcp login Rosetta
VS Code / GitHub Copilot

Add to .vscode/mcp.json or ~/.mcp.json:

{
  "servers": {
    "Rosetta": {
      "url": "[rosetta MCP production server URL]"
    }
  }
}
GitHub Copilot (JetBrains)

Settings > Tools > GitHub Copilot > MCP Settings. Add to ~/.config/github-copilot/intellij/mcp.json:

{
  "servers": {
    "Rosetta": {
      "url": "[rosetta MCP production server URL]"
    }
  }
}

Restart IDE after changes.

JetBrains Junie

Settings > Tools > Junie > MCP Settings > + Add > As JSON:

{
  "mcpServers": {
    "Rosetta": {
      "url": "[rosetta MCP production server URL]"
    }
  }
}
Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "Rosetta": {
      "url": "[rosetta MCP production server URL]"
    }
  }
}
Antigravity

Add to your Antigravity MCP config:

{
  "mcpServers": {
    "Rosetta": {
      "serverUrl": "[rosetta MCP production server URL]"
    }
  }
}
OpenCode

Add to opencode.json:

{
  "mcp": {
    "Rosetta": {
      "type": "http",
      "url": "[rosetta MCP production server URL]",
      "enabled": true
    }
  }
}

Any MCP client that supports HTTP transport can connect using the endpoint URL. Complete the OAuth flow when prompted.

STDIO transport is available for air-gapped environments. See Installation.

Step 2: Verify

Ask the agent:

What can you do, Rosetta?

It should use Rosetta MCP to retrieve agents, guardrails, and instructions.

Step 3: Initialize (once per repository)

Ask the agent:

Initialize this repository using Rosetta

The agent will analyze your tech stack, generate documentation (TECHSTACK.md, CODEMAP.md, DEPENDENCIES.md, ARCHITECTURE.md, CONTEXT.md), and ask clarifying questions. Read more about workspace files and all workflows.

[!NOTE] Prefer medium models: High reasoning and Opus models consume too much token on reasoning. Composite workspaces: init each repository separately, then init at the workspace level with “This is composite workspace” appended. Dead code or existing specs: mention their location in the prompt to save time.

Step 4: Add Bootstrap Rule (optional)

If something does not work.

Download bootstrap.md and add it to your IDE’s instruction file (keep entire contents, including YAML frontmatter):

IDE Destination
Cursor .cursor/rules/bootstrap.mdc
Claude Code .claude/claude.md
VS Code / GitHub Copilot .github/copilot-instructions.md
GitHub Copilot (JetBrains) .github/copilot-instructions.md
JetBrains Junie .junie/guidelines.md
Windsurf .windsurf/rules/bootstrap.md
Antigravity .agent/rules/bootstrap.md
OpenCode AGENTS.md

Common Issues

Next Steps

Video Tutorials