Teaspoon IDE — AI Coding Agent IDE

Highlights

All-in-one File explorer, Monaco editor, AI chat, Git, and a true TTY terminal in a single app. No more jumping between tools — development happens entirely inside Teaspoon IDE.
Autonomous agent loop The AI lists, reads, searches, and edits files across multiple steps, feeding results back until the task is done — then summarizes what it did in plain language. With Ollama, replies stream token by token, and each message shows the model used and its response time.
Safe write control Writes are confined to the project root. File creation, diff edits, and command execution all go through approval dialogs, and checkpoint/rollback lets you undo only the AI's changes.
Context optimization Sends the file tree first; the AI fetches file contents on demand via GREP / READ_FILE. Dramatically reduces token usage per message.
Keys stay yours Works through a LiteLLM proxy so real API keys never live on the client. Ollama support enables fully offline operation. File paths sent to the AI are project-relative, so absolute paths containing your OS user name never leak to the cloud.
A free BYOK endpoint Teaspoon IDE itself is free. It follows a BYOK (Bring Your Own Key) model — you supply your own Gemini API key, so there is no subscription fee and no markup on API usage. You simply pay Google directly for what you use.
Low-cost — or completely free Focused on Gemini's inexpensive Flash models, so pay-as-you-go costs stay minimal (Gemini 3.8 Flash is offered at an introductory price, half the standard rate, through the end of 2026). Or choose Ollama with a local LLM like Gemma 4 for a completely free, offline, secure AI coding agent IDE that never sends your code off your machine.
Ready for teams (v0.5.0+) Flip on "Require organization sign-in" for centrally managed use: members just sign in with an issued account — no API keys to hand out. Remaining budget shows as a percentage, and usable models are governed by the organization. See Teaspoon IDE Organization.
Production-grade polish Git covers stage/commit/push/pull plus GUI dialogs for cloning, remotes, initial commits, upstream-tracked pushes, and user config. Diff view, project-wide search, Markdown preview and PDF export, and seven themes including Organic Light are built in. Ships as a portable exe and a .deb package.

Tech Stack

Electron / React / TypeScript / Monaco Editor / Gemini API & Ollama / Vite

License: FSL-1.1-MIT (source-available — see "About the License" below)

For a real usage example (the AI building an Othello game end to end), see the Teaspoon IDE Example page. For setup instructions (Gemini API key, Ollama local LLMs, OpenAI-compatible APIs, etc.), see the Teaspoon IDE Settings Guide. For centrally managed deployments (budget caps, model governance), see Teaspoon IDE Organization.

See the CHANGELOG for what's new in each release.

Feedback and bug reports are welcome via GitHub Issues.

About the License (FSL-1.1-MIT)

Teaspoon IDE is distributed under FSL-1.1-MIT (Functional Source License), a "source-available" license. It differs slightly from the MIT open-source license, but ordinary use is free and unrestricted.

You are free to

Download and use it — for personal and business use alike
Modify and customize the source code to your liking
Deploy it as an internal tool within your company
Fork and redistribute it, as long as the license terms and copyright notices are kept

You may not

Use it as a commercial product or service that competes with Teaspoon IDE — e.g. selling it as-is, selling a renamed clone, or offering it as a paid service
Remove the license terms or copyright notices when redistributing
Use the "Teaspoon IDE" name or trademarks for any purpose other than identifying its origin

Each release automatically converts to the MIT license two years after publication, after which even commercial use is fully permitted. See the LICENSE file in the repository for details.