Zeth Code

Zeth Code is a fork of MiMo Code, adapted under the ZethRise namespace with Windows release builds and the zeth command. It keeps the terminal-first agent workflow: read and edit code, run commands, manage Git, preserve project memory across sessions, and connect to OpenAI-compatible model providers.

MiMo Code is built as a fork of OpenCode. Zeth Code Fixes the issues with MiMo Code and added a few new features!

What's New in v1.0.6

• Added GPT-5.6 Luna, Terra, and Sol model aliases for OpenAI and ChatGPT OAuth users.
• Improved TUI delivery reliability, session-state persistence, worktree error recovery, source-control reporting, and Windows console cleanup.

Quick Start

Install with npm:

npm install -g @zethrise/cli
zeth

Install on Windows with PowerShell:

irm https://raw.githubusercontent.com/ZethRise/ZethCode/master/install.ps1 | iex

Install on Linux/macOS with curl:

curl -fsSL https://raw.githubusercontent.com/ZethRise/ZethCode/master/scripts/install | bash

Or download a standalone Windows executable from the releases page:

| Build | Use when | | ----------------------------------- | ------------------------------------------------ | | zethcode-windows-x64.exe | Most modern Intel/AMD Windows PCs | | zethcode-windows-x64-baseline.exe | Older x64 CPUs without newer instruction support | | zethcode-windows-arm64.exe | Windows on ARM devices |

Run it from a terminal inside your project:

.\zethcode-windows-x64.exe

Linux

Download a .deb or .AppImage from the releases page:

| Build | Use when | | ---------------------------------------- | ----------------------------------------------- | | zethcode-linux-x64.deb / .AppImage | Most modern Intel/AMD Linux PCs | | zethcode-linux-arm64.deb / .AppImage | Linux on ARM (e.g. Raspberry Pi 5, ARM servers) |

Install the .deb:

sudo dpkg -i zethcode-linux-x64.deb
zeth

Or run the .AppImage (no root needed):

chmod +x zethcode-linux-x64.AppImage
./zethcode-linux-x64.AppImage

For development from source:

git clone https://github.com/ZethRise/ZethCode.git
cd ZethCode
bun install
bun dev

Core Features

Terminal-Native TUI

Zeth Code runs in the terminal and is built for coding sessions where the agent needs real project context, file access, shell access, and Git awareness.

Multiple Agents

| Agent | Description | | --------- | ------------------------------------------------------------ | | build | Default development agent with tool execution | | plan | Read-only analysis mode for exploration and architecture | | compose | Orchestration mode for skill-driven and structured workflows |

Persistent Memory

Project memory keeps useful context across sessions:

• Project rules and architecture notes
• Session checkpoints
• Gotchas and repeated fixes
• Task progress
• Searchable local context backed by SQLite FTS5
• Health checks, reindexing, and a TUI memory trace view

Local Development Tools

Agents can inspect files, edit code, run commands, work with Git state, and use project context directly from the current workspace.

Provider Support

Use OpenAI-compatible providers and imported model configurations. Zeth Code keeps provider and model selection in the TUI so you can switch workflows without leaving the terminal.

Built-in MCP Servers

Zeth Code includes built-in project memory MCP support and Context7 MCP support for documentation-aware coding sessions.

Context Controls

Use the TUI context tools to inspect token usage, review attached context, and trim stale files or messages without restarting the session.

Workflows and Skills

Zeth Code includes the workflow and skill architecture inherited from MiMo Code, including structured development flows, compose-style orchestration, and reusable task instructions.

CLI Usage

# Start the TUI in the current workspace
zeth

# Run a single prompt
zeth run "refactor this module and explain the change"

# Start without a local project folder
zeth --no-project
zeth run --no-project "research this API and make a plan"

# Manage memory
zeth memory list
zeth memory add "prefer Bun APIs in this repository"
zeth memory search "Bun APIs"
zeth memory health
zeth memory reindex

# Scaffold a connector
zeth connector create my-connector

Development

bun install              # Install dependencies
bun dev                  # Run development TUI
bun turbo typecheck      # Type check all packages

Build a local single-target executable:

bun run --cwd packages/opencode script/build.ts --single

Release builds are generated by .github/workflows/build.yml, including Windows .exe files and Linux .deb/.AppImage files.

Relationship to MiMo Code

Zeth Code is a fork of XiaomiMiMo/MiMo-Code. Credit goes to the MiMo Code project for the core terminal agent system, persistent memory architecture, workflows, skills, provider support, and TUI foundation.

License

Source code is licensed under the MIT License.

Use of this project is also subject to the Use Restrictions.