codux  by duxweb

Unified terminal for AI agent development and control

Created 3 months ago
280 stars

Top 92.7% on SourcePulse

GitHubView on GitHub
Project Summary

A native, high-performance terminal for AI agent development, Codux unifies disparate AI coding CLIs into a single, durable workspace. It targets developers managing complex, long-running AI agent tasks across multiple projects, offering enhanced control, session persistence, and secure credential handling to mitigate the chaos of traditional command-line workflows.

How It Works

Built with Rust and GPUI, Codux functions as a control plane for AI coding CLIs. It integrates tools like Codex and Claude Code into a unified, project-aware view, utilizing a worktree-first model for isolated task management. Key features include live agent status, token analytics per project/worktree, local memory injection, and secure, credential-isolated SSH/database access via codux-ssh and codux-db commands. Connectivity is managed through end-to-end encrypted P2P/relay links, enabling seamless control across desktop, mobile, and headless hosts.

Quick Start & Requirements

Installation on macOS is via Homebrew (brew install --cask duxweb/tap/codux); Windows users download an installer. Headless host setup uses a curl script. Prerequisites include macOS 14.0+ or Windows 11 for desktop use. Headless hosts support macOS, Linux, and Windows. Direct download links and mobile app availability (Android APK, iOS App Store) are provided.

Highlighted Details

  • Unified AI CLI Interface: Integrates 8+ AI coding CLIs with live status, token usage tracking, and model setting management.
  • Secure Credential Management: Agents use codux-ssh and codux-db commands, with credentials injected securely within Codux, never exposed to AI models or shell history.
  • Cross-Device Session Continuity: Drive agent sessions from any device (desktop, phone, headless server) via encrypted P2P/relay links, resuming work seamlessly.
  • Local-First & Non-Invasive: Data remains local; integrations use wrappers, avoiding global config mutations or prompt file modifications.
  • Gamified Usage: Features a "terminal pet" that visually represents agent activity and usage patterns.

Maintenance & Community

The project acknowledges contributions via GitHub issues and feedback. No specific community channels (like Discord/Slack) or prominent maintainer/sponsor information is detailed in the README.

Licensing & Compatibility

Codux is licensed under GPL-3.0, a strong copyleft license. While desktop and Android versions are free, the iOS app has a price to cover Apple's developer fees, though the source is available for self-compilation. The GPL-3.0 license may impose restrictions on linking with closed-source commercial software.

Limitations & Caveats

Headless host connectivity is currently in Beta, with potential instability. Integration depth varies across supported AI CLIs, with some having limited non-invasive prompt injection capabilities. The iOS app requires a purchase due to platform fees, although it is fully open-source.

Health Check
Last Commit

6 days ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
66
Star History
172 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.