tyulyukov · Mar 27, 2026 · Mar 27, 2026 · Mar 27, 2026 · Mar 27, 2026 · Mar 27, 2026
diff --git a/.dockerignore b/.dockerignore
@@ -0,0 +1,8 @@
+node_modules
+.next
+.turbo
+dist
+dist-electron
+*.tsbuildinfo
+.git
+.env*
diff --git a/.docs/architecture.md b/.docs/architecture.md
@@ -1,6 +1,6 @@
 # Architecture
 
-T3 Code runs as a **Node.js WebSocket server** that wraps `codex app-server` (JSON-RPC over stdio) and serves a React web app.
+MarCode runs as a **Node.js WebSocket server** that wraps `codex app-server` (JSON-RPC over stdio) and serves a React web app.
 
 ```
 ┌─────────────────────────────────┐

diff --git a/.docs/codex-prerequisites.md b/.docs/codex-prerequisites.md
@@ -1,5 +1,19 @@
-# Codex prerequisites
+# Provider prerequisites
 
-- Install Codex CLI so `codex` is on your PATH.
-- Authenticate Codex before running T3 Code (for example via API key or ChatGPT auth supported by Codex).
-- T3 Code starts the server via `codex app-server` per session.
+MarCode requires at least one of the following coding agent CLIs installed and authorized:
+
+## Claude Code CLI (default provider)
+
+- Install [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) so `claude` is on your PATH.
+- Authenticate before running MarCode.
+
+## Codex CLI
+
+- Install [Codex CLI](https://github.com/openai/codex) so `codex` is on your PATH.
+- Authenticate Codex before running MarCode (for example via API key or ChatGPT auth supported by Codex).
+- MarCode starts the server via `codex app-server` per Codex session.
+
+## Git host CLIs (optional, for PR/MR features)
+
+- **GitHub:** Install and authenticate [GitHub CLI (`gh`)](https://cli.github.com/).
+- **GitLab:** Install and authenticate [GitLab CLI (`glab`)](https://gitlab.com/gitlab-org/cli). A Personal Access Token works for self-hosted instances.
diff --git a/.docs/encyclopedia.md b/.docs/encyclopedia.md
@@ -1,6 +1,6 @@
 # Encyclopedia
 
-This is a living glossary for T3 Code. It explains what common terms mean in this codebase.
+This is a living glossary for MarCode. It explains what common terms mean in this codebase.
 
 ## Table of contents
 

diff --git a/.docs/provider-architecture.md b/.docs/provider-architecture.md
@@ -7,13 +7,13 @@ The web app communicates with the server via WebSocket using a simple JSON-RPC-s
 
 Push channels: `server.welcome`, `server.configUpdated`, `terminal.event`, `orchestration.domainEvent`. Payloads are schema-validated at the transport boundary (`wsTransport.ts`). Decode failures produce structured `WsDecodeDiagnostic` with `code`, `reason`, and path info.
 
-Methods mirror the `NativeApi` interface defined in `@t3tools/contracts`:
+Methods mirror the `NativeApi` interface defined in `@marcode/contracts`:
 
 - `providers.startSession`, `providers.sendTurn`, `providers.interruptTurn`
 - `providers.respondToRequest`, `providers.stopSession`
 - `shell.openInEditor`, `server.getConfig`
 
-Codex is the only implemented provider. `claudeCode` is reserved in contracts/UI.
+Claude Code is the default provider. Codex is also supported as an alternative provider.
 
 ## Client transport
 

diff --git a/.docs/quick-start.md b/.docs/quick-start.md
@@ -8,7 +8,7 @@ bun run dev
 bun run dev:desktop
 
 # Desktop development on an isolated port set
-T3CODE_DEV_INSTANCE=feature-xyz bun run dev:desktop
+MARCODE_DEV_INSTANCE=feature-xyz bun run dev:desktop
 
 # Production
 bun run build
@@ -18,5 +18,5 @@ bun run start
 bun run dist:desktop:dmg
 
 # Or from any project directory after publishing:
-npx t3
+npx marcode
 ```
diff --git a/.docs/runtime-modes.md b/.docs/runtime-modes.md
@@ -1,6 +1,6 @@
 # Runtime modes
 
-T3 Code has a global runtime mode switch in the chat toolbar:
+MarCode has a global runtime mode switch in the chat toolbar:
 
 - **Full access** (default): starts sessions with `approvalPolicy: never` and `sandboxMode: danger-full-access`.
 - **Supervised**: starts sessions with `approvalPolicy: on-request` and `sandboxMode: workspace-write`, then prompts in-app for command/file approvals.
diff --git a/.docs/scripts.md b/.docs/scripts.md
@@ -3,9 +3,9 @@
 - `bun run dev` — Starts contracts, server, and web in `turbo watch` mode.
 - `bun run dev:server` — Starts just the WebSocket server (uses Bun TypeScript execution).
 - `bun run dev:web` — Starts just the Vite dev server for the web app.
-- Dev commands default `T3CODE_STATE_DIR` to `~/.t3/dev` to keep dev state isolated from desktop/prod state.
+- Dev commands default `MARCODE_STATE_DIR` to `~/.marcode/dev` to keep dev state isolated from desktop/prod state.
 - Override server CLI-equivalent flags from root dev commands with `--`, for example:
-  `bun run dev -- --base-dir ~/.t3-2`
+  `bun run dev -- --base-dir ~/.marcode-2`
 - `bun run start` — Runs the production server (serves built web app as static files).
 - `bun run build` — Builds contracts, web app, and server through Turbo.
 - `bun run typecheck` — Strict TypeScript checks for all packages.
@@ -20,8 +20,8 @@
 
 - Default build is unsigned/not notarized for local sharing.
 - The DMG build uses `assets/macos-icon-1024.png` as the production app icon source.
-- Desktop production windows load the bundled UI from `t3://app/index.html` (not a `127.0.0.1` document URL).
-- Desktop packaging includes `apps/server/dist` (the `t3` backend) and starts it on loopback with an auth token for WebSocket/API traffic.
+- Desktop production windows load the bundled UI from `marcode://app/index.html` (not a `127.0.0.1` document URL).
+- Desktop packaging includes `apps/server/dist` (the `marcode` backend) and starts it on loopback with an auth token for WebSocket/API traffic.
 - Your tester can still open it on macOS by right-clicking the app and choosing **Open** on first launch.
 - To keep staging files for debugging package contents, run: `bun run dist:desktop:dmg -- --keep-stage`
 - To allow code-signing/notarization when configured in CI/secrets, add: `--signed`.
@@ -33,10 +33,10 @@
 
 ## Running multiple dev instances
 
-Set `T3CODE_DEV_INSTANCE` to any value to deterministically shift all dev ports together.
+Set `MARCODE_DEV_INSTANCE` to any value to deterministically shift all dev ports together.
 
 - Default ports: server `3773`, web `5733`
-- Shifted ports: `base + offset` (offset is hashed from `T3CODE_DEV_INSTANCE`)
-- Example: `T3CODE_DEV_INSTANCE=branch-a bun run dev:desktop`
+- Shifted ports: `base + offset` (offset is hashed from `MARCODE_DEV_INSTANCE`)
+- Example: `MARCODE_DEV_INSTANCE=branch-a bun run dev:desktop`
 
-If you want full control instead of hashing, set `T3CODE_PORT_OFFSET` to a numeric offset.
+If you want full control instead of hashing, set `MARCODE_PORT_OFFSET` to a numeric offset.
diff --git a/.docs/workspace-layout.md b/.docs/workspace-layout.md
@@ -2,6 +2,6 @@
 
 - `/apps/server`: Node.js WebSocket server. Wraps Codex app-server, serves the built web app, and opens the browser on start.
 - `/apps/web`: React + Vite UI. Session control, conversation, and provider event rendering. Connects to the server via WebSocket.
-- `/apps/desktop`: Electron shell. Spawns a desktop-scoped `t3` backend process and loads the shared web app.
+- `/apps/desktop`: Electron shell. Spawns a desktop-scoped `marcode` backend process and loads the shared web app.
 - `/packages/contracts`: Shared effect/Schema schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types.
-- `/packages/shared`: Shared runtime utilities consumed by both server and web. Uses explicit subpath exports (e.g. `@t3tools/shared/git`, `@t3tools/shared/DrainableWorker`) — no barrel index.
+- `/packages/shared`: Shared runtime utilities consumed by both server and web. Uses explicit subpath exports (e.g. `@marcode/shared/git`, `@marcode/shared/DrainableWorker`) — no barrel index.
diff --git a/.github/VOUCHED.td b/.github/VOUCHED.td
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -1,16 +1,3 @@
-<!--
-⚠️ READ BEFORE OPENING ⚠️
-
-We are not actively accepting contributions right now.
-
-You can still open a PR, but please do so knowing there is a high chance
-we may close it without merging it, or never review it.
-
-- Small, focused PRs are strongly preferred. Bug fixes are most likely to be merged.
-- New features will most likely just annoy us.
-- 1,000+ line PRs with a bunch of new features will probably get you banned from the repo.
--->
-
 ## What Changed
 
 <!-- Describe the change clearly and keep scope tight. -->

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -9,7 +9,7 @@ on:
 jobs:
   quality:
     name: Format, Lint, Typecheck, Test, Browser Test, Build
-    runs-on: blacksmith-4vcpu-ubuntu-2404
+    runs-on: ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v6

diff --git a/.github/workflows/pr-vouch.yml b/.github/workflows/pr-vouch.yml