> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Google's Gemini coding agent. Best in vly for multi-file design work, layout passes, and schema modeling.

Gemini CLI is the design-and-multi-file pick. Where Claude Code reasons across files for refactors and Codex executes tight surgical changes, Gemini CLI excels at **layout work, visual design passes, and schema modeling** — the tasks where you're rearranging structure across many files.

## Strengths

<CardGroup cols={2}>
  <Card title="Multi-file layout work" icon="layout">
    "Restructure the dashboard with a sidebar layout" or "convert this page from grid to flex" — Gemini handles the cascading changes cleanly.
  </Card>

  <Card title="Visual / design intuition" icon="palette">
    Stronger sense for spacing, hierarchy, and component composition than the others.
  </Card>

  <Card title="Schema modeling" icon="database">
    "Design a schema for a hierarchical comment system" — Gemini's schema proposals are thoughtful about indexes and access patterns.
  </Card>

  <Card title="Long context" icon="scroll">
    Handles long prompts and large codebases comfortably.
  </Card>
</CardGroup>

## When to pick Gemini CLI

<Tabs>
  <Tab title="Layout pass">
    "Redesign the home page with a hero, three-column features, and a CTA section." Gemini.
  </Tab>

  <Tab title="Design system migration">
    "Move all color usages from inline Tailwind to CSS variables defined in our design tokens file." Gemini.
  </Tab>

  <Tab title="Schema design">
    "Design a schema for a real-time collaboration tool with documents, blocks, comments, and presence." Gemini.
  </Tab>

  <Tab title="Multi-page UI">
    "Create the marketing site: home, pricing, features, blog index, blog post template." Gemini.
  </Tab>
</Tabs>

## Usage

Same as the other agents — change the agent dropdown to **Gemini CLI** before submitting, or set it as your default.

## Tips

<Tip>
  **For schema design, Plan mode + Gemini is the strongest combo.** Gemini produces detailed plans; you review and tweak before code generation.
</Tip>

<Tip>
  **Switch to Claude Code or Codex for follow-up edits.** Gemini for the structural pass, then a faster agent for the iteration on top.
</Tip>

## Related

<CardGroup cols={3}>
  <Card title="Claude Code" icon="brain" href="/features/agents/claude-code">
    Default; large refactors.
  </Card>

  <Card title="OpenAI Codex" icon="terminal" href="/features/agents/openai-codex">
    Surgical edits.
  </Card>

  <Card title="Choosing an agent" icon="git-branch" href="/features/agents/choosing-an-agent">
    The decision tree.
  </Card>
</CardGroup>


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