> ## Documentation Index
> Fetch the complete documentation index at: https://docs-2.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://docs-2.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://docs-2.manicule.dev/api/mcp.
> Every agent surface: https://docs-2.manicule.dev/.well-known/llms-manifest.json

# Welcome to BhaiCode (/)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1919 · updated: 2026-11-11 -->
Related: [Import Existing Projects](/getting-started/import-projects.md)

> Overview of BhaiCode Desktop Workspace and Cloud Studio. Sovereign, developer-first AI coding tools.

BhaiCode provides two development environments powered by a shared agent core:

1. **BhaiCode Desktop Workspace**: A lightweight native desktop application powered by **Tauri 2, Rust, and React 19** (\~7–8 MB installer, \~45MB idle RAM). It runs locally on your machine, providing task-driven agent planning, CodeMirror 6 editing with inline code selection ("Ask AI on Selection"), multi-file visual diff review, an integrated PTY terminal, and local-first execution.
2. **BhaiCode Cloud Studio**: A zero-setup, browser-based web application builder at [app.bhaico.de](https://app.bhaico.de). It offers real-time streaming code generation, in-browser compilation, responsive device previews (Desktop, Tablet, Mobile), 1-click database provisioning (Cloudflare D1, Neon Postgres, Supabase), and instant deployments to BhaiCode Global Edge, Vercel, and Netlify.

Both surfaces support native multilingual prompts across **9+ Indian languages and English**, preserving code syntax while letting you explain logic in your natural tongue.

***

## Two Surfaces, One Core

```mermaid
graph LR
    subgraph Surfaces
        DESK["Desktop Workspace<br/>(Tauri 2 + Rust · Local-First)"]
        CLOUD["Cloud Studio<br/>(app.bhaico.de · In-Browser)"]
    end

    subgraph Agent Core
        BHAI["Bhai<br/>(Lead Builder)"]
        PLANNER["Planner<br/>(System Architect)"]
        EXECUTOR["Executor<br/>(Refactoring & Migrations)"]
    end

    subgraph Cloud Ecosystem
        CONN["1-Click Connectors<br/>(GitHub, Vercel, Neon, Supabase)"]
        EDGE["Deployments<br/>(BhaiCode Edge, Vercel, Netlify)"]
    end

    DESK --> BHAI
    CLOUD --> BHAI
    BHAI <--> PLANNER
    BHAI <--> EXECUTOR
    CLOUD --> CONN
    CLOUD --> EDGE
```

### 1. BhaiCode Desktop Workspace

* **Agentic Canvas Mode**: Assign multi-step tasks to Bhai. The agent creates a step-by-step implementation plan, edits files across your project, and reports progress live.
* **CodeMirror 6 Editor & Ask AI on Selection**: Highlight any block of code and press `Cmd + K` / `Ctrl + K` to explain, refactor, generate unit tests, or fix compiler diagnostics.
* **Multi-File Visual Diff Viewer**: Review changes across touched files with granular block-by-block accept/reject controls and instant git checkpoint rollbacks.
* **Transparency Dock & Permission Gates**: Safe by default. Granular approval gates prompt you before running shell commands or modifying files outside the workspace.
* **Integrated PTY Terminal**: Hardware-accelerated terminal (`xterm.js` + `portable-pty`) with command demarcation and background process tabs.
* **Local-First & OS Keychain**: Source code remains on your machine. API credentials live in your operating system's native keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service). Supports local offline models via **Ollama**.

### 2. BhaiCode Cloud Studio

* **Instant Browser Access**: Open [app.bhaico.de](https://app.bhaico.de) to build and deploy full-stack applications (Next.js, Vite + React, Astro, Remix, SvelteKit, Tailwind CSS) without local compilers.
* **Live Responsive Preview**: Real-time hot-reloading iframe with responsive device viewports (Desktop fluid, Tablet 768px, Mobile 375px) and live console logs.
* **Floating Hotbar Controls**: Preview/Code toggle, device viewports, Inspect element, Plugins status, Reload, Pop-out, and Deploy.
* **Auto-Collapsing Workspace Sidebar**: Opens in a clean full workspace, togglable via `Cmd + B` / `Ctrl + B`.
* **1-Click Connectors**: Link GitHub, GitLab, Vercel, Netlify, Neon, Supabase, Linear, and Sentry via OAuth 2.0.
* **Instant Deployments**: Deploy to BhaiCode Global Edge with automatic `*.bhaico.dev` subdomains and free SSL, or push directly to Vercel and Netlify.

***

## Universal Indic Multilingual Intelligence

BhaiCode natively supports **9+ Indian languages and English**:

* **Supported Languages**: Hindi, Hinglish, Bengali, Tamil, Telugu, Marathi, Kannada, Gujarati, Malayalam, Punjabi, Odia, and English.
* **Zero Syntax Corruption Guarantee**: Programming keywords, function signatures, variables, and imports (`useEffect`, `prisma.$transaction`, `idempotencyKey`) remain strictly preserved in standard code syntax while explanations flow naturally in your chosen language.

***

## Documentation Navigation

| Section                                                      | Description                                                                      |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| [Download & Install Desktop](/getting-started/installation)  | Install native Desktop Workspace on macOS, Windows, or Linux.                    |
| [Cloud Studio Quickstart](/getting-started/quickstart)       | Build and deploy a full-stack web app in under 60 seconds at `app.bhaico.de`.    |
| [Starter Templates](/getting-started/templates)              | Pre-configured starters: Next.js 15, React 19 + Vite, Astro 5, Remix, SvelteKit. |
| [Import Existing Projects](/getting-started/import-projects) | Open local repositories or import from GitHub / GitLab.                          |
| [Desktop Workspace Overview](/desktop/overview)              | Tauri 2 architecture, memory benchmarks, and working modes.                      |
| [Agentic Canvas Mode](/desktop/agentic-mode)                 | Autonomous task execution, progress timeline, and checkpoints.                   |
| [Code Editor & Ask AI](/desktop/code-editor)                 | CodeMirror 6 editor with interactive code selection actions.                     |
| [Multi-File Diff Viewer](/desktop/diff-viewer)               | Review code changes with block-by-block accept/reject and git rollback.          |
| [Transparency Dock](/desktop/transparency)                   | Permission tiers and security approval gates for terminal commands.              |
| [Integrated PTY Terminal](/desktop/terminal)                 | Native terminal integration (`portable-pty` + `xterm.js`).                       |
| [Cloud Studio Overview](/studio/overview)                    | Tour of the in-browser studio interface and responsive layout.                   |
| [AI Chat & Context Pinning](/studio/ai-chat)                 | Multi-turn prompt iteration and referencing files with `@file`.                  |
| [In-Browser Code Editor](/studio/code-editor)                | Monaco-powered browser editor with TypeScript IntelliSense.                      |
| [Live Web Preview](/studio/live-preview)                     | Real-time hot reloading, responsive device viewports, and console debugging.     |
| [Version Control & Git](/studio/version-control)             | Automatic checkpoint snapshots, branch switching, and Git sync.                  |
| [Subagents Swarm Overview](/agents/overview)                 | Multi-agent coordination: Bhai, Planner, and Executor.                           |
| [Connectors & Integrations](/connectors/overview)            | 1-Click OAuth integrations for GitHub, Vercel, Neon, Supabase, Linear, Sentry.   |
| [1-Click Multi-Cloud Deployments](/deployments/multi-cloud)  | Deploy to BhaiCode Global Edge, Vercel, and Netlify with custom domain DNS.      |
| [Managed Databases](/databases/overview)                     | Cloudflare D1 (Edge SQLite), Neon Serverless Postgres, and Supabase.             |
| [Security & Privacy](/security/privacy)                      | Zero customer code training, AES-256 encrypted Token Vault, and sandboxing.      |