gemqq 0.5.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Charles McBrian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# gemqq
+
+[![npm version](https://img.shields.io/npm/v/gemqq.svg)](https://www.npmjs.com/package/gemqq)
+[![Build Status](https://github.com/quadrigasoftware/gemqq/actions/workflows/test.yml/badge.svg)](https://github.com/quadrigasoftware/gemqq/actions)
+
+Gemini Quick Question is a one-shot wrapper for gemini-cli featuring interactive editor support, markdown rendering in terminal, and real-time token usage statistics. gemqq does not have memory nor context, it simply answers your 'quick questions' quickly.
+
+## Installation
+
+```bash
+npm install -g gemqq
+```
+
+## Usage
+
+```bash
+gemqq [OPTIONS] [PROMPT...]
+```
+
+### Options
+
+- `-e, --edit`: Open prompt in default editor (`EDITOR` or `VISUAL`).
+- `-r, --raw`: Output raw text (disable markdown rendering via `glow`).
+- `-c, --copy`: Copy response to system clipboard.
+- `-m, --model NAME`: Specify a custom model.
+- `--style NAME`: Specify a `glow` style (e.g., `auto`, `dark`, `light`). Default is `auto`.
+- `--no-stats`: Suppress token usage statistics and timing info.
+- `--project`: Enable full project workspace context. By default, `gemqq` isolates file context to zero by running in a temporary directory. Use this flag when you want Gemini to see your codebase.
+- `--pro`: Use `gemini-3-pro-preview` model.
+- `--flash`: Use `gemini-3-flash-preview` model (Default).
+- `--debug`: Enable debug mode.
+- `-h, --help`: Show help message.
+
+### Token Statistics
+
+By default, `gemqq` displays token usage and execution time:
+`(Done in 5.9s, 4551 tokens (4502i / 2o))`
+
+- **i**: Input Tokens (Prompt)
+- **o**: Output Tokens (Candidates)
+
+Use `--no-stats` to hide this information.
+
+### Context Isolation
+
+By default, `gemqq` executes the Gemini CLI in a temporary directory to isolate your file context to zero. This prevents Gemini from automatically snapshotting your current directory tree, which significantly reduces token usage and improves privacy for general queries.
+
+If you need Gemini to analyze your codebase or reference local files, use the `--project` flag to run in your current working directory with full context enabled.
+
+### Examples
+
+```terminaloutput
+gemqq difference between gemini 3.0, 3.1. make a table
+cat file.txt | gemqq summarize this
+gemqq -e --pro
+gemqq C++ operator precedence and keywords
+gemqq how do I update git submodules in parent
+gemqq --pro "Analyze the subtext of Roy's final speech in Blade Runner"
+```
+
+> **Note:** Prompts do not require quotes unless they contain special shell characters like `?`, `*`, `&`, `;`, or `|`. If your prompt includes these, you should either quote it or escape the characters.
+
+## Testing
+
+The project includes automated integration and unit tests using [Vitest](https://vitest.dev/).
+
+```bash
+npm test
+```
+
+## Dependencies
+
+- [Gemini CLI](https://github.com/google/gemini-cli)
+- [Glow](https://github.com/charmbracelet/glow) (for markdown rendering)

package/index.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+
+/**
+ * Copyright (c) 2026 Charles McBrian
+ * Licensed under the MIT License. See LICENSE file in the project root for full license information.
+ */
+
+import { program } from 'commander';
+import ora from 'ora';
+import { execa } from 'execa';
+import clipboardy from 'clipboardy';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import { tmpdir } from 'os';
+import { spawnSync, spawn } from 'child_process';
+
+const __filename = new URL(import.meta.url).pathname;
+const __dirname = path.dirname(__filename);
+
+// Read version from package.json
+const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
+
+// Helper to check command existence
+function commandExists(cmd) {
+  try {
+    spawnSync(cmd, ['--version'], { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+const hasGlow = commandExists('glow');
+const hasGemini = commandExists('gemini');
+
+program
+  .name('gemqq')
+  .description("Gemini Quick Question is a one-shot wrapper for gemini-cli featuring interactive editor support, markdown rendering in terminal, and real-time token usage statistics. gemqq does not have memory nor context, it simply answers your 'quick questions' quickly.")
+  .version(pkg.version)
+  .argument('[prompt...]', 'Prompt for the model')
+  .option('-e, --edit', 'Open prompt in default editor')
+  .option('-r, --raw', 'Output raw text (disable markdown rendering)')
+  .option('-c, --copy', 'Copy response to system clipboard')
+  .option('-m, --model <name>', 'Specify a custom model')
+  .option('--style <name>', 'Specify a glow style (e.g., auto, dark, light)', 'auto')
+  .option('--no-stats', 'Do not show token usage statistics')
+  .option('--project', 'Enable full project workspace context (may send more data)')
+  .option('--pro', 'Use gemini-3-pro-preview model')
+  .option('--flash', 'Use gemini-3-flash-preview model (Default)')
+  .option('--debug', 'Enable debug mode')
+  .addHelpText('after', `
+Examples:
+  gemqq difference between gemini 3.0, 3.1. make a table
+  cat file.txt | gemqq summarize this
+  gemqq -e --pro
+  gemqq C++ operator precedence and keywords
+  gemqq how do I update git submodules in parent
+  gemqq --pro "Analyze the subtext of Roy's final speech in Blade Runner"
+`)
+  .action(async (promptParts, options) => {
+    let currentTempDir = null;
+    let currentSpinner = null;
+    const isTest = process.env.NODE_ENV === 'test';
+
+    const cleanup = () => {
+      if (currentSpinner && !isTest) {
+        currentSpinner.stop();
+      }
+      if (currentTempDir && fs.existsSync(currentTempDir)) {
+        try {
+          fs.rmSync(currentTempDir, { recursive: true, force: true });
+        } catch (e) {}
+      }
+    };
+
+    const signalHandler = () => {
+      cleanup();
+      process.exit(130);
+    };
+
+    process.on('SIGINT', signalHandler);
+    process.on('SIGTERM', signalHandler);
+
+    if (!hasGemini) {
+      cleanup();
+      process.off('SIGINT', signalHandler);
+      process.off('SIGTERM', signalHandler);
+      console.error(chalk.bold('Error:') + " 'gemini' CLI not found.");
+      console.error("Please install it using npm:\n");
+      console.error(chalk.bold("  npm install -g @google/gemini-cli\n"));
+      process.exit(1);
+    }
+
+    let initialPrompt = promptParts.join(' ');
+    let pipedInput = '';
+
+    if (!process.stdin.isTTY && (process.env.NODE_ENV !== 'test' || process.env.HAS_PIPED_INPUT)) {
+      // Read from stdin
+      const chunks = [];
+      try {
+        for await (const chunk of process.stdin) {
+          chunks.push(chunk);
+        }
+        pipedInput = Buffer.concat(chunks).toString();
+      } catch (e) {
+        if (options.debug) console.error(chalk.red('[DEBUG] Stdin read error:'), e);
+      }
+    }
+
+    if (!initialPrompt && !pipedInput && !options.edit) {
+      program.help();
+      return;
+    }
+
+    let fullPrompt = initialPrompt;
+    if (pipedInput) {
+      if (fullPrompt) {
+        fullPrompt = `${fullPrompt}
+
+---
+${pipedInput}`;
+      } else {
+        fullPrompt = pipedInput;
+      }
+    }
+
+    if (options.edit) {
+      const tmpFile = path.join(tmpdir(), `gemqq-prompt-${Date.now()}.txt`);
+      fs.writeFileSync(tmpFile, fullPrompt || '');
+      
+      const editor = process.env.EDITOR || process.env.VISUAL || 'nano';
+      spawnSync(editor, [tmpFile], { stdio: 'inherit' });
+      
+      const editedPrompt = fs.readFileSync(tmpFile, 'utf8').trim();
+      if (editedPrompt !== (fullPrompt || '').trim()) {
+        console.error(chalk.gray(`--- Updated Prompt ---
+${editedPrompt}
+----------------------
+`));
+      }
+      fullPrompt = editedPrompt;
+      fs.unlinkSync(tmpFile);
+    } else {
+      if (fullPrompt) {
+        fullPrompt = `${fullPrompt}. Do not tell me what you are doing, only provide the answer.`;
+      }
+    }
+
+    if (!fullPrompt && !options.edit) {
+      program.help();
+      return;
+    }
+
+    const allowedTools = ['*'];
+
+    const model = options.model || (options.pro ? 'gemini-3-pro-preview' : 'gemini-3-flash-preview');
+    
+    const args = ['-s', '--allowed-tools', JSON.stringify(allowedTools), '--model', model, '--output-format', 'json'];
+    if (options.debug) args.push('-d');
+    args.push(fullPrompt);
+
+    if (options.debug) {
+      console.error(chalk.bold('[DEBUG] Executing:') + ` gemini ${args.map(a => `'${a}'`).join(' ')}`);
+    }
+
+    currentSpinner = isTest ? { start: () => currentSpinner, stop: () => {} } : ora('Gemini is thinking...').start();
+    const startTime = Date.now();
+
+    let sysPromptFile = null;
+    if (!options.project) {
+      try {
+        currentTempDir = fs.mkdtempSync(path.join(tmpdir(), 'gemqq-run-'));
+        sysPromptFile = path.join(currentTempDir, `gemqq-sysprompt-${Date.now()}.md`);
+        fs.writeFileSync(sysPromptFile, 'You are a helpful AI assistant. Answer the user\'s prompt concisely. Do not tell me what you are doing. Do not use this directory or any local context. Do not upload any local context.');
+      } catch (e) {
+        if (options.debug) console.error(chalk.red('[DEBUG] Failed to create isolation directory:'), e);
+      }
+    }
+
+    try {
+      const execEnv = { 
+        ...process.env, 
+        FORCE_COLOR: 'true'
+      };
+      
+      // Apply the system prompt override to bypass workspace snapshotting
+      if (sysPromptFile) {
+        execEnv.GEMINI_SYSTEM_MD = sysPromptFile;
+      }
+
+      const { stdout, stderr } = await execa('gemini', args, {
+        env: execEnv,
+        cwd: currentTempDir || process.cwd()
+      });
+
+      cleanup();
+
+      if (stderr) {
+        const filteredStderr = stderr
+          .split('\n')
+          .filter(line => !line.match(/Loaded cached credentials|Hook registry initialized|Error executing tool/))
+          .join('\n');
+        if (filteredStderr) console.error(filteredStderr);
+      }
+
+      let modelOutput = stdout;
+      let statsString = '';
+
+      try {
+        const result = JSON.parse(stdout);
+        modelOutput = result.response || '';
+        
+        if (result.stats && result.stats.models) {
+          let promptTokens = 0;
+          let candidateTokens = 0;
+          let totalTokens = 0;
+          let cachedTokens = 0;
+
+          for (const modelKey in result.stats.models) {
+            const m = result.stats.models[modelKey];
+            if (m.tokens) {
+              promptTokens += m.tokens.prompt || 0;
+              candidateTokens += m.tokens.candidates || 0;
+              totalTokens += m.tokens.total || 0;
+              cachedTokens += m.tokens.cached || 0;
+            }
+          }
+          
+          statsString = `, ${totalTokens} tokens (${promptTokens}i / ${candidateTokens}o`;
+          if (cachedTokens > 0) {
+            statsString += `, ${cachedTokens} cached`;
+          }
+          statsString += ')';
+        }
+      } catch (e) {
+        if (options.debug) {
+          console.error(chalk.red('[DEBUG] Failed to parse JSON output:'), e);
+        }
+      }
+
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+
+      let statusMsg = ` (Done in ${elapsed}s${statsString})`;
+      if (options.copy) {
+        try {
+          await clipboardy.write(modelOutput);
+          statusMsg = ` (Copied to clipboard, ${elapsed}s${statsString})`;
+        } catch (e) {
+          statusMsg = ` (Failed to copy to clipboard, ${elapsed}s${statsString})`;
+        }
+      }
+
+      if (options.stats) {
+        console.error(chalk.gray(statusMsg));
+      }
+
+      if (options.raw || !hasGlow) {
+        process.stdout.write(modelOutput);
+      } else {
+        // Render with glow
+        try {
+          await execa('glow', ['--style', options.style], { 
+            input: modelOutput, 
+            stdout: 'inherit',
+            stderr: 'inherit'
+          });
+        } catch (glowError) {
+          if (options.debug) {
+            console.error(chalk.red('[DEBUG] Glow failed:'), glowError);
+          }
+          process.stdout.write(modelOutput);
+        }
+      }
+    } catch (error) {
+      cleanup();
+
+      if (error.signal === 'SIGINT' || error.signal === 'SIGTERM') {
+        process.exit(130);
+      }
+
+      // Filter stderr similar to bash script
+      const filteredStderr = (error.stderr || '')
+        .split('\n')
+        .filter(line => !line.match(/Loaded cached credentials|Hook registry initialized|Error executing tool/))
+        .join('\n');
+
+      const stderrLower = filteredStderr.toLowerCase();
+      // Check for common authentication error keywords
+      if (stderrLower.includes('login') || stderrLower.includes('authenticate') || stderrLower.includes('credentials')) {
+        console.error(chalk.red('\nAuthentication Error:'));
+        console.error('It appears you are not logged in or your credentials have expired.');
+        console.error('Please run the following command to log in:');
+        console.error(chalk.bold('\n  gemini login\n'));
+        process.exit(1);
+      }
+
+      console.error(chalk.red('\nError calling Gemini CLI:'));
+      console.error(filteredStderr || error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "gemqq",
+  "version": "0.5.8",
+  "description": "Gemini Quick Question is a one-shot CLI wrapper for Google's Gemini, featuring interactive editor support, markdown rendering, and real-time token usage statistics. gemqq does not have memory nor context, it simply answers your 'quick questions' and prompts.",
+  "main": "index.js",
+  "bin": {
+    "gemqq": "index.js"
+  },
+  "type": "module",
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quadrigasoftware/gemqq.git"
+  },
+  "bugs": {
+    "url": "https://github.com/quadrigasoftware/gemqq/issues"
+  },
+  "homepage": "https://github.com/quadrigasoftware/gemqq#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "test": "vitest run"
+  },
+  "keywords": [
+    "gemini",
+    "google-gemini",
+    "cli",
+    "ai",
+    "llm",
+    "wrapper",
+    "markdown",
+    "terminal",
+    "productivity",
+    "developer-tools",
+    "one-shot"
+  ],
+  "author": "Charles McBrian",
+  "license": "MIT",
+  "sideEffects": false,
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.3.0",
+    "commander": "^14.0.3",
+    "execa": "^9.6.1",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
+  }
+}