A fast, beautiful agentic coding assistant.
ZDX is a TUI coding agent that helps you as a developer be productive. The vision is to be a faster, lightweight coding agent.
Built because I needed something:
- Productive — shortcuts, command palette, everything at my fingertips
- Fast and lightweight — can spawn multiple instances when needed
- Pleasant to use — beautiful and elegant, for all-day use
- Anthropic provider with API key or OAuth authentication (Claude Pro/Max)
- OpenAI provider with API key (OpenAI API) or OAuth (Codex Subscription)
- OpenRouter provider with API key
- Gemini provider with API key or subscription (Cloud Code Assist)
- Interactive TUI with streaming markdown, syntax highlighting, and table support
- Exec mode — non-interactive mode for scripts and automation
- Extended thinking with configurable levels and block display
- Command palette overlay (Ctrl+P or
/) — model picker, thinking level, and more - File picker — type
@to browse and insert project files (respects .gitignore) - Large paste placeholders — pastes over 1000 chars display as
[Pasted Content N chars #1], expand on submit; press Space on placeholder to expand - Bash commands — type
$<command>to execute bash commands directly (e.g.,$ls -la,$git status) - Text selection — click and drag to select, double-click selects a word, auto-copies to clipboard
- Token usage display with pricing
- Session persistence — resume or switch between previous threads (filtered by workspace, Ctrl+T to show all)
- Timeline overlay — jump to turns and fork from any message
- Project context via
AGENTS.mdfiles (recursively loaded from parent directories) - Skills via
SKILL.md(discoverable skill instructions with metadata) - Telegram bot — interact with ZDX via Telegram DMs (
zdx-bot)
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
MIT