What GridOS does
Traditional spreadsheets put all the burden on you: you write every formula, lay out every row, and debug every#DIV/0! yourself. GridOS flips that. You describe intent in the chat composer; the AI proposes structured edits; you review a preview and click Apply or Dismiss. The kernel enforces deterministic rules — collision checking, formula validation, cell locking — so the AI can’t silently corrupt data you care about.
Every AI write goes through a preview step before it touches the sheet, and a pre-apply guard blocks formulas whose inputs are empty before they can produce errors.
Key features
Formula synthesis
Natural-language prompts become executable grid formulas such as
=MINUS(C3,D3) or =AVERAGE(B2:B13). GridOS routes your message to a finance-specialized or general-purpose agent automatically.Multi-provider LLMs
Pick between Google Gemini, Anthropic Claude, Groq, and OpenRouter models from the chat composer. Switch models per-request; the provider is resolved at call time.
Persistent reasoning history
Every agent preview card is frozen in the chat thread after Apply or Dismiss with colored outcome badges —
APPLIED, DISMISSED, SUPERSEDED — so the full audit trail stays visible.Chain mode
The agent auto-applies each step, observes formula results, and continues until the plan is complete — no manual prompting required for multi-step builds.
Collision resolution
The kernel shifts data to avoid overwriting occupied or locked cells. Mark any range read-only and the AI cannot touch it.
Preset templates
Built-in starters — Simple DCF, Monthly Budget, Break-Even, Loan Amortization, Income Statement — plus user-saved templates with origin badges.
User macros
The agent can propose reusable formulas like
=MARGIN(A,B) composed from primitives. Approved macros become callable from any cell.Chart overlays
In-app charts render via Chart.js and are upserted by title so the agent can resize or retype them in place without duplicating.
Bring-your-own-key model
GridOS never bundles an API key. You supply one key from any supported provider and the full model catalog for that provider becomes available immediately. You can configure multiple providers at once and switch between their models per-request in the chat composer dropdown.Google Gemini
Free tier at Google AI Studio. Flash Lite has ~250K TPM free — the most headroom of any free option. Recommended default.
Anthropic Claude
Haiku, Sonnet, and Opus variants. Requires an Anthropic Console account with credits. Best JSON reliability.
Groq
Free with no credit card. Fastest inference (~1000 tps). Free-tier TPM is tight — pair with chain mode, or upgrade to Dev Tier for multi-intent builds.
OpenRouter
Free access to Hermes 3 Llama 405B and Llama 3.3 70B. Good fallback when other providers throttle.
data/api_keys.json, which is gitignored, so they never leave your machine and never appear in source control.
Landing-page hero prompt
When you open GridOS you land on a page with a hero prompt field. Describe the workbook you want to build, press Enter, and GridOS clears the kernel, routes you to the workbook view, and auto-submits the prompt — you arrive on a sheet that is already building itself.Next steps
Quickstart
Clone the repo, install dependencies, run the server, and build your first workbook in under five minutes.
Connect API keys
Add keys for Gemini, Claude, Groq, or OpenRouter via the in-app settings panel or a
.env file.