Terminal-native AI coding assistant for local developer workflows.
English | فارسی
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!
- 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.
Install with npm:
npm install -g @zethrise/cli
zethInstall on Windows with PowerShell:
irm https://raw.githubusercontent.com/ZethRise/ZethCode/master/install.ps1 | iexInstall on Linux/macOS with curl:
curl -fsSL https://raw.githubusercontent.com/ZethRise/ZethCode/master/scripts/install | bashOr 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.exeDownload 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
zethOr run the .AppImage (no root needed):
chmod +x zethcode-linux-x64.AppImage
./zethcode-linux-x64.AppImageFor development from source:
git clone https://github.com/ZethRise/ZethCode.git
cd ZethCode
bun install
bun devZeth 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.
| 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 |
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
Agents can inspect files, edit code, run commands, work with Git state, and use project context directly from the current workspace.
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.
Zeth Code includes built-in project memory MCP support and Context7 MCP support for documentation-aware coding sessions.
Use the TUI context tools to inspect token usage, review attached context, and trim stale files or messages without restarting the session.
Zeth Code includes the workflow and skill architecture inherited from MiMo Code, including structured development flows, compose-style orchestration, and reusable task instructions.
# 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-connectorbun install # Install dependencies
bun dev # Run development TUI
bun turbo typecheck # Type check all packagesBuild a local single-target executable:
bun run --cwd packages/opencode script/build.ts --singleRelease builds are generated by .github/workflows/build.yml, including Windows .exe files and Linux .deb/.AppImage files.
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.
Source code is licensed under the MIT License.
Use of this project is also subject to the Use Restrictions.