> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/pingdotgg/t3code/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to T3 Code - a minimal web GUI for coding agents like Codex

<img className="block dark:hidden" src="https://media.brand.dev/64c8e868-1600-4dbb-aa50-d4654494a909.png" alt="T3 Code Logo" />

<img className="hidden dark:block" src="https://media.brand.dev/64c8e868-1600-4dbb-aa50-d4654494a909.png" alt="T3 Code Logo" />

# Welcome to T3 Code

T3 Code is a minimal web GUI for coding agents like Codex with session management and real-time collaboration. It provides a clean, modern interface for interacting with AI coding assistants through both web and desktop applications.

## What is T3 Code?

T3 Code wraps the Codex app server in a user-friendly web interface, enabling developers to:

* **Interact with AI coding agents** through an intuitive chat-based interface
* **Manage coding sessions** with persistent state and thread management
* **Track changes** with built-in git integration and checkpointing
* **Control access** with dual runtime modes (Full Access and Supervised)
* **Work anywhere** with both web and desktop (Electron) interfaces

## Key Features

<CardGroup cols={2}>
  <Card title="Real-time Sessions" icon="bolt" href="/concepts/sessions">
    WebSocket-based coding sessions with Codex for instant feedback and collaboration
  </Card>

  <Card title="Project Management" icon="folder-tree" href="/guides/project-management">
    Organize your work with persistent project and thread management
  </Card>

  <Card title="Git Integration" icon="git-alt" href="/guides/git-workflow">
    Built-in checkpointing and worktree support for seamless version control
  </Card>

  <Card title="Runtime Modes" icon="shield-halved" href="/concepts/runtime-modes">
    Choose between Full Access and Supervised modes for enhanced security
  </Card>

  <Card title="Multi-Platform" icon="window-restore" href="/guides/desktop-app">
    Access via web browser or native desktop application
  </Card>

  <Card title="Provider-Agnostic" icon="plug" href="/concepts/providers">
    Extensible architecture designed for multiple AI backend providers
  </Card>
</CardGroup>

## Quick Start

Get started with T3 Code in seconds:

<CodeGroup>
  ```bash npm theme={null}
  npx t3
  ```

  ```bash Desktop theme={null}
  # Download from releases
  # https://github.com/pingdotgg/t3code/releases
  ```
</CodeGroup>

<Note>
  You need to have [Codex CLI](https://github.com/openai/codex) installed and authorized for T3 Code to work.
</Note>

## Architecture Overview

T3 Code runs as a **Node.js WebSocket server** that wraps the Codex app server (JSON-RPC over stdio) and serves a React web application.

```
┌─────────────────────────────────┐
│  Browser (React + Vite)         │
│  Connected via WebSocket        │
└──────────┬──────────────────────┘
           │ ws://localhost:3773
┌──────────▼──────────────────────┐
│  apps/server (Node.js)          │
│  WebSocket + HTTP static server │
│  ProviderManager                │
│  CodexAppServerManager          │
└──────────┬──────────────────────┘
           │ JSON-RPC over stdio
┌──────────▼──────────────────────┐
│  codex app-server               │
└─────────────────────────────────┘
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get T3 Code running in minutes
  </Card>

  <Card title="Core Concepts" icon="book" href="/concepts/architecture">
    Understand how T3 Code works
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration/server-options">
    Customize your setup
  </Card>

  <Card title="API Reference" icon="code" href="/api/websocket-protocol">
    Explore the WebSocket API
  </Card>
</CardGroup>

## Community & Support

* **GitHub**: [pingdotgg/t3code](https://github.com/pingdotgg/t3code)
* **Discord**: [Join our Discord](https://discord.gg/jn4EGJjrvv)
* **License**: MIT

<Warning>
  T3 Code is in very early development. Expect bugs and breaking changes.
</Warning>