@rlabs-inc/gemini-mcp 0.7.1 → 0.8.0

package/README.md

@@ -5,7 +5,7 @@ A Model Context Protocol (MCP) server for integrating Google's Gemini 3 models w
 [![npm version](https://badge.fury.io/js/@rlabs-inc%2Fgemini-mcp.svg)](https://www.npmjs.com/package/@rlabs-inc/gemini-mcp)
 [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
 
-## What's New in v0.7.0
+## What's New in v0.7.2
 
 **Beautiful CLI with Themes!** Use Gemini directly from your terminal:
 
@@ -14,26 +14,26 @@ A Model Context Protocol (MCP) server for integrating Google's Gemini 3 models w
 npm install -g @rlabs-inc/gemini-mcp
 
 # Set your API key once
-gemini config set api-key YOUR_KEY
+gcli config set api-key YOUR_KEY
 
 # Generate images, videos, search, research, and more!
-gemini image "a cat astronaut" --size 4K
-gemini search "latest AI news"
-gemini research "quantum computing applications" --wait
-gemini speak "Hello world" --voice Puck
+gcli image "a cat astronaut" --size 4K
+gcli search "latest AI news"
+gcli research "quantum computing applications" --wait
+gcli speak "Hello world" --voice Puck
 ```
 
 **5 Beautiful Themes:** terminal, neon, ocean, forest, minimal
 
 **CLI Commands:**
-- `gemini query` - Direct Gemini queries with thinking levels
-- `gemini search` - Real-time web search with citations
-- `gemini research` - Deep research agent
-- `gemini image` - Generate images (up to 4K)
-- `gemini video` - Generate videos with Veo
-- `gemini speak` - Text-to-speech with 30 voices
-- `gemini tokens` - Count tokens and estimate costs
-- `gemini config` - Manage settings
+- `gcli query` - Direct Gemini queries with thinking levels
+- `gcli search` - Real-time web search with citations
+- `gcli research` - Deep research agent
+- `gcli image` - Generate images (up to 4K)
+- `gcli video` - Generate videos with Veo
+- `gcli speak` - Text-to-speech with 30 voices
+- `gcli tokens` - Count tokens and estimate costs
+- `gcli config` - Manage settings
 
 **MCP Registry Support:** Now discoverable in the official MCP ecosystem!
 
@@ -92,11 +92,11 @@ claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY bunx @rlabs-inc/gem
 npm install -g @rlabs-inc/gemini-mcp
 
 # Set your API key once (stored securely)
-gemini config set api-key YOUR_KEY
+gcli config set api-key YOUR_KEY
 
 # Now use any command!
-gemini search "latest news"
-gemini image "sunset over mountains" --ratio 16:9
+gcli search "latest news"
+glci image "sunset over mountains" --ratio 16:9
 ```
 
 **Get your API key:** Visit [Google AI Studio](https://aistudio.google.com/apikey) - it's free and takes seconds!

package/dist/cli/commands/config.d.ts

@@ -2,7 +2,7 @@
  * Config Command
  *
  * Set and view CLI configuration.
- * gemini config set api-key YOUR_KEY
- * gemini config show
+ * gcli config set api-key YOUR_KEY
+ * gcli config show
  */
 export declare function configCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/config.js

@@ -2,18 +2,18 @@
  * Config Command
  *
  * Set and view CLI configuration.
- * gemini config set api-key YOUR_KEY
- * gemini config show
+ * gcli config set api-key YOUR_KEY
+ * gcli config show
  */
 import { parseArgs } from 'node:util';
 import { loadConfig, saveConfig, getConfigPath } from '../config.js';
 import { print, printError, printSuccess, printMuted, printWarning, t, header, box } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini config', 'CLI configuration'));
+    print(header('gcli config', 'CLI configuration'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini config ${theme.colors.muted('<command>')} [options]`);
+    print(`  gcli config ${theme.colors.muted('<command>')} [options]`);
     print('');
     print(theme.colors.primary('Commands:'));
     print(`  ${theme.colors.highlight('set')}    ${theme.colors.muted('Set a configuration value')}`);
@@ -28,10 +28,10 @@ function showHelp() {
     print(`  ${theme.colors.highlight('default-model')}   ${theme.colors.muted('Default model (pro or flash)')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini config set api-key AIzaSy...'));
-    print(theme.colors.muted('  gemini config set theme neon'));
-    print(theme.colors.muted('  gemini config set output-dir ~/Documents/Gemini'));
-    print(theme.colors.muted('  gemini config show'));
+    print(theme.colors.muted('  gcli config set api-key AIzaSy...'));
+    print(theme.colors.muted('  gcli config set theme neon'));
+    print(theme.colors.muted('  gcli config set output-dir ~/Documents/Gemini'));
+    print(theme.colors.muted('  gcli config show'));
 }
 async function showConfig() {
     const theme = t();
@@ -51,7 +51,7 @@ async function showConfig() {
     print('');
     if (!config.apiKey) {
         printWarning('API key not set. Set it with:');
-        print(theme.colors.muted('  gemini config set api-key YOUR_API_KEY'));
+        print(theme.colors.muted('  gcli config set api-key YOUR_API_KEY'));
         print('');
         print(theme.colors.muted('Or set the GEMINI_API_KEY environment variable.'));
     }
@@ -133,8 +133,8 @@ export async function configCommand(argv) {
             const key = positionals[1];
             const value = positionals.slice(2).join(' ');
             if (!key || !value) {
-                printError('Usage: gemini config set <key> <value>');
-                printMuted('Example: gemini config set api-key YOUR_KEY');
+                printError('Usage: gcli config set <key> <value>');
+                printMuted('Example: gcli config set api-key YOUR_KEY');
                 process.exit(1);
             }
             await setConfig(key, value);

package/dist/cli/commands/image.d.ts

@@ -2,6 +2,6 @@
  * Image Command
  *
  * Generate images with Gemini's Imagen model.
- * gemini image "a cat in space"
+ * gcli image "a cat in space"
  */
 export declare function imageCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/image.js

@@ -2,7 +2,7 @@
  * Image Command
  *
  * Generate images with Gemini's Imagen model.
- * gemini image "a cat in space"
+ * gcli image "a cat in space"
  */
 import { parseArgs } from 'node:util';
 import { initGeminiClient, generateImage } from '../../gemini-client.js';
@@ -13,10 +13,10 @@ const VALID_SIZES = ['1K', '2K', '4K'];
 const VALID_RATIOS = ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9'];
 function showHelp() {
     const theme = t();
-    print(header('gemini image', 'Generate images with AI'));
+    print(header('gcli image', 'Generate images with AI'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini image ${theme.colors.muted('"your prompt"')} [options]`);
+    print(`  gcli image ${theme.colors.muted('"your prompt"')} [options]`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--size, -s')}     ${theme.colors.muted('Resolution: 1K, 2K, 4K (default: 2K)')}`);
@@ -35,10 +35,10 @@ function showHelp() {
     print(theme.colors.muted('  21:9  - Ultrawide cinematic'));
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini image "a cat astronaut floating in space"'));
-    print(theme.colors.muted('  gemini image "sunset over mountains" --ratio 16:9 --size 4K'));
-    print(theme.colors.muted('  gemini image "portrait of a robot" -r 3:4 --style "oil painting"'));
-    print(theme.colors.muted('  gemini image "Eiffel Tower at night" --search'));
+    print(theme.colors.muted('  gcli image "a cat astronaut floating in space"'));
+    print(theme.colors.muted('  gcli image "sunset over mountains" --ratio 16:9 --size 4K'));
+    print(theme.colors.muted('  gcli image "portrait of a robot" -r 3:4 --style "oil painting"'));
+    print(theme.colors.muted('  gcli image "Eiffel Tower at night" --search'));
 }
 export async function imageCommand(argv) {
     const { values, positionals } = parseArgs({
@@ -61,7 +61,7 @@ export async function imageCommand(argv) {
     const prompt = positionals.join(' ');
     if (!prompt) {
         printError('No image prompt provided');
-        printMuted('Usage: gemini image "your prompt"');
+        printMuted('Usage: gcli image "your prompt"');
         process.exit(1);
     }
     const theme = t();

package/dist/cli/commands/query.d.ts

@@ -2,6 +2,6 @@
  * Query Command
  *
  * Direct queries to Gemini with thinking level control.
- * gemini query "your prompt" [--thinking high]
+ * gcli query "your prompt" [--thinking high]
  */
 export declare function queryCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/query.js

@@ -2,7 +2,7 @@
  * Query Command
  *
  * Direct queries to Gemini with thinking level control.
- * gemini query "your prompt" [--thinking high]
+ * gcli query "your prompt" [--thinking high]
  */
 import { parseArgs } from 'node:util';
 import { initGeminiClient, generateWithGeminiPro, generateWithGeminiFlash } from '../../gemini-client.js';
@@ -10,10 +10,10 @@ import { setupLogger } from '../../utils/logger.js';
 import { spinner, print, printError, printMuted, t, header } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini query', 'Query Gemini directly'));
+    print(header('gcli query', 'Query Gemini directly'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini query ${theme.colors.muted('"your prompt"')} [options]`);
+    print(`  gcli query ${theme.colors.muted('"your prompt"')} [options]`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--thinking, -t')}  ${theme.colors.muted('Thinking level: minimal, low, medium, high (default: high)')}`);
@@ -21,9 +21,9 @@ function showHelp() {
     print(`  ${theme.colors.highlight('--help, -h')}      ${theme.colors.muted('Show this help')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini query "What is the meaning of life?"'));
-    print(theme.colors.muted('  gemini query "Explain quantum computing" --thinking high'));
-    print(theme.colors.muted('  gemini query "Quick fact check" -t minimal -m flash'));
+    print(theme.colors.muted('  gcli query "What is the meaning of life?"'));
+    print(theme.colors.muted('  gcli query "Explain quantum computing" --thinking high'));
+    print(theme.colors.muted('  gcli query "Quick fact check" -t minimal -m flash'));
 }
 export async function queryCommand(argv) {
     const { values, positionals } = parseArgs({
@@ -43,7 +43,7 @@ export async function queryCommand(argv) {
     const prompt = positionals.join(' ');
     if (!prompt) {
         printError('No prompt provided');
-        printMuted('Usage: gemini query "your prompt"');
+        printMuted('Usage: gcli query "your prompt"');
         process.exit(1);
     }
     // Validate thinking level

package/dist/cli/commands/research.d.ts

@@ -2,6 +2,6 @@
  * Research Command
  *
  * Deep research agent for comprehensive investigation.
- * gemini research "your research question"
+ * gcli research "your research question"
  */
 export declare function researchCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/research.js

@@ -2,7 +2,7 @@
  * Research Command
  *
  * Deep research agent for comprehensive investigation.
- * gemini research "your research question"
+ * gcli research "your research question"
  */
 import { parseArgs } from 'node:util';
 import { initGeminiClient, startDeepResearch, checkDeepResearch } from '../../gemini-client.js';
@@ -10,10 +10,10 @@ import { setupLogger } from '../../utils/logger.js';
 import { spinner, progress, print, printError, printSuccess, printMuted, printWarning, t, header, box } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini research', 'Deep research agent'));
+    print(header('gcli research', 'Deep research agent'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini research ${theme.colors.muted('"your research question"')}`);
+    print(`  gcli research ${theme.colors.muted('"your research question"')}`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--format, -f')}  ${theme.colors.muted('Output format: report, outline, brief (default: report)')}`);
@@ -21,9 +21,9 @@ function showHelp() {
     print(`  ${theme.colors.highlight('--help, -h')}    ${theme.colors.muted('Show this help')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini research "MCP ecosystem and best practices"'));
-    print(theme.colors.muted('  gemini research "AI coding assistants comparison" --format outline'));
-    print(theme.colors.muted('  gemini research "Bun vs Node.js performance" --wait'));
+    print(theme.colors.muted('  gcli research "MCP ecosystem and best practices"'));
+    print(theme.colors.muted('  gcli research "AI coding assistants comparison" --format outline'));
+    print(theme.colors.muted('  gcli research "Bun vs Node.js performance" --wait'));
     print('');
     print(theme.colors.warning(`${theme.symbols.warning} Deep research typically takes 5-20 minutes (max 60 min)`));
 }
@@ -45,7 +45,7 @@ export async function researchCommand(argv) {
     const query = positionals.join(' ');
     if (!query) {
         printError('No research question provided');
-        printMuted('Usage: gemini research "your question"');
+        printMuted('Usage: gcli research "your question"');
         process.exit(1);
     }
     const theme = t();
@@ -82,7 +82,7 @@ export async function researchCommand(argv) {
             print(theme.colors.info(`${theme.symbols.info} Research is running in the background.`));
             print('');
             print('To check status:');
-            print(theme.colors.muted(`  gemini research-status ${result.id}`));
+            print(theme.colors.muted(`  gcli research-status ${result.id}`));
             print('');
             print(theme.colors.muted('Research typically takes 5-20 minutes (max 60 min).'));
             print(theme.colors.muted('Results will be saved to your configured output directory.'));
@@ -137,7 +137,7 @@ export async function researchCommand(argv) {
         // Timed out
         p.fail('Research timed out');
         printWarning('Research is still running. Check status later:');
-        print(theme.colors.muted(`  gemini research-status ${result.id}`));
+        print(theme.colors.muted(`  gcli research-status ${result.id}`));
     }
     catch (error) {
         s.error('Research failed');

package/dist/cli/commands/search.d.ts

@@ -2,6 +2,6 @@
  * Search Command
  *
  * Real-time web search powered by Gemini + Google Search.
- * gemini search "your query"
+ * gcli search "your query"
  */
 export declare function searchCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/search.js

@@ -2,7 +2,7 @@
  * Search Command
  *
  * Real-time web search powered by Gemini + Google Search.
- * gemini search "your query"
+ * gcli search "your query"
  */
 import { parseArgs } from 'node:util';
 import { GoogleGenAI } from '@google/genai';
@@ -10,19 +10,19 @@ import { setupLogger } from '../../utils/logger.js';
 import { spinner, print, printError, printMuted, t, header } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini search', 'Real-time web search'));
+    print(header('gcli search', 'Real-time web search'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini search ${theme.colors.muted('"your query"')}`);
+    print(`  gcli search ${theme.colors.muted('"your query"')}`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--no-citations')}  ${theme.colors.muted('Hide inline citations')}`);
     print(`  ${theme.colors.highlight('--help, -h')}      ${theme.colors.muted('Show this help')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini search "latest news about AI"'));
-    print(theme.colors.muted('  gemini search "weather in São Paulo"'));
-    print(theme.colors.muted('  gemini search "MCP Model Context Protocol"'));
+    print(theme.colors.muted('  gcli search "latest news about AI"'));
+    print(theme.colors.muted('  gcli search "weather in São Paulo"'));
+    print(theme.colors.muted('  gcli search "MCP Model Context Protocol"'));
 }
 /**
  * Add inline citations to text based on grounding metadata
@@ -73,7 +73,7 @@ export async function searchCommand(argv) {
     const query = positionals.join(' ');
     if (!query) {
         printError('No search query provided');
-        printMuted('Usage: gemini search "your query"');
+        printMuted('Usage: gcli search "your query"');
         process.exit(1);
     }
     const theme = t();

package/dist/cli/commands/speak.d.ts

@@ -2,6 +2,6 @@
  * Speak Command
  *
  * Text-to-speech with multiple voices.
- * gemini speak "your text" --voice Kore
+ * gcli speak "your text" --voice Kore
  */
 export declare function speakCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/speak.js

@@ -2,7 +2,7 @@
  * Speak Command
  *
  * Text-to-speech with multiple voices.
- * gemini speak "your text" --voice Kore
+ * gcli speak "your text" --voice Kore
  */
 import { parseArgs } from 'node:util';
 import { GoogleGenAI, Modality } from '@google/genai';
@@ -20,10 +20,10 @@ const VOICES = [
 ];
 function showHelp() {
     const theme = t();
-    print(header('gemini speak', 'Text-to-speech'));
+    print(header('gcli speak', 'Text-to-speech'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini speak ${theme.colors.muted('"your text"')} [options]`);
+    print(`  gcli speak ${theme.colors.muted('"your text"')} [options]`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--voice, -v')}    ${theme.colors.muted('Voice to use (default: Kore)')}`);
@@ -40,10 +40,10 @@ function showHelp() {
     print(theme.colors.muted('  Aoede    - Breezy, light'));
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini speak "Hello world!" --voice Puck'));
-    print(theme.colors.muted('  gemini speak "Important message" -v Kore -o message.mp3'));
-    print(theme.colors.muted('  gemini speak "Exciting news!" --style "enthusiastically"'));
-    print(theme.colors.muted('  gemini speak --list-voices'));
+    print(theme.colors.muted('  gcli speak "Hello world!" --voice Puck'));
+    print(theme.colors.muted('  gcli speak "Important message" -v Kore -o message.mp3'));
+    print(theme.colors.muted('  gcli speak "Exciting news!" --style "enthusiastically"'));
+    print(theme.colors.muted('  gcli speak --list-voices'));
 }
 function listVoices() {
     const theme = t();
@@ -89,7 +89,7 @@ export async function speakCommand(argv) {
     const text = positionals.join(' ');
     if (!text) {
         printError('No text provided');
-        printMuted('Usage: gemini speak "your text"');
+        printMuted('Usage: gcli speak "your text"');
         process.exit(1);
     }
     const theme = t();
@@ -99,7 +99,7 @@ export async function speakCommand(argv) {
     // Validate voice
     if (!VOICES.includes(voice)) {
         printError(`Unknown voice: ${voice}`);
-        printMuted(`Run 'gemini speak --list-voices' to see available voices`);
+        printMuted(`Run 'gcli speak --list-voices' to see available voices`);
         process.exit(1);
     }
     try {

package/dist/cli/commands/tokens.d.ts

@@ -2,7 +2,7 @@
  * Tokens Command
  *
  * Count tokens in text or files.
- * gemini tokens "your text"
- * gemini tokens @file.txt
+ * gcli tokens "your text"
+ * gcli tokens @file.txt
  */
 export declare function tokensCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/tokens.js

@@ -2,8 +2,8 @@
  * Tokens Command
  *
  * Count tokens in text or files.
- * gemini tokens "your text"
- * gemini tokens @file.txt
+ * gcli tokens "your text"
+ * gcli tokens @file.txt
  */
 import { parseArgs } from 'node:util';
 import { initGeminiClient, countTokens } from '../../gemini-client.js';
@@ -11,20 +11,20 @@ import { setupLogger } from '../../utils/logger.js';
 import { spinner, print, printError, printMuted, t, header, box } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini tokens', 'Count tokens in text or files'));
+    print(header('gcli tokens', 'Count tokens in text or files'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini tokens ${theme.colors.muted('"your text"')}`);
-    print(`  gemini tokens ${theme.colors.muted('@file.txt')}`);
+    print(`  gcli tokens ${theme.colors.muted('"your text"')}`);
+    print(`  gcli tokens ${theme.colors.muted('@file.txt')}`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--model, -m')}  ${theme.colors.muted('Model for tokenization: pro, flash (default: flash)')}`);
     print(`  ${theme.colors.highlight('--help, -h')}   ${theme.colors.muted('Show this help')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini tokens "Hello, world!"'));
-    print(theme.colors.muted('  gemini tokens @README.md'));
-    print(theme.colors.muted('  gemini tokens @src/index.ts --model pro'));
+    print(theme.colors.muted('  gcli tokens "Hello, world!"'));
+    print(theme.colors.muted('  gcli tokens @README.md'));
+    print(theme.colors.muted('  gcli tokens @src/index.ts --model pro'));
 }
 export async function tokensCommand(argv) {
     const { values, positionals } = parseArgs({
@@ -43,7 +43,7 @@ export async function tokensCommand(argv) {
     const input = positionals.join(' ');
     if (!input) {
         printError('No text or file provided');
-        printMuted('Usage: gemini tokens "your text" or gemini tokens @file.txt');
+        printMuted('Usage: gcli tokens "your text" or gcli tokens @file.txt');
         process.exit(1);
     }
     const theme = t();

package/dist/cli/commands/video.d.ts

@@ -2,6 +2,6 @@
  * Video Command
  *
  * Generate videos with Gemini's Veo model.
- * gemini video "a cat playing piano"
+ * gcli video "a cat playing piano"
  */
 export declare function videoCommand(argv: string[]): Promise<void>;

package/dist/cli/commands/video.js

@@ -2,7 +2,7 @@
  * Video Command
  *
  * Generate videos with Gemini's Veo model.
- * gemini video "a cat playing piano"
+ * gcli video "a cat playing piano"
  */
 import { parseArgs } from 'node:util';
 import { initGeminiClient, startVideoGeneration, checkVideoStatus } from '../../gemini-client.js';
@@ -10,10 +10,10 @@ import { setupLogger } from '../../utils/logger.js';
 import { spinner, progress, print, printError, printSuccess, printMuted, printWarning, t, header, box } from '../ui/index.js';
 function showHelp() {
     const theme = t();
-    print(header('gemini video', 'Generate videos with AI'));
+    print(header('gcli video', 'Generate videos with AI'));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini video ${theme.colors.muted('"your prompt"')} [options]`);
+    print(`  gcli video ${theme.colors.muted('"your prompt"')} [options]`);
     print('');
     print(theme.colors.primary('Options:'));
     print(`  ${theme.colors.highlight('--ratio, -r')}    ${theme.colors.muted('Aspect ratio: 16:9, 9:16 (default: 16:9)')}`);
@@ -22,9 +22,9 @@ function showHelp() {
     print(`  ${theme.colors.highlight('--help, -h')}     ${theme.colors.muted('Show this help')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini video "a cat playing piano"'));
-    print(theme.colors.muted('  gemini video "sunset timelapse" --ratio 16:9 --wait'));
-    print(theme.colors.muted('  gemini video "robot dancing" -r 9:16 --negative "text, blur"'));
+    print(theme.colors.muted('  gcli video "a cat playing piano"'));
+    print(theme.colors.muted('  gcli video "sunset timelapse" --ratio 16:9 --wait'));
+    print(theme.colors.muted('  gcli video "robot dancing" -r 9:16 --negative "text, blur"'));
     print('');
     print(theme.colors.warning(`${theme.symbols.warning} Video generation can take 2-5 minutes`));
 }
@@ -47,7 +47,7 @@ export async function videoCommand(argv) {
     const prompt = positionals.join(' ');
     if (!prompt) {
         printError('No video prompt provided');
-        printMuted('Usage: gemini video "your prompt"');
+        printMuted('Usage: gcli video "your prompt"');
         process.exit(1);
     }
     const theme = t();

package/dist/cli/index.js

@@ -14,7 +14,7 @@ import { speakCommand } from './commands/speak.js';
 import { configCommand } from './commands/config.js';
 import { imageCommand } from './commands/image.js';
 import { videoCommand } from './commands/video.js';
-const VERSION = '0.7.0';
+const VERSION = '0.7.2';
 // Placeholder command for development
 const placeholderCommand = (name) => ({
     name,
@@ -71,7 +71,7 @@ function showHelp() {
     print(header('Gemini CLI', `AI-powered tools at your terminal (v${VERSION})`));
     print('');
     print(theme.colors.primary('Usage:'));
-    print(`  gemini ${theme.colors.muted('<command>')} [options]`);
+    print(`  gcli ${theme.colors.muted('<command>')} [options]`);
     print('');
     print(theme.colors.primary('Commands:'));
     print(`  ${theme.colors.highlight('query')}     ${theme.colors.muted('Query Gemini directly')}`);
@@ -90,16 +90,16 @@ function showHelp() {
     print(`  ${theme.colors.highlight('--theme')}        ${theme.colors.muted('Set color theme (terminal, neon, minimal, ocean, forest)')}`);
     print('');
     print(theme.colors.primary('Examples:'));
-    print(theme.colors.muted('  gemini query "What is the meaning of life?"'));
-    print(theme.colors.muted('  gemini search "latest AI news"'));
-    print(theme.colors.muted('  gemini image "a cat in space" --size 4K'));
-    print(theme.colors.muted('  gemini research "MCP ecosystem" --format outline'));
+    print(theme.colors.muted('  gcli query "What is the meaning of life?"'));
+    print(theme.colors.muted('  gcli search "latest AI news"'));
+    print(theme.colors.muted('  gcli image "a cat in space" --size 4K'));
+    print(theme.colors.muted('  gcli research "MCP ecosystem" --format outline'));
     print('');
-    print(theme.colors.muted(`Run 'gemini <command> --help' for command-specific options.`));
+    print(theme.colors.muted(`Run 'gcli <command> --help' for command-specific options.`));
 }
 function showVersion() {
     const theme = t();
-    print(`${theme.colors.primary('gemini')} ${theme.colors.highlight(`v${VERSION}`)}`);
+    print(`${theme.colors.primary('gcli')} ${theme.colors.highlight(`v${VERSION}`)}`);
 }
 export async function runCli(argv) {
     // Load config first
@@ -147,7 +147,7 @@ export async function runCli(argv) {
     const command = commands[commandName];
     if (!command) {
         printError(`Unknown command: ${commandName}`);
-        printMuted(`Run 'gemini --help' for available commands`);
+        printMuted(`Run 'gcli --help' for available commands`);
         process.exit(1);
     }
     // Get command arguments (everything after the command)
@@ -161,7 +161,7 @@ export async function runCli(argv) {
         const apiKey = getApiKey(config);
         if (!apiKey) {
             printError('GEMINI_API_KEY environment variable is required');
-            printMuted('Set it with: gemini config set api-key YOUR_KEY');
+            printMuted('Set it with: gcli config set api-key YOUR_KEY');
             process.exit(1);
         }
         // Set env var from config for gemini-client.ts to use

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * Gemini - Dual Mode Entry Point
  *
  * 1. MCP Server Mode (default): `gemini-mcp` or `gemini serve`
- * 2. CLI Mode: `gemini <command> [options]`
+ * 2. CLI Mode: `gcli <command> [options]`
  *
  * This integrates Google's Gemini models with Claude Code (MCP)
  * and provides a beautiful standalone CLI experience.

package/dist/index.js

@@ -3,7 +3,7 @@
  * Gemini - Dual Mode Entry Point
  *
  * 1. MCP Server Mode (default): `gemini-mcp` or `gemini serve`
- * 2. CLI Mode: `gemini <command> [options]`
+ * 2. CLI Mode: `gcli <command> [options]`
  *
  * This integrates Google's Gemini models with Claude Code (MCP)
  * and provides a beautiful standalone CLI experience.

package/dist/server.js

@@ -25,6 +25,7 @@ import { registerCacheTool } from './tools/cache.js';
 import { registerSpeechTool } from './tools/speech.js';
 import { registerTokenCountTool } from './tools/token-count.js';
 import { registerDeepResearchTool } from './tools/deep-research.js';
+import { registerImageAnalyzeTool } from './tools/image-analyze.js';
 // Import Gemini client and logger
 import { initGeminiClient } from './gemini-client.js';
 import { setupLogger, logger } from './utils/logger.js';
@@ -114,7 +115,7 @@ For CLI mode, run: gemini --help
         // Create MCP server
         const server = new McpServer({
             name: 'Gemini',
-            version: '0.7.0',
+            version: '0.7.2',
         });
         // Register tools
         registerQueryTool(server);
@@ -134,6 +135,7 @@ For CLI mode, run: gemini --help
         registerSpeechTool(server);
         registerTokenCountTool(server);
         registerDeepResearchTool(server);
+        registerImageAnalyzeTool(server);
         // Start server with stdio transport
         const transport = new StdioServerTransport();
         // Set up error handling for transport

package/dist/tools/image-analyze.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Image Analysis Tool - Analyze images with object detection and bounding boxes
+ *
+ * This tool uses Gemini's vision capabilities to analyze images and detect objects
+ * with bounding box coordinates. Returns both normalized box_2d format and pixel coordinates.
+ *
+ * Bounding Box Format:
+ * - box_2d: [y_min, x_min, y_max, x_max] in 0-1000 normalized coordinates
+ * - bbox_pixels: {x, y, width, height} in pixel coordinates (when dimensions available)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register image analysis tools with the MCP server
+ */
+export declare function registerImageAnalyzeTool(server: McpServer): void;

package/dist/tools/image-analyze.js

@@ -0,0 +1,363 @@
+/**
+ * Image Analysis Tool - Analyze images with object detection and bounding boxes
+ *
+ * This tool uses Gemini's vision capabilities to analyze images and detect objects
+ * with bounding box coordinates. Returns both normalized box_2d format and pixel coordinates.
+ *
+ * Bounding Box Format:
+ * - box_2d: [y_min, x_min, y_max, x_max] in 0-1000 normalized coordinates
+ * - bbox_pixels: {x, y, width, height} in pixel coordinates (when dimensions available)
+ */
+import { z } from "zod";
+import { GoogleGenAI } from "@google/genai";
+import { logger } from "../utils/logger.js";
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Extract image dimensions from PNG or JPEG file
+ */
+function extractImageDimensions(filePath) {
+    try {
+        const buffer = fs.readFileSync(filePath);
+        const ext = path.extname(filePath).toLowerCase();
+        if (ext === ".png") {
+            // PNG format: width and height are at bytes 16-23 (big-endian)
+            if (buffer.length < 24)
+                return null;
+            if (buffer.toString("ascii", 1, 4) !== "PNG")
+                return null;
+            const width = buffer.readUInt32BE(16);
+            const height = buffer.readUInt32BE(20);
+            return { width, height };
+        }
+        else if (ext === ".jpg" || ext === ".jpeg") {
+            // JPEG format: scan for SOF0 or SOF2 markers
+            let offset = 2; // Skip initial 0xFFD8
+            while (offset < buffer.length - 8) {
+                if (buffer[offset] !== 0xff)
+                    break;
+                const marker = buffer[offset + 1];
+                const segmentLength = buffer.readUInt16BE(offset + 2);
+                // SOF0 (0xC0) or SOF2 (0xC2) markers contain dimensions
+                if (marker === 0xc0 || marker === 0xc2) {
+                    const height = buffer.readUInt16BE(offset + 5);
+                    const width = buffer.readUInt16BE(offset + 7);
+                    return { width, height };
+                }
+                offset += 2 + segmentLength;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        logger.debug(`Failed to extract dimensions: ${error}`);
+        return null;
+    }
+}
+/**
+ * Convert box_2d normalized coordinates to pixel coordinates
+ */
+function convertToPixelCoords(box2d, width, height) {
+    const [yMin, xMin, yMax, xMax] = box2d;
+    return {
+        x: Math.round((xMin / 1000) * width),
+        y: Math.round((yMin / 1000) * height),
+        width: Math.round(((xMax - xMin) / 1000) * width),
+        height: Math.round(((yMax - yMin) / 1000) * height),
+    };
+}
+/**
+ * Get MIME type from file extension
+ */
+function getImageMimeType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mimeTypes = {
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".png": "image/png",
+        ".webp": "image/webp",
+        ".heic": "image/heic",
+        ".heif": "image/heif",
+        ".gif": "image/gif",
+    };
+    return mimeTypes[ext] || "image/jpeg";
+}
+/**
+ * Register image analysis tools with the MCP server
+ */
+export function registerImageAnalyzeTool(server) {
+    server.tool("gemini-analyze-image", {
+        imagePath: z
+            .string()
+            .describe("Path to image file. Supports JPEG, PNG, WebP, HEIC, HEIF, GIF"),
+        query: z
+            .string()
+            .optional()
+            .describe('Specific question about the image (e.g., "What objects are in this image?", "Count the people"). Default: "Analyze this image in detail."'),
+        detectObjects: z
+            .boolean()
+            .default(true)
+            .describe("Enable object detection with bounding boxes (returns box_2d coordinates). Default: true"),
+        model: z
+            .enum(["pro", "flash"])
+            .default("flash")
+            .describe("Model to use: pro (more accurate) or flash (faster). Default: flash"),
+        thinkingLevel: z
+            .enum(["minimal", "low", "medium", "high"])
+            .optional()
+            .describe("Reasoning depth: minimal/low for fast responses, medium/high for complex analysis. " +
+            "Pro supports low/high only. Flash supports all levels. Default: high"),
+        mediaResolution: z
+            .enum(["low", "medium", "high"])
+            .default("medium")
+            .describe("Resolution for processing: low (faster), medium (balanced), high (more detail). Default: medium"),
+    }, async ({ imagePath, query, detectObjects, model, thinkingLevel, mediaResolution }) => {
+        logger.info(`Analyzing image: ${imagePath}`);
+        try {
+            const apiKey = process.env.GEMINI_API_KEY;
+            if (!apiKey) {
+                throw new Error("GEMINI_API_KEY not set");
+            }
+            if (!fs.existsSync(imagePath)) {
+                throw new Error(`File not found: ${imagePath}`);
+            }
+            const fileBuffer = fs.readFileSync(imagePath);
+            const mimeType = getImageMimeType(imagePath);
+            const dimensions = extractImageDimensions(imagePath);
+            const genAI = new GoogleGenAI({ apiKey });
+            const modelName = model === "pro"
+                ? process.env.GEMINI_PRO_MODEL || "gemini-3-pro-preview"
+                : process.env.GEMINI_FLASH_MODEL || "gemini-3-flash-preview";
+            const fileSize = fileBuffer.length;
+            logger.debug(`Image size: ${fileSize} bytes, MIME type: ${mimeType}`);
+            // Log image dimensions (for pixel coordinate conversion)
+            if (dimensions) {
+                logger.debug(`Image dimensions: ${dimensions.width}x${dimensions.height}`);
+            }
+            else {
+                logger.debug("Could not extract image dimensions");
+            }
+            // Build prompt based on parameters
+            let prompt = query || "Analyze this image in detail.";
+            if (detectObjects) {
+                prompt += `\n\nFor each object you identify, provide bounding box coordinates in the box_2d format: [y_min, x_min, y_max, x_max] where coordinates are normalized to 0-1000 scale.
+
+Return your response as a JSON object with this structure:
+{
+  "description": "Overall description of the image",
+  "objects": [
+    {
+      "label": "object name",
+      "confidence": "high/medium/low",
+      "box_2d": [y_min, x_min, y_max, x_max]
+    }
+  ]
+}
+
+If you cannot detect specific objects or bounding boxes are not applicable, return an empty objects array.`;
+            }
+            // Map resolution to API parameter
+            const resolutionMap = {
+                low: "media_resolution_low",
+                medium: "media_resolution_medium",
+                high: "media_resolution_high",
+            };
+            // For files <20MB, use inline data. For larger files, use Files API
+            let responseText;
+            if (fileSize > 20 * 1024 * 1024) {
+                // Upload using Files API
+                logger.info("Large file detected, uploading via Files API...");
+                const uploadedFile = await genAI.files.upload({
+                    file: new Blob([new Uint8Array(fileBuffer)], { type: mimeType }),
+                    config: { mimeType },
+                });
+                const config = {};
+                if (mediaResolution !== "medium") {
+                    config.mediaResolution = resolutionMap[mediaResolution];
+                }
+                // Add thinking config for Gemini 3
+                if (thinkingLevel) {
+                    // Pro only supports low/high, Flash supports all levels
+                    const effectiveLevel = model === "pro"
+                        ? (thinkingLevel === "minimal" || thinkingLevel === "low" ? "low" : "high")
+                        : thinkingLevel;
+                    config.thinkingConfig = { thinkingLevel: effectiveLevel };
+                    logger.debug(`Using thinking level: ${effectiveLevel}${model === "pro" && effectiveLevel !== thinkingLevel ? ` (requested: ${thinkingLevel})` : ""}`);
+                }
+                // Add structured output for object detection
+                if (detectObjects) {
+                    config.responseMimeType = "application/json";
+                    config.responseJsonSchema = {
+                        type: "object",
+                        properties: {
+                            description: { type: "string" },
+                            objects: {
+                                type: "array",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        label: { type: "string" },
+                                        confidence: { type: "string" },
+                                        box_2d: {
+                                            type: "array",
+                                            items: { type: "number" },
+                                            minItems: 4,
+                                            maxItems: 4,
+                                        },
+                                    },
+                                    required: ["label", "confidence", "box_2d"],
+                                },
+                            },
+                        },
+                        required: ["description", "objects"],
+                    };
+                }
+                const response = await genAI.models.generateContent({
+                    model: modelName,
+                    contents: [
+                        {
+                            role: "user",
+                            parts: [
+                                {
+                                    fileData: {
+                                        fileUri: uploadedFile.uri,
+                                        mimeType: uploadedFile.mimeType,
+                                    },
+                                },
+                                { text: prompt },
+                            ],
+                        },
+                    ],
+                    config: Object.keys(config).length > 0 ? config : undefined,
+                });
+                responseText = response.text || "";
+            }
+            else {
+                // Use inline data for smaller files
+                const base64Data = fileBuffer.toString("base64");
+                const inlineConfig = {};
+                if (mediaResolution !== "medium") {
+                    inlineConfig.mediaResolution = resolutionMap[mediaResolution];
+                }
+                // Add thinking config for Gemini 3
+                if (thinkingLevel) {
+                    // Pro only supports low/high, Flash supports all levels
+                    const effectiveLevel = model === "pro"
+                        ? (thinkingLevel === "minimal" || thinkingLevel === "low" ? "low" : "high")
+                        : thinkingLevel;
+                    inlineConfig.thinkingConfig = { thinkingLevel: effectiveLevel };
+                    logger.debug(`Using thinking level: ${effectiveLevel}${model === "pro" && effectiveLevel !== thinkingLevel ? ` (requested: ${thinkingLevel})` : ""}`);
+                }
+                // Add structured output for object detection
+                if (detectObjects) {
+                    inlineConfig.responseMimeType = "application/json";
+                    inlineConfig.responseJsonSchema = {
+                        type: "object",
+                        properties: {
+                            description: { type: "string" },
+                            objects: {
+                                type: "array",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        label: { type: "string" },
+                                        confidence: { type: "string" },
+                                        box_2d: {
+                                            type: "array",
+                                            items: { type: "number" },
+                                            minItems: 4,
+                                            maxItems: 4,
+                                        },
+                                    },
+                                    required: ["label", "confidence", "box_2d"],
+                                },
+                            },
+                        },
+                        required: ["description", "objects"],
+                    };
+                }
+                const response = await genAI.models.generateContent({
+                    model: modelName,
+                    contents: [
+                        {
+                            role: "user",
+                            parts: [
+                                {
+                                    inlineData: {
+                                        mimeType,
+                                        data: base64Data,
+                                    },
+                                },
+                                { text: prompt },
+                            ],
+                        },
+                    ],
+                    config: Object.keys(inlineConfig).length > 0 ? inlineConfig : undefined,
+                });
+                responseText = response.text || "";
+            }
+            // Process response
+            if (detectObjects && responseText) {
+                try {
+                    const parsed = JSON.parse(responseText);
+                    // Add pixel coordinates if dimensions are available
+                    if (dimensions && parsed.objects && Array.isArray(parsed.objects)) {
+                        parsed.objects = parsed.objects.map((obj) => {
+                            if (Array.isArray(obj.box_2d) && obj.box_2d.length === 4) {
+                                return {
+                                    ...obj,
+                                    bbox_pixels: convertToPixelCoords(obj.box_2d, dimensions.width, dimensions.height),
+                                };
+                            }
+                            return obj;
+                        });
+                    }
+                    const formattedJson = JSON.stringify(parsed, null, 2);
+                    logger.info("Image analysis completed with object detection");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `**Image Analysis Results:**\n\`\`\`json\n${formattedJson}\n\`\`\``,
+                            },
+                        ],
+                    };
+                }
+                catch (parseError) {
+                    // Fallback to plain text if JSON parsing fails
+                    logger.warn("Failed to parse JSON response, returning as text");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: responseText,
+                            },
+                        ],
+                    };
+                }
+            }
+            logger.info("Image analysis completed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText || "Unable to analyze image.",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`Error in image analysis: ${errorMessage}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error analyzing image: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@rlabs-inc/gemini-mcp",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "mcpName": "io.github.RLabs-Inc/gemini-mcp",
   "description": "MCP server for Gemini 3 integration with Claude Code - 30+ AI tools including image/video generation, deep research, code execution, and beautiful CLI",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
     "gemini-mcp": "dist/index.js",
-    "gemini": "dist/index.js"
+    "gcli": "dist/index.js"
   },
   "repository": {
     "type": "git",