Open-Source Engineering Agent v1.0.1|Zero External Dependencies • Lip Gloss TUI

TheAISoftwareEngineeringAgentThatLivesin Your Terminal.

Professional-grade Go CLI with modular AI engines, zero-latency filesystem editing, and Lip Gloss TUI rendering. Pure data patches. Zero external dependencies.

$curl -sSL https://raw.githubusercontent.com/Nithwin/windmist/main/scripts/install.sh | bash

Universal curl installation scriptSingle static binary (<18MB) • Zero CGO

Download WindMist v1.0.1 Portal

Explore Documentation

Live Terminal Workflow:

windmist — tty1 — 120x36

Lip Gloss Engine v1.0.1Go 1.25+


 __        __ _             _  __  __ _  ___ _____ 
 \ \      / /(_)_ __   __| ||  \/  (_)/ __|_   _|
  \ \ /\ / / | | '_ \ / _` || |\/| | |\__ \ | |  
   \ V  V /  | | | | | (_| || |  | | |___) || |  
    \_/\_/   |_|_| |_|\__,_||_|  |_|_|____/ |_|

Engine: internal/ai (Gemini 2.5 Pro) Executor: internal/tools/filesystem● Context: 1,024,000 Tokens Available

shadow@workstation:~$windmist chat

CLI ReadyConfig: ~/.config/windmist/config.yaml

Try pressing[y] Approve & Execute Patchabove!

Smart Download & Installation Hub

Get WindMist v1.0.1 for Your OS

Every release is built automatically via GitHub Actions & GoReleaser, ensuring verifiable SHA256 checksums and zero CGO dependencies.

Official Release v1.0.1 on GitHub GitHub Repository

Detected System: linux

Recommended

We highlighted the optimal binary targets below for your architecture. Or switch tabs to download for other platforms.

Linux Binaries & Archives

Pre-compiled by GoReleaser v1.0.1 • Zero dependencies

Linux x86_64 Tarballx86_64 (64-bit AMD/Intel)5.56 MB

curl -sSL https://github.com/Nithwin/windmist/releases/download/v1.0.1/windmist_1.0.1_Linux_x86_64.tar.gz | tar -xz && sudo mv windmist /usr/local/bin/

SHA-256 Checksum:e60c8142d0639eadc390105cb7988beeb83845c76293c797fc12eb4be557fb3f

Linux ARM64 Tarballarm64 / aarch64 (AWS Graviton, Raspberry Pi)5.08 MB

curl -sSL https://github.com/Nithwin/windmist/releases/download/v1.0.1/windmist_1.0.1_Linux_arm64.tar.gz | tar -xz && sudo mv windmist /usr/local/bin/

SHA-256 Checksum:5871c63775e325ee3533814aef9f86f31d33eb8e10672bd93807af74dff3789f

Built-in Self-Uninstallation Guarantee

Zero Leftover Artifacts. Zero Lock-In.

Unlike traditional background agents or bloated GUI apps that leave hidden daemons and registry clutter, WindMist features a self-contained uninstaller. Simply run:

$ windmist uninstall -yClean Removal

Removes /usr/local/bin/windmist binary

Cleans shell completions & symlinks

Optional wipe of ~/.config/windmist/

Zero background daemons left behind

Architectural Superpowers

Engineeredfor Pure Performance & Precision

WindMist combines modular Go design patterns with state-of-the-art terminal rendering and decoupled filesystem transaction engines.

package internal/providers/gemini

Native Gemini Provider & Agent Loop (`internal/providers`)

Built from the ground up for multi-turn software architecture tasks. Features first-class Google Gemini (`gemini-2.5-pro` and `gemini-2.5-flash`) integrations with structured prompt building, system prompt overriding, and dynamic token context tracking up to 1,048,576 tokens.

Select Active Provider Preset:

internal/tools/... (15 atomic tools)

Context Window:1,048,576 Tokens (Dynamic Limit)

Reasoning Strategy:Deep Architectural Synthesis

Structured Output Engine:Enforced JSON & AST Diff Schemas

internal/tools/... (15 atomic tools)

Pure-Data Patch Executor

Zero file corruption guarantees. WindMist decouples diff calculation from disk execution — grouping operations per file into pure-data structures for single read/write operations per file without partial edits or race conditions.

Atomic Transaction FlowLatency: <1.5ms

1. Calculate Multi-Turn Tool AST (`internal/agent`)

2. Validate Target File Checksums & Locks

3. Atomic Single-Pass Disk Write (`Executor`)

package internal/ui/bubbles

Lip Gloss & Bubble Tea UI (`internal/ui/bubbles`)

Say goodbye to unaligned terminal markdown. Features seamless Glamour table rendering, syntax-highlighted code blocks (`JetBrains Mono` compatible), and custom cyclone-themed word-wrapping TUI bubbles (`internal/ui/bubbles`).

Try Lip Gloss TUI Bubble Theme:

╭─ [Bubble: Cyclone-Renderer]WordWrap: ON ──╮

┃ Model Response:pkg/ai/client.go patched

┃ ├─ Added timeout retry logic with exponent backoff

┃ └─ All Lip Gloss borders aligned without layout jitter

cmd/ & Cobra

Professional Go Architecture (`cmd/` & Cobra)

Engineered with Go 1.26 and the `Cobra` CLI framework. Features automated multi-platform GoReleaser CI/CD pipelines, strict unit testing suites, and a absolute zero race-condition guarantee (`go test -race`).

Concurrently Verify Memory Safety:

$ go test -race ./internal/... ok 0.412s (No Data Races)

Tested packages: ai, filesystem, ui, cmd100% thread safety verified

Documentation Portal Preview

Everything You Need to Master WindMist

Explore our comprehensive references on configuring the AI engine, customizing the Lip Gloss TUI themes, and interacting with the atomic filesystem patcher.

Enter Full Documentation Portal

quickstart.sh — Interactive Terminal Session

# 1. Install WindMist CLI universally
curl -sSL https://raw.githubusercontent.com/Nithwin/windmist/main/scripts/install.sh | bash

# 2. Authenticate with your Gemini API Key
windmist auth login --provider gemini --key AIzaSy...

# 3. Initialize interactive agent session in your repository
cd ~/projects/my-go-service
windmist chat --context ./pkg/server/router.go

# 4. Preview and execute a pure-data filesystem patch
windmist diff --staged
windmist apply --yes