Skip to content

tallesborges/zdx

Repository files navigation

zdx

Zdx Hero

Ask DeepWiki Built With Ratatui

Zdx is a coding agent built in Rust. I made it mainly to avoid using multiple CLIs and to have customization freedom, so I try to add the best features from them into a single CLI.

I added the Telegram bot so I can control it while away from the computer. I don't have plans to add providers other than Telegram.

Zdx demo

Disclaimer

  • YOLO mode: the agent can access your files and tools. It can make destructive changes. Use at your own risk.
  • Early-stage: expect breaking changes and unstable behavior while the project evolves.

Quickstart

Install

Shell (macOS/Linux):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/tallesborges/zdx/releases/latest/download/zdx-installer.sh | sh

Homebrew:

brew install tallesborges/zdx/zdx

From source:

git clone https://github.com/tallesborges/zdx.git
cd zdx
cargo install --path crates/zdx-cli

Run

zdx --help
zdx

Exec mode

zdx exec -p "hello"

Telegram bot

zdx bot

First time? Run zdx config init and set your provider + telegram keys.

Features

  • Providers: Anthropic, Gemini, OpenAI, OpenRouter, Mistral, Moonshot, MiMo, StepFun
  • Interactive TUI with streaming markdown, syntax highlighting, and tables
  • Exec mode for scripts and automation
  • Extended thinking + token usage with pricing
  • Command palette, file picker (@), bash commands ($cmd)
  • Session persistence + timeline + thread switching
  • Project context via AGENTS.md + skills via SKILL.md
  • Telegram bot — interact via Telegram (zdx bot)

Provider support

  • Anthropic: API key + OAuth (Claude CLI, subscription)
  • Gemini: API key + OAuth (Gemini CLI, subscription)
  • OpenAI: API key + OAuth (Codex, subscription)
  • OpenRouter: API key
  • Mistral: API key
  • Moonshot (Kimi): API key
  • MiMo (Xiaomi): API key
  • StepFun: API key

Inspiration

This project was inspired by several excellent tools in the agentic coding space:

  • pi-mono — AI-powered coding agent with terminal UI and SDK for AI-assisted development
  • codex — OpenAI's open-source terminal-based agentic coding assistant
  • AMP — Great UX inspiration for agentic coding workflows
  • opencode — Open-source AI coding agent with TUI, desktop app, and VS Code extension

License

MIT

About

An agentic CLI, built in rust.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages