> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate to Gloo Code

> Bring your instructions, skills, and MCP servers from Claude Code, Codex CLI, or another coding agent into Gloo Code with a short, step-by-step path.

If you already work with a coding agent such as Claude Code, OpenAI Codex CLI, Cursor, Aider, or Cline, most of what you have set up comes with you. Gloo Code reads `AGENTS.md` and `CLAUDE.md` files and the skill folders you already have, and it can build an `AGENTS.md` for you from other tools' rule files. Your MCP servers and custom commands are the main things you copy over, and each is a short copy and paste.

This section walks you through it, task first.

Claude Code, Codex, Cursor, Aider, Cline and GitHub Copilot are products of their respective owners, mentioned here only to describe how to bring your setup over.

## The step-by-step path

**1. Install and sign in**

Run the installer, then start `gloocode` in any folder. It opens **Sign in to Gloo** and signs you in through the browser. You need an organization with a Gloo Code subscription and a seat assigned to you. See [Installation & Setup](/gloocode/installation), or [Gloo Code Desktop](/gloocode/desktop) if you prefer a macOS app. Tiers and seats are in [Billing & Plans](/studio/billing#choosing-a-gloo-code-tier).

```bash theme={null}
curl -fsSL https://gloocode.ai.gloo.com/install.sh | sh
```

**2. Open your project**

Run `gloocode` from your project folder. If the folder has its own Gloo Code config (a `gloocode.json`, or a `.gloocode`, `.claude`, or `.agents` folder), Gloo Code asks once whether you trust it. Say yes to apply the project's own config, skills, and MCP servers. You can also type `/trust` at any time.

```bash theme={null}
cd ~/my-project
gloocode
```

**3. Bring your instructions**

Nothing to do if you already have an `AGENTS.md` or `CLAUDE.md`. Gloo Code loads both, from the current folder up to the repository root, and it also loads your personal `~/.claude/CLAUDE.md`. Coming from Cursor, Copilot, or another tool? Run `/init` and Gloo Code reads your existing rule files and drafts an `AGENTS.md` for you to review.

**4. Bring your skills**

Skills in `~/.claude/skills`, `.claude/skills`, `~/.agents/skills`, and `.agents/skills` are discovered automatically. Type `/skills` to see what was found.

**5. Add your MCP servers**

Add each server to the `mcp` section of `gloocode.json`, or run `gloocode mcp add` for a guided wizard. See [Move your MCP servers](/gloocode/migrate/mcp-servers) for copy-and-paste conversions from Claude Code and Codex.

**6. Pick a model and an agent**

Gloo Code chooses the model for you, so there is nothing to set up. You choose the agent: press **Tab** to switch between **build**, which does the work, and **plan**, which reads and proposes. To pick a model yourself, type `/models`.

**7. Run your first task**

Describe what you want in plain language, for example `Explain this codebase` or `Fix the failing test in src/auth`. Type `@` to mention a file. If you don't like a result, `/undo` rolls it back.

## Concepts at a glance

Where the things you already use live in Gloo Code.

| What you use today | In Gloo Code |
| - | - |
| `CLAUDE.md`, `AGENTS.md` (project) | Read as they are, from the current folder up to the repository root |
| `~/.claude/CLAUDE.md` | Read as it is |
| `~/.codex/AGENTS.md` | Copy to `~/.config/gloocode/AGENTS.md` |
| Cursor rules, `.cursorrules`, Copilot instructions | `/init` reads them and drafts an `AGENTS.md` |
| Extra convention files (`CONVENTIONS.md`, `.clinerules`, shared docs) | List them under `instructions` in `gloocode.json` |
| Skills (`SKILL.md`) in `.claude/skills` or `~/.claude/skills` | Same folders, discovered automatically, listed with `/skills` |
| MCP servers (`.mcp.json`, `config.toml`) | The `mcp` section of `gloocode.json`, or `gloocode mcp add` |
| Custom slash commands | Markdown files in `.gloocode/commands/` |
| Plan mode | The **plan** agent. Press **Tab** to switch |
| Subagents | Built-in subagents such as `explore` and `review`, plus your own in `.gloocode/agents/` |
| `settings.json`, `config.toml` | `gloocode.json` (comments allowed), global in `~/.config/gloocode/` or per project |
| Rewind, checkpoints | `/undo` and `/redo` |
| Resume a session | `gloocode --continue`, or `/sessions` |
| Skip permission prompts | `--unleashed` allows every prompt that no deny rule blocks, for that run (see the warning below) |
| One-shot, scriptable runs (`claude -p`, `codex exec`) | `gloocode run "your message"` |

> [!WARNING]
>
> `--unleashed` allows every prompt that no deny rule blocks. The agent can change or delete files and run commands without asking. Use it only in a scratch folder, a container, or a throwaway checkout. You are responsible for what it runs.

> **[From Claude Code](/gloocode/migrate/from-claude-code)**
>
> CLAUDE.md, skills, commands, and day-to-day shortcuts.

> **[From Codex CLI](/gloocode/migrate/from-codex)**
>
> AGENTS.md, skills, and config.toml MCP servers.

> **[From other tools](/gloocode/migrate/from-other-tools)**
>
> Cursor, Aider, Cline, and GitHub Copilot.

> **[Move your MCP servers](/gloocode/migrate/mcp-servers)**
>
> The Gloo Code MCP format with conversion recipes.

> [!TIP]
>
> Stuck on a detail? Ask Gloo Code from inside a session, for example "How do I bring my Cursor rules over?". See [Ask Gloo Code](/gloocode/ask-gloocode).

## Next steps

> **[Migration checklist](/gloocode/migrate/checklist)**
>
> A copy-and-paste checklist for your first day.

> **[Launch Gloo Code](/gloocode/launch)**
>
> Start the terminal UI and run your first task.

> **[Billing & Plans](/studio/billing#choosing-a-gloo-code-tier)**
>
> Tiers, seats, monthly allowance, and top-ups.

> **[Run from scripts](/gloocode/headless)**
>
> Use gloocode run in scripts and one-off tasks.

> **[Ask Gloo Code](/gloocode/ask-gloocode)**
>
> Have Gloo Code answer questions about itself.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.