From 9d321c71f24aae04fe3284ecd4caab8cec5254c3 Mon Sep 17 00:00:00 2001 From: okwn Date: Wed, 20 May 2026 21:08:59 +0000 Subject: [PATCH 1/2] docs(WARP): add crate overview section Add a Crate Overview section to WARP.md listing key crates and their purposes: ai, channel_versions, command, editor, graphql, http_client, http_server, ipc, warpui, warpui_core, warp_core, app, and integration. --- WARP.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/WARP.md b/WARP.md index 0d5e9a8f46..4576fcb99e 100644 --- a/WARP.md +++ b/WARP.md @@ -82,6 +82,23 @@ This is a Rust-based terminal emulator with a custom UI framework called **WarpU - `crates/ipc/` - Inter-process communication - `crates/graphql/` - GraphQL client and schema +### Crate Overview + +The repository is a Cargo workspace with 60+ member crates. Key crates: + +- `crates/ai/` — AI integration, agent mode, and context management +- `crates/channel_versions/` — Channel and version management for updates +- `crates/command/` — Command execution and shell integration +- `crates/editor/` — Text editing and buffer management +- `crates/graphql/` — GraphQL client, schema definitions, and query execution +- `crates/http_client/` — HTTP client utilities +- `crates/http_server/` — HTTP server for local Warp server features +- `crates/ipc/` — Inter-process communication between app and server +- `crates/warpui/` and `crates/warpui_core/` — Custom UI framework (Entity-Component-Handle pattern) +- `crates/warp_core/` — Core utilities, platform abstractions, and shared types +- `app/` — Main application binary: terminal emulation, shell management, AI integration, authentication, settings, workspace management +- `crates/integration/` — Integration test framework + ### Key Architectural Patterns 1. **Entity-Handle System**: Views reference other views via handles, not direct ownership From 6cd90ae0887a460b296195062de167bd5c5e2998 Mon Sep 17 00:00:00 2001 From: okwn Date: Thu, 21 May 2026 00:11:37 +0000 Subject: [PATCH 2/2] docs: add crate overview section Closes #10156