Zaguán Blade

The AI Editor (The Body)

Zaguán Blade (zblade) is the graphical frontend for the Zaguán AI system. It serves as the "Body" to the "Brain" (zcoderd).

Built with Tauri v2 and Next.js, it provides a modern, high-performance interface for AI-assisted coding, featuring a custom CodeMirror 6 editor and deep integration with the Blade Protocol.

Architecture

The system follows a strict Body/Brain separation:

Zaguán Blade (The Body): This repository. A lightweight GUI client that handles user input, file rendering, and editor visualizations. It possesses no AI logic itself.
Zcoderd (The Brain): An external, high-performance Go server that manages state, executes tools, performs web research, and drives the AI models.
Blade Protocol v2: The communication layer between Body and Brain, allowing the AI to "pilot" the editor.

Project Status: Alpha

Important

External Dependency Required: This project is the client only. To function, it requires a running instance of zcoderd.

currently, zcoderd is:

Mandatory: The client cannot function without it.

Hardcoded: The client expects the server at a specific localhost address.

Private: The zcoderd repository is currently private ("The Secret Sauce").

Future versions aim to make zcoderd optional.

Key Features

Visual Editor: A heavily customized CodeMirror 6 implementation with "Vertical Diff Blocks" for AI code generation.
Web Tools Visualization: The client visualizes the server's research context, showing what the AI is reading and thinking.
Blade Protocol Integration: seamless, real-time sync between the editor state and the AI's context.

Getting Started

Prerequisites

Node.js (v18+)
Rust (v1.70+)
pnpm
A running instance of zcoderd

Installation

Clone the repository:

git clone https://github.com/ZaguanLabs/ZaguanBlade.git
cd zaguan-blade

Install dependencies:
```
pnpm install
```

Development

Start the Taurus development window:

pnpm tauri dev

This will spin up the Next.js frontend and the Tauri Rust, backend.

Building

To build the application for release:

pnpm tauri build

License

MIT

2.3 KiB Raw Blame History