Install Rosetta

← What is Rosetta? · Back to the guide · Next: Set up your repository →

Installing Rosetta means adding a plugin to your IDE. The plugin bundles everything the agent needs and runs locally — no server, no live connection, no source code leaving your machine.

This guide covers the plugin path, which is what almost everyone should use. There are advanced hosted/self-hosted options for special cases; if you think you need one, see the developer INSTALLATION guide.

Before you install

Install for your IDE

Pick your tool below.

Claude Code

Run these two commands:

claude plugin marketplace add griddynamics/rosetta
claude plugin install rosetta@rosetta

That’s it. Marketplace plugins update themselves over time.

Cursor

Easiest option: if you already have Rosetta installed in Claude Code, Cursor picks it up automatically — you don’t need to install it again. (To avoid duplicates, don’t install it separately in both.) To stop Cursor picking them up at all, turn off Include third-party Plugins, Skills, and other configs in Cursor Settings → Rules, Skills, Subagents.

Team/Enterprise marketplace: on a Cursor Teams or Enterprise plan, import the repository https://github.com/griddynamics/rosetta into your internal marketplace. Follow Cursor’s guide at https://cursor.com/docs/plugins#team-marketplaces.

Standalone (no marketplace):

  1. Download core-cursor-standalone-*.zip from the latest release.
  2. Extract the contents into your repository.
  3. Confirm the file .cursor/agents/architect.md exists, and that there’s no nested .cursor/.cursor folder.

GitHub Copilot (VS Code and JetBrains)

Marketplace:

  1. In VS Code settings, add https://github.com/griddynamics/rosetta to chat.plugins.marketplaces. In JetBrains, add the same URL under the Copilot plugin’s marketplace setting.
  2. Open the Copilot chat panel and click the settings gear to open agent customizations.
  3. Click Browse Marketplaces, then Install for rosetta.

Standalone (fallback):

  1. Download core-copilot-standalone-*.zip from the latest release.
  2. Extract into your repository. If .github/copilot-instructions.md already exists, merge — put Rosetta’s content first, then your original content.
  3. Confirm .github/agents/architect.agent.md exists, and that there’s no nested .github/.github folder.

Note: VS Code also detects the standalone install, so don’t use both marketplace and standalone at once — you’ll get duplicate tools and context.

Codex

(As of August 2026, Codex plugins do not support subagents. In Codex, invoke a workflow as $coding-flow rather than /coding-flow.)

  1. Download core-codex-*.zip from the latest release.
  2. Extract into your repository.

  3. Enable hooks:

    codex features enable hooks

Antigravity

One plugin serves Antigravity 2.0, the CLI, and the IDE.

  1. Download core-antigravity-*.zip from the latest release.
  2. Create the folder .agents/plugins/rosetta/ at your workspace root.
  3. Extract the archive contents into it.
  4. Confirm .agents/plugins/rosetta/plugin.json exists, and that there’s no nested core-antigravity folder inside.

To enable it for all workspaces instead of just one, extract into ~/.gemini/config/plugins/rosetta/ instead.

Confirm it works

Start a chat with your agent and ask:

What can you do, Rosetta?

If it’s working, the agent recognizes Rosetta and lists the available workflows (it runs the built-in help-flow to do this). If it just answers like a generic assistant with no mention of Rosetta workflows, see Tips → The agent isn’t using Rosetta.

Keeping it up to date

Next step

Rosetta is installed, but it doesn’t know your codebase yet. Do that once per repository in Set up your repository →.