A High-Performance Multi-Agent Coding Engine with Autonomous Planning and Reflection
Installation • Usage • Documentation • Contributing
Zene combines "Zen" and "Engine".
- Zen: Minimalist, focused, and distraction-free. We avoid bloated frameworks to provide a pure coding flow.
- Engine: High-performance, reliable, and powerful. Written in Rust to be the robust core driving your intelligent agents.
We believe in:
- Single Binary: No complex runtime dependencies.
- Explicit Configuration: No magic, just standard environment variables.
- Plan: Generates a DAG of tasks.
- Execute: Runs real commands in your shell (Async/Non-blocking).
- Reflect: Analyzes stdout/stderr and file changes.
- Async Native: Built on
tokio, Zene is 100% non-blocking and ready for high-concurrency web integration. - Streaming Output: Real-time "Thought Delta" events allow for immersive, typewriter-style UI experiences.
- Workspace Awareness: Real-time
FileStateChangedevents enable IDE-like file tree updates in frontend integrations. - Self-Healing: The Reflector loop automatically fixes linting errors and failed tests.
- Model Agnostic: Built on
llm-connector, supporting OpenAI, Anthropic, DeepSeek, Google Gemini, and more. - Context Aware: Uses
tree-sitterfor syntax-level code analysis and efficient file walking to understand project structure. - Safe Execution: Features an OODA (Observe-Orient-Decide-Act) loop with "Dry Run" capabilities and atomic file operations.
- JSON-RPC Server: Functions as a standard server, exposing its capabilities to IDEs and other tools.
- Blazing Fast: Written in pure Rust with async I/O.
Download the latest release for your platform from the Releases Page.
cargo install zenegit clone https://github.com/lipish/zene.git
cd zene
cargo build --releaseZene prioritizes DeepSeek but supports OpenAI as a fallback.
Execute a single instruction directly from the command line.
# Create a file
zene run "Create a hello.txt with content 'Hello Zene'"
# Refactor code (Context aware)
zene run "Refactor src/main.rs to extract the CLI logic into a separate module"
# Fetch Web Content
zene run "Fetch https://example.com and summarize it in README.md"Start Zene as a JSON-RPC server (over Stdio). This mode supports persistent sessions and multi-turn conversations.
zene serverRequest (Start Session):
{
"jsonrpc": "2.0",
"method": "agent.run",
"params": {
"instruction": "Analyze the project structure",
"session_id": "my-session-001"
},
"id": 1
}Sessions are automatically persisted to ~/.zene/sessions/<session_id>.json.
Detailed documentation is available at zene.run (or in the www/ directory):
Contributions are welcome! Please read our architecture documentation to understand the core philosophy before submitting PRs.
MIT
