Skip to main content

CLI tool for interacting with Gemini models

Project description

Gemini Code

A powerful AI coding assistant for your terminal, powered by Gemini 1.5 Pro with support for other LLM models.

Features

  • Interactive chat sessions in your terminal
  • Multiple model support (currently Gemini 1.5 Pro, more coming soon)
  • Intelligent context management with auto-compaction warnings and the /compact command
  • Markdown rendering in the terminal
  • Automatic tool usage by the assistant:
    • File operations (view, edit, list, grep, glob)
    • System commands (bash)
    • Web content fetching

Installation

# Clone the repository
git clone https://github.com/raizamartin/gemini-code.git
cd gemini-code

# Install the package
pip install -e .

Setup

Before using Gemini CLI, you need to set up your API keys:

# Set up Google API key for Gemini models
gemini setup YOUR_GOOGLE_API_KEY

Usage

# Start an interactive session with the default model
gemini

# Start a session with a specific model
gemini --model gemini-1.5-pro

# Set default model
gemini set-default-model gemini-1.5-pro

Interactive Commands

During an interactive session, you can use these commands:

  • /exit - Exit the chat session
  • /help - Display help information
  • /compact - Summarize the conversation to reduce token usage

How It Works

Tool Usage

Unlike direct command-line tools, the Gemini CLI's tools are used automatically by the assistant to help answer your questions. For example:

  1. You ask: "What files are in the current directory?"
  2. The assistant uses the ls tool behind the scenes
  3. The assistant provides you with a formatted response

This approach makes the interaction more natural and similar to how Claude Code works.

Context Management

Gemini CLI intelligently manages the conversation context:

  1. Warning Threshold (80%): When you reach 80% of the token limit, you'll see a warning panel suggesting to use /compact
  2. Auto-Compact Prompt (95%): At 95% of the limit, the CLI will ask if you want to automatically compact the conversation
  3. Manual Compaction: You can use /compact at any time to summarize the conversation and reduce token usage

The summarization process preserves important context while significantly reducing token count, allowing for virtually unlimited conversation length.

Development

This project is under active development. More models and features will be added soon!

Recent Changes in v0.1.16

  • Fixed file creation issues: The CLI now properly handles creating files with content
  • Enhanced tool pattern matching: Added support for more formats that Gemini might use
  • Improved edit tool handling: Better handling of missing arguments when creating files
  • Added special case for natural language edit commands (e.g., "edit filename with content: ...")

Recent Changes in v0.1.15

  • Fixed tool execution issues: The CLI now properly processes tool calls and executes Bash commands correctly
  • Fixed argument parsing for Bash tool: Commands are now passed as a single argument to avoid parsing issues
  • Improved error handling in tools: Better handling of failures and timeouts
  • Updated model name throughout the codebase to use gemini-1.5-pro consistently

Known Issues

  • If you created a config file with earlier versions, you may need to delete it to get the correct defaults:
    rm -rf ~/.config/gemini-code
    

License

MIT

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gemini_code-0.1.16.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gemini_code-0.1.16-py3-none-any.whl (17.9 kB view details)

Uploaded Python 3

File details

Details for the file gemini_code-0.1.16.tar.gz.

File metadata

  • Download URL: gemini_code-0.1.16.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for gemini_code-0.1.16.tar.gz
Algorithm Hash digest
SHA256 d72ee0478f7e004c3a8e77e0a5c16cba8d2904bc3bee0bca53ebf3c0f365d21e
MD5 91c60b5d3f723b6984488dde9c8dc39d
BLAKE2b-256 a33fee92e9d41ddc71667cd7d338395b91a0537c68a081d26420004533ec9c38

See more details on using hashes here.

File details

Details for the file gemini_code-0.1.16-py3-none-any.whl.

File metadata

  • Download URL: gemini_code-0.1.16-py3-none-any.whl
  • Upload date:
  • Size: 17.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for gemini_code-0.1.16-py3-none-any.whl
Algorithm Hash digest
SHA256 129a8a47eff57c7751b6f69ee5d77dac86a77a1229bf705fc491ecc63b4ab41a
MD5 16c0ae40a04c6b5e5dee450cf5ae490e
BLAKE2b-256 6d902828daed0e443e81e7220b69c59781f0d9bb2d99d060e98b6dd6d57993c1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page