YzPzCode

Your AI Coding Squad, One Window Away.

Stop juggling 5 different terminals.
YzPzCode brings Claude, Gemini, Codex, Opencode, and Cursor together in one clean interface.

   

---

🎯 The Problem

[!] The Old Way	[+] The YzPzCode Way
Three terminal windows	One app
Three different CLIs	All agents inside
Alt-tabbing like a maniac	Side-by-side grid
Copy-pasting between them	Compare instantly
Losing your mind	Stay in flow

---

- See It In Action

Clean. Fast. Powerful.

---

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

Claude claude Deep reasoning, patient explanations

Gemini gemini Fast, multimodal, Google's finest

Codex codex Code generation that works

Opencode opencode Open-source freedom

Cursor cursor IDE-level AI assistance

---

Supported Development Environments

VS Code	Cursor	Zed	Visual Studio	WebStorm
IntelliJ	Sublime Text	Windsurf	Perplexity	Antigravity

---

- 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

Layer	Stack
Frontend	React 19 + TypeScript · Vite · Tailwind CSS v4 · Zustand · xterm.js
Backend	Tauri v2 (Rust) · portable-pty · Tokio

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

Loading

---

- 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.

---

- Like What You See?

If YzPzCode saved you from terminal chaos, consider giving it a star — it helps others find it too!

---

Built with <3 and late nights by

Naseem Creator & Lead Dev @wolfenazz

Noor Contributor and dev @Noor-Al-Khelaifi

For developers who'd rather code than manage terminals.