Chat with Gemini
Right in Your Terminal

The most powerful CLI wrapper for Google Gemini. Automate, create, and deploy AI-powered applications from your command line.

Get Started View on GitHub

➜ node index.js

[*] Waiting for Gemini Engine...

[✔] Gemini Engine is ready!

gemini-flash ➜ Explain quantum computing

Powerful Features

🖥️

Hacker-Style CLI

Beautiful terminal interface with dynamic frames, RGB gradients, and ANSI formatting

🧠

Multi-Model Support

Seamlessly switch between Flash (fast), Pro (quality), and Thinking models

📎

File Attachments

Easily attach images, PDFs, or code files using {path/to/file} syntax

🌐

Local API Server

Built-in Express server on localhost:8000 with CORS for browser extensions

💾

Chat History

Automatically save conversations with export to text files

⚡

Performance

Optimized caching, parallel processing, and smart request handling

🔧

Easy Setup

Cross-platform installers with interactive setup for all major OS

🛡️

Error Handling

Enhanced validation, helpful messages, and automatic reconnection

Quick Installation

Get up and running in minutes

Windows (Batch)

install.bat

Or use PowerShell:

.\install.ps1

macOS

                            chmod +x install.sh
./install.sh
                        

Linux

                            chmod +x install.sh
./install.sh
                        

Manual Installation

                    npm install
npx playwright install chromium
node index.js
                

How to Use

Simple yet powerful commands

Interactive Mode

node index.js

Start an interactive chat session with beautiful UI

Single Query

node index.js "What is Node.js?"

Get a single answer and exit

With Files

node index.js "Analyze {image.png}"

Attach files to your prompts

Change Model

node index.js -m pro "Question"

Use specific model (flash, pro, thinking)

Interactive Commands

/model Switch AI model

/sys Set system prompt

/history View chat history

/export Save conversation

/stats Session statistics

/reconnect Restore connection

Frequently Asked Questions

What do I need to get started?

You need Node.js 14+ and a Google account with access to Gemini. The installer will handle all setup.

How do I set up authentication?

The installer helps you get auth.json. You can export cookies from your browser or use Playwright codegen. Detailed instructions in SETUP.md.

Can I use this for automation?

Yes! The built-in API server on localhost:8000 allows you to automate Gemini interactions in your own applications.

Is it free?

Yes, it's open source and free to use. You only need a Google account for Gemini access (which has free tier).

Works on macOS?

Absolutely! Use the install.sh script. All features work on macOS, Linux, and Windows.

Can I attach files?

Yes! Use {path/to/file} in your prompt to attach images, PDFs, code files, and more.

Chat with Gemini Right in Your Terminal