explaingit

gi-dellav/zerostack

Analysis updated 2026-05-18

459RustAudience · developerComplexity · 2/5Setup · easy

TLDR

A small, fast terminal coding agent written in Rust that connects to multiple AI providers and uses a fraction of the memory of comparable JavaScript-based agents.

Mindmap

mindmap
  root((zerostack))
    What it does
      Terminal coding agent
      Reads writes runs code
      Inspired by pi and opencode
    Tech stack
      Rust
      Cargo
      Terminal UI
    Use cases
      Low memory coding assistant
      Multi provider AI coding
      Long running task loops
    Audience
      Developers
      Terminal users
      Performance focused engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a lightweight AI coding agent in the terminal that uses far less memory than JavaScript based alternatives.

USE CASE 2

Switch between built in prompt modes like coding, planning, review, and debug to match the current task.

USE CASE 3

Set fine grained permission rules controlling which files and commands the agent can touch without asking.

USE CASE 4

Run long, multi step coding tasks automatically using the built in loop system that plans, codes, and tests until done.

What is it built with?

RustCargo

How does it compare?

gi-dellav/zerostackopenabdev/openablightonai/next-plaid
Stars459480422
LanguageRustRustRust
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an API key from a supported provider such as OpenRouter or Anthropic before it can run.

In plain English

zerostack is a lightweight coding agent that runs in the terminal, written in the Rust programming language. It is designed to be small and fast, and the project describes itself as inspired by two other coding agent tools called pi and opencode. A coding agent is a program that can read, write, and run code on your behalf while you describe what you want in plain language. The tool supports several different AI providers, including OpenRouter, OpenAI, Anthropic, Gemini, and Ollama, plus custom providers you configure yourself. It comes with the standard set of tools that coding agents typically use, such as reading and writing files or running commands. A permission system controls what the agent is allowed to do without asking first, ranging from a restrictive mode where nearly everything needs approval, to a fully automatic mode where all actions are approved without prompting. Sessions can be saved, resumed, and browsed later, and the agent automatically shortens old conversation history so it stays within the model's context limit. zerostack includes a set of built in prompt modes that change how the agent behaves for different tasks, such as a coding mode, a planning only mode, a code review mode, a debugging mode, and a read only mode for just asking questions. Users can switch between these with a command, or write their own custom prompts as text files. The project also supports connecting external tools through something called MCP, integrates a search tool for fetching and searching the web, and can move between different Git worktrees during a session. According to the README, zerostack is notably smaller and lighter than comparable agents written in JavaScript, using roughly 8 to 12 megabytes of memory compared to around 300 megabytes for some alternatives. It is installed using Rust's package manager, Cargo, or by downloading a pre-built binary from GitHub Releases. Windows support exists but the author notes it has not been tested.

Copy-paste prompts

Prompt 1
Install zerostack with Cargo and connect it to my OpenRouter API key for an interactive session.
Prompt 2
Configure zerostack's permission system so file writes need approval but reading and git log commands are automatic.
Prompt 3
Show me how to switch zerostack from coding mode to plan mode using the /prompt command.
Prompt 4
Set up a headless zerostack loop that refactors my API and runs cargo test after each iteration.

Frequently asked questions

What is zerostack?

A small, fast terminal coding agent written in Rust that connects to multiple AI providers and uses a fraction of the memory of comparable JavaScript-based agents.

What language is zerostack written in?

Mainly Rust. The stack also includes Rust, Cargo.

How hard is zerostack to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is zerostack for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.