Back to the catalog

sidekick

Sidekick is a gemini cli extension that provides it with superpowers. Registers hooks that lauch a sidekick VSCode to render output as Markd

Open source Open in the app JSON README (API)

About

Sidekick is a gemini cli extension that provides it with superpowers. Registers hooks that lauch a sidekick VSCode to render output as Markdown preview.

Details

Kind
Plugins
Topic
Developer tools
Publisher
sandipchitale
Origin
gemini
Category
ferramentas
Version
1.0.0
Stars
1
Last push
2026-02-18T04:03:50Z
Repository state
ativo
Language
TypeScript
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
sandipchitale/sidekick

README

# Sidekick Gemini CLI extensions

This implements hooks for Gemini CLI to provide the following hooks.

## Key Idea

`gemini` cli is terminal based chat interface. This means it is incapable of rendering rich output like HTML tables, Mermaid charts etc. This extension provides a way to render rich output in VSCode.

## Lifecycle Hooks

- `session-start`: Called when a new session is started. This launches VSCode.
- `before-model`: Called before a model is invoked. This clears the per session file.
- `after-model`: Called after a model is invoked. This appends the model response to the per session file.
- With each volley with the model, the above two hooks are called. **If there is any rich output in the model response, it is rendered in VSCode.**. Thus the VSCode acts as a sidekick to the Gemini CLI like Robin to Batman
- `session-end`: Called when a new session ends. This delets the per session file.

## Screenshots

![Sidekick in action](screenshots/sidekick.png)

### Prerequisites

- Node.js 23.6+
- npm
- Gemini CLI
- VSCode
  - `code` command in your path
  - (optional) Mermaid extension for Mermaid charts

## Installation

### Steps

```bash
git clone https://github.com/sandipchitale/sidekick.git
cd sidekick
npm install
gemini extension link .
```

#### Settings

```bash
gemini extensions config sidekick
Configuring settings for "sidekick"...
✔ Setting "Keep Session File" (GEMINI_SIDEKICK_KEEP_SESSION_FILE) is already set. Overwrite? … yes
? Keep Session File
Whether to keep the session file after the session ends. › false (default) | true
```

More