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

# Gemini Code Assist

> Set up tk with Google Gemini Code Assist for AI-powered issue tracking

Use tk with [Gemini Code Assist](https://developers.google.com/gemini-code-assist) to manage issues from Google's AI coding assistant in VS Code, JetBrains, and the Gemini CLI.

***

## What is Gemini Code Assist?

[Gemini Code Assist](https://developers.google.com/gemini-code-assist) is Google's AI coding assistant with agent mode capabilities. It integrates into VS Code, JetBrains IDEs, and Android Studio, and supports MCP servers for extending its tool access. The Gemini CLI provides a terminal-based interface with the same MCP support.

***

## MCP Integration (VS Code)

Install the [`ticket-mcp`](https://pypi.org/project/ticket-mcp/) MCP server to give Gemini Code Assist direct access to your issues.

### Workspace Configuration

Create `.gemini/settings.json` in your project root:

```json theme={null}
{
  "mcpServers": {
    "ticket-mcp": {
      "command": "uvx",
      "args": ["ticket-mcp"]
    }
  }
}
```

### User-Level Configuration

For access across all projects, create or edit `~/.gemini/settings.json`:

```json theme={null}
{
  "mcpServers": {
    "ticket-mcp": {
      "command": "uvx",
      "args": ["ticket-mcp"]
    }
  }
}
```

After saving, reload VS Code with **Developer: Reload Window** from the Command Palette.

<Accordion title="Requirements">
  **uv** installed via: `curl -LsSf https://astral.sh/uv/install.sh | sh`

  **Python** version 3.10 or higher (installed automatically by uv)

  **Gemini Code Assist** extension installed in VS Code
</Accordion>

***

## MCP Integration (JetBrains)

For IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs (2025.1+):

1. Go to **Settings > Tools > AI Assistant > Model Context Protocol (MCP)**
2. Click **+** to add a new server
3. Enter the configuration:
   * **Name:** `ticket-mcp`
   * **Transport:** STDIO
   * **Command:** `uvx`
   * **Arguments:** `ticket-mcp`
4. Click **Apply**

<Tip>
  JetBrains AI Assistant can also import MCP configurations from Claude Desktop. If you already have ticket-mcp configured there, click **Import from Claude**.
</Tip>

***

## MCP Integration (Gemini CLI)

For the terminal-based Gemini CLI, add to `~/.gemini/settings.json`:

```json theme={null}
{
  "mcpServers": {
    "ticket-mcp": {
      "command": "uvx",
      "args": ["ticket-mcp"]
    }
  }
}
```

Verify with the `/mcp` command inside a Gemini CLI session to check that ticket-mcp tools are available.

***

## Workflow Tips

### Starting a Session

Ask Gemini: *"Run tk triage and show me what I should work on today"*

### Creating Issues

Ask Gemini: *"Create a high-priority bug for the broken API endpoint"*

Gemini will run:

```bash theme={null}
tk create "Fix broken API endpoint" -t bug -p 1
```

### Closing Work

Ask Gemini: *"Resolve tk-abc123, the fix is deployed"*

### Dependency Management

Ask Gemini: *"Show the dependency tree for tk-xyz789 and explain the critical path"*

### Project Health

Ask Gemini: *"Run tk insights and summarize the project health"*

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP server not appearing in Gemini">
    Ensure you've saved the config to `.gemini/settings.json` (not `.vscode/mcp.json` — Gemini uses its own config). Reload VS Code after making changes.
  </Accordion>

  <Accordion title="JetBrains MCP not working">
    Verify you're on JetBrains 2025.1 or later. Ensure **Codebase** mode is enabled in the AI chat window — MCP calls only work with Codebase mode active.
  </Accordion>

  <Accordion title="Gemini CLI tools not loading">
    Run `/mcp` in the Gemini CLI to check server status. Ensure `uvx` is in your PATH. Try restarting the CLI session.
  </Accordion>

  <Accordion title="Slow tk commands">
    Enable caching with `tk cache info` to verify the analytics cache is working. Cached responses return in under 10ms.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/cli-reference/commands">
    Complete tk command documentation
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Deep dive into MCP server capabilities
  </Card>

  <Card title="Graph Analytics" icon="chart-network" href="/concepts/graph-analytics">
    Learn about PageRank and dependency analysis
  </Card>

  <Card title="Gemini Docs" icon="book" href="https://developers.google.com/gemini-code-assist">
    Official Gemini Code Assist documentation
  </Card>
</CardGroup>

***

## Sources

* [Gemini Code Assist Agent Mode](https://developers.google.com/gemini-code-assist/docs/use-agentic-chat-pair-programmer)
* [Gemini CLI MCP Servers](https://geminicli.com/docs/tools/mcp-server/)
* [JetBrains AI Assistant MCP](https://www.jetbrains.com/help/ai-assistant/mcp.html)
* [MCP Documentation](https://modelcontextprotocol.io)