Pragmatic AI - Google Apps Script Coding Companion!

About

Pragmatic AI brings Google’s Gemini models into the Apps Script editor so you can review, enhance, and generate code without leaving your flow. A focused side panel lets you choose context (Editor/All/No Code), include execution logs when needed, and tune model parameters and then deliver clean, well-structured suggestions you can paste back into your project. All requests to the Gemini API are made client-side, and your code never leaves your browser except for the call to the Gemini API. The assistant activates on pages under https://script.google.com/. The Gemini API Key is stored locally inside the Chrome browser local storage, safe and secure. 

============================================
Why Pragmatic AI?

Built for Apps Script: 
Knows the editor context and optionally pulls in the execution log to ground responses.

Real engineering tasks: 
Code Review for fast audits; Enhance to refactor, optimize, add comments/tests; Ask Gemini for custom prompts.

Gemini controls: 
Switch among current Gemini 2.5/2.0 text models and adjust temperature, top-p, top-k, and max tokens.

Clean UI:  
Sections for Code Context, Actions, Ask Gemini, and Gemini Response with copy/clear and scrollable output.

Theme switch:  
One-tap day/night mode for bright labs or late-night debugging.

Your Privacy is Protected:  
The extension stores your Gemini API key locally. This key, along with your code, is transmitted exclusively to the Gemini API for completion requests and is not shared with any other external parties.

============================================
What you can do

Review code — Identify smells, risky patterns, missing returns, and better practices for Apps Script services.

Enhance code — Request refactors (async patterns, batching, caching), add comments, or convert snippets to structured libs.

Ask Gemini — Describe tasks (e.g., “Create a Gmail to Sheets importer with batching & exponential backoff”) and generate ready-to-adapt code.

Control context — Use Editor code, All code, or No code. Include Execution log to help Gemini reproduce issues.

Tune responses — Pick the model and set decoding sliders for the right balance of creativity vs. determinism. We recommend using "Gemini 2.5 Flash Lite" for great quality of responses. Use the Reset button to reset the values to their defaults. 

============================================
How it works

Open the Google Apps Script editor and launch the Pragmatic AI side panel.

Paste your Gemini API key once (saved locally) in the API Settings and Usage section. You can get your Gemini key from  https://aistudio.google.com/apikey

Choose Code Context and (optionally) tick Execution log.

Click Review code, Enhance code, or type your prompt in Ask Gemini and hit Send.

Copy results from Gemini Response into your project.

============================================
Privacy & security

API key: stored locally; not uploaded to external servers by the extension.

Data use: Code and prompts are sent to Gemini only when you request a completion.

Open settings: Clear or replace your API key anytime in API Settings and Usage.

============================================