whatisgithub

What is zethcode?

zethrise/zethcode — explained in plain English

Analysis updated 2026-05-18

25TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A terminal based AI coding agent, forked from MiMo Code, that edits code, runs commands, and remembers project context.

Mindmap

mindmap
  root((Zeth Code))
    What it does
      Terminal AI agent
      Edits code
      Runs commands
    Agent modes
      Build agent
      Plan agent
      Compose agent
    Features
      Persistent memory
      MCP support
      Provider switching
    Tech stack
      TypeScript
      Bun
      SQLite FTS5

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 an AI coding agent in your terminal that can edit files and run commands directly.

USE CASE 2

Keep persistent project memory, notes, and gotchas searchable across coding sessions.

USE CASE 3

Switch between OpenAI-compatible model providers without leaving the terminal.

USE CASE 4

Use a read-only plan mode to explore and understand a codebase before making changes.

What is it built with?

TypeScriptBunSQLiteMCP

How does it compare?

zethrise/zethcode8thpark/geodeagricidaniel/fablesecondbrain
Stars252525
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencedevelopervibe coderresearcher

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 OpenAI-compatible model provider and API key to actually run agent sessions.

Source code is MIT licensed, but a separate use restrictions document also applies.

So what is it?

Zeth Code is a terminal based AI coding assistant. Instead of a web app or a chat window, it runs directly in your terminal and acts as an agent that can read and edit code, run shell commands, work with Git, and remember useful context about your project across sessions. It is a fork of a project called MiMo Code, which is itself built on an earlier project called OpenCode. The author describes Zeth Code as fixing issues found in MiMo Code and adding new features on top, including Windows release builds and its own zeth command. You install it with npm as a global command, or through platform specific installers for Windows, Linux, and macOS, including downloadable executables, a Debian package, and an AppImage. Once installed, running zeth starts an interactive terminal interface inside your project folder. The tool offers a few different agent modes: a default build agent that can actually execute changes, a plan agent that only reads and analyzes code without editing anything, and a compose agent meant for orchestrating more structured, skill driven workflows. It keeps a persistent memory of your project, including rules, architecture notes, session checkpoints, common fixes, and task progress, searchable locally using SQLite full text search. It connects to OpenAI compatible AI model providers, and lets you switch models and providers from within the terminal interface. It also ships with built in support for MCP servers, a protocol for connecting external context and documentation sources, plus tools for inspecting and trimming how much context is being sent to the model. From the command line you can start the interface, run a single one off prompt, manage the memory store, or scaffold a new connector. The source code is released under the MIT license, though use is also subject to a separate use restrictions document in the repository.

Copy-paste prompts

Prompt 1
Install Zeth Code with npm and start it in my current project folder.
Prompt 2
Use the plan agent to explain the architecture of this repository before I make changes.
Prompt 3
Show me how to add and search project memory notes using zeth memory commands.
Prompt 4
Run a single one-off zeth prompt to refactor this module and explain the change.

Frequently asked questions

What is zethcode?

A terminal based AI coding agent, forked from MiMo Code, that edits code, runs commands, and remembers project context.

What language is zethcode written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, SQLite.

What license does zethcode use?

Source code is MIT licensed, but a separate use restrictions document also applies.

How hard is zethcode to set up?

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

Who is zethcode for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.