winq is a minimalist TUI agent that lives entirely in your terminal.
Describe what you need in plain English (or German, or Chinese) — winq figures out the exact PowerShell command chain, shows it to you with a clear explanation, and executes it on your confirmation.

Named after Q from Star Trek — the omnipotent being of the Q Continuum who can answer any question and reshape reality with a thought. winq brings that same effortlessness to your Windows command line.

No cloud. No account. No data leaving your machine. Just you, your terminal, and a local LLM.

1. Download winq-windows-amd64.exe from the Releases page
2. Open Windows Terminal or PowerShell 7 and run it:

.\winq-windows-amd64.exe

3. Type /setup inside the app to install system-wide — winq copies itself to
   %LOCALAPPDATA%\Programs\winq\winq.exe and registers it in your user PATH.
   Open a new terminal and run winq from anywhere.

Recommended: Windows Terminal or PowerShell 7 for full ANSI color support.
Classic cmd.exe works but colors may be limited.

On first start, winq connects to http://localhost:11434/v1 (Ollama default).
Open /config to change the endpoint — or let winq find your LLM automatically:

1. Type /config and press Enter
2. Navigate to LLM PROFILES → [ + New LLM Profile ]
3. Enter your LLM server's IP address
4. winq scans ports 11434 1234 8080 8000 9081 7860 5000 3000 automatically
5. Select a model from the list — done ✓

> Show me which processes are using the most memory
> List all Windows services that have stopped unexpectedly
> Find files larger than 1 GB modified in the last 7 days
> What's eating my disk space in C:\Users?
> Schedule a daily task to clean up the Temp folder

Any OpenAI-compatible local server works out of the box:

Recommended models: Qwen3, Llama 3.1/3.2, Mistral, DeepSeek-Coder, Gemma 2

Type /config to open the settings editor.

Save multiple LLM endpoints and switch between them instantly.
Mark one as preferred (P) — winq health-checks it on startup and suggests the next available profile if it's unreachable.

Toggle with Shift+Tab from anywhere. The title bar always shows the active mode.

winq saves your entire conversation and LLM context on exit — including tool call history.
Toggle with Alt+S or in /config → SESSIONS. The title bar shows a 💾 SESSION badge when active.

Type / for autocomplete with descriptions.

Requires Go 1.22+. Cross-compile from Linux or build directly on Windows.

# Cross-compile from Linux (produces winq-windows-amd64.exe):
bash build.sh

# Build on Windows:
go build -o winq.exe .

go vet ./...           # static analysis
go build ./...         # compile-check without producing a binary

All files are human-readable JSON / plain text. Delete any of them to reset that component.

win + q — the Q Continuum for Windows.

In Star Trek, Q is an omnipotent entity who knows everything, can do anything, and never needs to look anything up. That's the energy winq brings to your Windows command line: ask it anything about your system, and it handles the rest.

bashq — the Linux sibling.
Same concept, same architecture, same local-LLM philosophy — built for bash and Debian/Ubuntu instead of PowerShell and Windows.

MIT — see LICENSE.