DevShell

Terminal-based AI assistant for developers powered by Google Gemini.

About

DevShell is a lightweight CLI tool that accepts commands like explain:, regex:, convert: and returns code explanations, regular expressions, code conversions, documentation lookups, and code snippets — all powered by Google Gemini.

Setup

1. Clone the repository:

   git clone https://github.com/nabinkhair42/devshell.git
   cd devshell

2. Install the package:

   pip install -e .

3. Set up your API key:

   export GEMINI_API_KEY="YOUR_KEY_HERE"

4. Run DevShell:

   devshell

Configuration

Streaming Mode

By default, DevShell uses streaming responses for faster perceived performance. You can disable streaming if needed:

# Disable streaming (use traditional mode)
export DEVSHELL_STREAMING=false
devshell

# Enable streaming (default)
export DEVSHELL_STREAMING=true
devshell

Loader Styles

The gradient loader supports multiple animation styles:

• gradient_wave - Animated wave with gradient colors (default)
• gradient_spinner - Spinning character with changing colors
• gradient_dots - Animated dots with gradient colors
• rainbow_text - Rainbow colored "Thinking..." text

Commands

• explain: <topic> — e.g. explain: async/await
• regex: <description> — e.g. regex: match email address
• convert: <code> — convert code from one format to another
• doc: <identifier> — quick documentation lookup
• snippet: <task> — generate a code snippet for a specific purpose