WrongStack
An AI coding agent that reads your code, edits files, runs commands, and reasons through bugs — across a terminal REPL, a full-screen TUI, and a browser UI, whi
What is WrongStack?
An AI coding agent that reads your code, edits files, runs commands, and reasons through bugs — across a terminal REPL, a full-screen TUI, and a browser UI, while you keep your hand on every permission.
Overview of WrongStack
What it is
WrongStack is a free, open-source AI coding agent. It is a single, self-contained binary (no Node.js required) that can read code, edit files, run commands, and reason through bugs. It operates across multiple interfaces: a terminal REPL, a full-screen TUI, a browser UI, and others. It is not a wrapper or orchestration layer around another tool; it is a complete agent built from scratch, with its own kernel, provider transports, tool executor, permission policy, memory system, and multi-agent runtime.
Key features
- SAGE memory: Code-anchored long-term memory stored in SQLite/FTS5, linked to files, symbols, commands, and commits, and re-verified as they change.
- Multi-agent coordination: A Director can split work across specialist agents; a project mailbox links every agent, client, and worktree.
- Goal verification with Kanban: The
/goalcommand loops until a locked contract passes; the Brain evaluates risky decisions; Kanban cards reach Done only when their criteria pass. - Seven surfaces, one engine: REPL, TUI, WebUI, SimpleUI, VibeUI, Desktop, and cross-machine HQ share the same sessions and memory.
- Model flexibility: Supports API keys, subscription sign-in, a models.dev provider catalog, local model presets (Ollama, vLLM, LM Studio), and per-role routing with fallback chains.
- Permission and security: Encrypted secrets and a policy on every tool call; opt-in project-root containment that cannot be turned off by YOLO or repo-committed config; Chimera reviews diffs.
Use cases
WrongStack is designed for developers who want an AI coding agent that understands and remembers their specific codebase over time. It can be used for debugging, refactoring, running commands, managing multi-file edits, and conducting research briefs that preserve API and version evidence. The agent can work on a single machine or across machines via HQ. Its permission system allows fine-grained control, making it suitable for both individual development and projects that require strict security boundaries.
Getting started
To install on macOS or Linux, run:bashcurl -fsSL https://wrongstack.com/install.sh | shTo install on Windows, run:powershellirm https://wrongstack.com/install.ps1 | iexFor detailed setup and usage, see the repository README.
License and pricing
WrongStack is free, open source, and MIT licensed.
Based on the project's public README and repository metadata.