░▀▀█░▀█▀
░▄▀░░░█░
░▀▀▀░▀▀▀

A coding agent you can build with.

Use it as-is, or teach it one habit at a time: a command, a tool, a prompt rule, a model preference, or a bit of UI. The goal is dependable agent work you can understand and change.

Zi is developed as a dependable coding-agent building block with an opinionated reference terminal client. Start with the Zi manual, then use the focused guides for the CLI, extensions, subagents, and RPC.

Install

npm install -g @with-zi/zi

Getting Started

Read the same manual locally in docs/ or online at https://withzi.dev/man/. For process composition, see the CLI contract and versioned RPC protocol.

Zi ships version-matched documentation and copyable examples beside the native executable. Ask Zi to build a skill, extension, or subagent profile and it can read those local files before implementing.

Build from source

git clone https://github.com/igorsheg/zi
cd zi
bun install --frozen-lockfile
bun run build
./dist/zi --version

Acknowledgments

First and foremost, thank you to Mario Zechner for teaching by example how to design systems, harnesses, and agents.

Thank you to OpenTUI for showing what terminal and TUI software can feel like.

Thank you to Mitchell Hashimoto for articulating The Building Block Economy.

License

MIT