---

🎯 The Problem

---

📸 See It In Action

---

Core Capabilities

Multi-Agent Grid Run Claude, Gemini, and Codex in synchronized, side-by-side views.	Automated Initialization Instantly detect and configure locally installed CLIs.	Workspace Presets Save and restore optimal agent combinations for specific workflows.	Native Terminals Powered by actual PTY sessions for authentic CLI interaction.
Cross-Platform Support Optimized binaries for Windows, macOS, and Linux.	Resource Efficient Built on Tauri and Rust, utilizing a fraction of the RAM required by Electron.	Integrated Explorer Manage files and directories without leaving the application.	Git Integration Monitor repository status and diff statistics at a glance.
Multi-Tab Editor Built-in syntax highlighting and file preview capabilities.	IDE Integration Seamlessly launch into over 10 supported development environments.	Authentication Tracking Monitor credential states across all active CLI tools.	Continuous Delivery Automated update mechanisms ensure access to the latest features.

---

🤖 AI Agent CLIs

---

Supported Development Environments

---

🚀 Quick Start

You'll need: Node.js 18+ and Rust (latest stable)

# 1. Clone it
git clone https://github.com/wolfenazz/YzPzCode.git
cd YzPzCode/app

# 2. Install dependencies
npm install

# 3. Run it
npm run tauri dev

The app will detect what AI CLIs you have installed and help you set up the rest.

🍎 macOS Users

Install Rust first:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your terminal before running npm run tauri dev.

Installing from .dmg? Since the app isn't code-signed yet:

Option	How
Right-click	Right-click the app → Open → Click Open
System Settings	System Settings → Privacy & Security → Open Anyway
Terminal	xattr -cr /Applications/YzPzCode.app

Note: We're working on getting the app properly code-signed with Apple Developer and Microsoft certificates.

📦 Build for Production

npm run tauri build

Generates a native installer for your platform. Small, fast, no bloat.

---

🏗️ How It's Built

Architecture

graph TB
    subgraph Frontend["Frontend — React + TypeScript"]
        UI[User Interface]
        Grid[Terminal Grid]
        Setup[Setup Screen]
        Store[Zustand Store]
        Explorer[File Explorer]
        Editor[File Editor]
    end

    subgraph Backend["Backend — Rust + Tauri v2"]
        Commands[Tauri Commands]
        PTY[PTY Manager]
        Detector[CLI Detector]
        Installer[CLI Installer]
        Auth[Auth Detector]
        Ide[IDE Detector]
        Fs[File System]
        Git[Git Operations]
        Watcher[File Watcher]
    end

    subgraph CLIs["AI CLI Tools"]
        Claude[Claude CLI]
        Gemini[Gemini CLI]
        Codex[Codex CLI]
        Opencode[Opencode CLI]
        Cursor[Cursor CLI]
    end

    UI --> Grid
    UI --> Setup
    UI --> Explorer
    UI --> Editor
    Grid --> Store
    Setup --> Store
    Explorer --> Store
    Editor --> Store
    
    Store <-->|Tauri IPC| Commands
    Commands --> PTY
    Commands --> Detector
    Commands --> Installer
    Commands --> Auth
    Commands --> Ide
    Commands --> Fs
    Commands --> Git
    Commands --> Watcher
    
    PTY -->|Spawns| Claude
    PTY -->|Spawns| Gemini
    PTY -->|Spawns| Codex
    PTY -->|Spawns| Opencode
    PTY -->|Spawns| Cursor

---

📂 Project Structure

app/
├── src-tauri/                      # Rust backend
│   └── src/
│       ├── agent/                  # Agent task execution & orchestration
│       ├── agent_cli/              # CLI detection, installation & launching
│       │   └── providers/          # Provider-specific implementations
│       ├── commands/               # Tauri IPC handlers
│       ├── terminal/               # PTY session management
│       ├── filesystem/             # File operations, git, watcher
│       ├── ide/                    # IDE detection & launching
│       └── utils/                  # Utilities
├── src/                            # React frontend
│   ├── components/
│   │   ├── setup/                  # Setup & configuration screens
│   │   ├── workspace/              # Terminal grid & sessions
│   │   ├── explorer/               # File explorer & git panels
│   │   ├── editor/                 # Multi-tab file editor
│   │   ├── common/                 # Shared components
│   │   └── feedback/               # Feedback modal
│   ├── hooks/                      # Custom React hooks
│   ├── stores/                     # Zustand state management
│   └── types/                      # TypeScript definitions
└── docs/                           # Documentation

---

🛠️ Contributing

# Type checking
npx tsc --noEmit          # Frontend
cargo check               # Backend

# Linting & formatting
cargo clippy              # Catch Rust issues
cargo fmt                 # Make it pretty

# Testing
cd src-tauri && cargo test

Found a bug? Have an idea? Open an issue · Submit a PR

Check out the full roadmap.

---

📖 Recommended Setup

---

📜 License

Fork it. Build on it. Make it yours.

---