# linxira-os/linxira-zeta architecture

> Architecture diagram of the GitHub repository linxira-os/linxira-zeta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/linxira-os/linxira-zeta
- Repository: https://github.com/linxira-os/linxira-zeta

## Overview

Zeta is a terminal workbench suite centered on a Rust workspace that hosts real terminal panes and hands off to standalone coding-agent, editor, and IDE tools. The README documents the main user journey and suite capabilities; sampled source confirms selected internal implementations, including model catalog assembly, session storage, shell-output minimization, and Claude token counting. Several README-described and tree-visible subsystems were not sampled, so their internal links are shown only where documented; no unsampled implementation details are assumed.

Main entry points: [`packages/coding-agent/src`](https://github.com/linxira-os/linxira-zeta/tree/main/packages/coding-agent/src) (Coding CLI), [`main/crates/zeta-main/src/app.rs`](https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/app.rs) (Zeta Workspace), [`main/crates/zeta-main/src/suite.rs`](https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/suite.rs) (Suite Launch), [`packages/coding-agent/src/session/indexed-session-storage.ts`](https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/indexed-session-storage.ts) (Session Index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Terminal Workbench"]
  node_workspace["Zeta Workspace<br/>[app.rs]"]
  node_pane_layout["Pane Layout<br/>[layout.rs]"]
  node_suite_tools["Suite Launch<br/>[suite.rs]"]
  node_pty_shell["PTY Shell<br/>[shell.rs]"]
end

subgraph group_agent["Coding Agent"]
  node_coding_cli["Coding CLI"]
  node_agent_tools["Agent Tools"]
  node_session_storage[("Session Storage<br/>[session-storage.ts]")]
  node_session_index[("Session Index")]
  node_session_entries["Session Entries<br/>[session-entries.ts]"]
  node_session_titles["Session Titles"]
  node_web_workbench["Web Workbench"]
  node_desktop_shell["Desktop Shell<br/>[main.ts]"]
end

subgraph group_runtime["Shared Runtime"]
  node_auth["Provider Auth<br/>[auth-storage.ts]"]
  node_model_catalog["Model Catalog<br/>[model-manager.ts]"]
  node_stats["Usage Insights<br/>[trace.ts]"]
  node_shell_minimizer["Output Minimizer<br/>[engine.rs]"]
  node_minimizer_filters["Command Filters"]
  node_minimizer_pipelines["Filter Pipelines<br/>[pipeline.rs]"]
  node_minimizer_primitives["Text Primitives<br/>[primitives.rs]"]
end

subgraph group_editors["Editor Tools"]
  node_editor["Terminal Editor<br/>[main.go]"]
  node_editor_plugins["Editor Plugins<br/>[manager.go]"]
  node_editor_lsp["Language Services<br/>[manager.go]"]
  node_ide["Terminal IDE<br/>[main.rs]"]
  node_ide_layout["IDE Layout<br/>[layout_manager.rs]"]
end

subgraph group_support["Native Capabilities"]
  node_native_text["Text Tokenization<br/>[normalize.rs]"]
  node_native_engine["Token Counter<br/>[engine.rs]"]
end

node_user(("Workbench User"))

node_user -->|"opens workspace"| node_workspace
node_workspace -->|"manages panes"| node_pane_layout
node_workspace -->|"launches tools"| node_suite_tools
node_workspace -->|"hosts terminals"| node_pty_shell
node_suite_tools -->|"hands off"| node_coding_cli
node_suite_tools -->|"hands off"| node_editor
node_suite_tools -->|"hands off"| node_ide
node_coding_cli -->|"runs tools"| node_agent_tools
node_coding_cli -->|"recovers sessions"| node_session_storage
node_session_index -->|"uses backend"| node_session_storage
node_session_storage -->|"serializes titles"| node_session_titles
node_session_index -->|"parses entries"| node_session_entries
node_session_index -->|"parses title slots"| node_session_titles
node_coding_cli -.->|"resolves credentials"| node_auth
node_coding_cli -.->|"discovers models"| node_model_catalog
node_coding_cli -.->|"records usage"| node_stats
node_pty_shell -->|"minimizes output"| node_shell_minimizer
node_shell_minimizer -->|"dispatches filters"| node_minimizer_filters
node_shell_minimizer -->|"runs pipelines"| node_minimizer_pipelines
node_minimizer_pipelines -->|"transforms text"| node_minimizer_primitives
node_editor -.->|"manages plugins"| node_editor_plugins
node_editor -.->|"uses language services"| node_editor_lsp
node_ide -->|"manages layout"| node_ide_layout
node_native_text -->|"counts tokens"| node_native_engine
node_coding_cli -->|"embeds runtime"| node_web_workbench
node_coding_cli -->|"embeds runtime"| node_desktop_shell

click node_workspace "https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/app.rs"
click node_pane_layout "https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/layout.rs"
click node_suite_tools "https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/suite.rs"
click node_pty_shell "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/shell.rs"
click node_coding_cli "https://github.com/linxira-os/linxira-zeta/tree/main/packages/coding-agent/src"
click node_agent_tools "https://github.com/linxira-os/linxira-zeta/tree/main/packages/coding-agent/src/tools"
click node_session_storage "https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-storage.ts"
click node_session_index "https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/indexed-session-storage.ts"
click node_session_entries "https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-entries.ts"
click node_session_titles "https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-title-slot.ts"
click node_auth "https://github.com/linxira-os/linxira-zeta/blob/main/packages/ai/src/auth-storage.ts"
click node_model_catalog "https://github.com/linxira-os/linxira-zeta/blob/main/packages/catalog/src/model-manager.ts"
click node_stats "https://github.com/linxira-os/linxira-zeta/blob/main/packages/stats/src/trace.ts"
click node_shell_minimizer "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/engine.rs"
click node_minimizer_filters "https://github.com/linxira-os/linxira-zeta/tree/main/crates/pi-shell/src/minimizer/filters"
click node_minimizer_pipelines "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/pipeline.rs"
click node_minimizer_primitives "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/primitives.rs"
click node_editor "https://github.com/linxira-os/linxira-zeta/blob/main/editor/cmd/ttt/main.go"
click node_editor_plugins "https://github.com/linxira-os/linxira-zeta/blob/main/editor/internal/plugin/manager.go"
click node_editor_lsp "https://github.com/linxira-os/linxira-zeta/blob/main/editor/internal/lsp/manager.go"
click node_ide "https://github.com/linxira-os/linxira-zeta/blob/main/termide/src/main.rs"
click node_ide_layout "https://github.com/linxira-os/linxira-zeta/blob/main/termide/crates/layout/src/layout_manager.rs"
click node_native_text "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-natives/src/utok/claude/normalize.rs"
click node_native_engine "https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-natives/src/utok/claude/engine.rs"
click node_web_workbench "https://github.com/linxira-os/linxira-zeta/tree/main/web-ui"
click node_desktop_shell "https://github.com/linxira-os/linxira-zeta/blob/main/desktop/src/main.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workspace,node_pane_layout,node_suite_tools,node_pty_shell,node_user toneBlue
class node_coding_cli,node_agent_tools,node_session_storage,node_session_index,node_session_entries,node_session_titles,node_web_workbench,node_desktop_shell toneAmber
class node_auth,node_model_catalog,node_stats,node_shell_minimizer,node_minimizer_filters,node_minimizer_pipelines,node_minimizer_primitives toneMint
class node_editor,node_editor_plugins,node_editor_lsp,node_ide,node_ide_layout toneRose
class node_native_text,node_native_engine toneIndigo
```

## Components

### Terminal Workbench

- [Zeta Workspace](https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/app.rs): `main/crates/zeta-main/src/app.rs`
- [Pane Layout](https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/layout.rs): `main/crates/zeta-main/src/layout.rs`
- [Suite Launch](https://github.com/linxira-os/linxira-zeta/blob/main/main/crates/zeta-main/src/suite.rs): `main/crates/zeta-main/src/suite.rs`
- [PTY Shell](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/shell.rs): `crates/pi-shell/src/shell.rs`

### Coding Agent

- [Coding CLI](https://github.com/linxira-os/linxira-zeta/tree/main/packages/coding-agent/src): `packages/coding-agent/src`
- [Agent Tools](https://github.com/linxira-os/linxira-zeta/tree/main/packages/coding-agent/src/tools): `packages/coding-agent/src/tools`
- [Session Storage](https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-storage.ts): `packages/coding-agent/src/session/session-storage.ts`
- [Session Index](https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/indexed-session-storage.ts): `packages/coding-agent/src/session/indexed-session-storage.ts`
- [Session Entries](https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-entries.ts): `packages/coding-agent/src/session/session-entries.ts`
- [Session Titles](https://github.com/linxira-os/linxira-zeta/blob/main/packages/coding-agent/src/session/session-title-slot.ts): `packages/coding-agent/src/session/session-title-slot.ts`
- [Web Workbench](https://github.com/linxira-os/linxira-zeta/tree/main/web-ui): `web-ui`
- [Desktop Shell](https://github.com/linxira-os/linxira-zeta/blob/main/desktop/src/main.ts): `desktop/src/main.ts`

### Shared Runtime

- [Provider Auth](https://github.com/linxira-os/linxira-zeta/blob/main/packages/ai/src/auth-storage.ts): `packages/ai/src/auth-storage.ts`
- [Model Catalog](https://github.com/linxira-os/linxira-zeta/blob/main/packages/catalog/src/model-manager.ts): `packages/catalog/src/model-manager.ts`
- [Usage Insights](https://github.com/linxira-os/linxira-zeta/blob/main/packages/stats/src/trace.ts): `packages/stats/src/trace.ts`
- [Output Minimizer](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/engine.rs): `crates/pi-shell/src/minimizer/engine.rs`
- [Command Filters](https://github.com/linxira-os/linxira-zeta/tree/main/crates/pi-shell/src/minimizer/filters): `crates/pi-shell/src/minimizer/filters`
- [Filter Pipelines](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/pipeline.rs): `crates/pi-shell/src/minimizer/pipeline.rs`
- [Text Primitives](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-shell/src/minimizer/primitives.rs): `crates/pi-shell/src/minimizer/primitives.rs`

### Editor Tools

- [Terminal Editor](https://github.com/linxira-os/linxira-zeta/blob/main/editor/cmd/ttt/main.go): `editor/cmd/ttt/main.go`
- [Editor Plugins](https://github.com/linxira-os/linxira-zeta/blob/main/editor/internal/plugin/manager.go): `editor/internal/plugin/manager.go`
- [Language Services](https://github.com/linxira-os/linxira-zeta/blob/main/editor/internal/lsp/manager.go): `editor/internal/lsp/manager.go`
- [Terminal IDE](https://github.com/linxira-os/linxira-zeta/blob/main/termide/src/main.rs): `termide/src/main.rs`
- [IDE Layout](https://github.com/linxira-os/linxira-zeta/blob/main/termide/crates/layout/src/layout_manager.rs): `termide/crates/layout/src/layout_manager.rs`

### Native Capabilities

- [Text Tokenization](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-natives/src/utok/claude/normalize.rs): `crates/pi-natives/src/utok/claude/normalize.rs`
- [Token Counter](https://github.com/linxira-os/linxira-zeta/blob/main/crates/pi-natives/src/utok/claude/engine.rs): `crates/pi-natives/src/utok/claude/engine.rs`

### Other components

- **Workbench User**

## Connections

- Workbench User → Zeta Workspace: opens workspace
- Zeta Workspace → Pane Layout: manages panes (evidence: `main/crates/zeta-main/src/app.rs`)
- Zeta Workspace → Suite Launch: launches tools (evidence: `main/crates/zeta-main/src/app.rs`)
- Zeta Workspace → PTY Shell: hosts terminals
- Suite Launch → Coding CLI: hands off
- Suite Launch → Terminal Editor: hands off
- Suite Launch → Terminal IDE: hands off
- Coding CLI → Agent Tools: runs tools
- Coding CLI → Session Storage: recovers sessions (evidence: `packages/coding-agent/src/session/indexed-session-storage.ts`)
- Session Index → Session Storage: uses backend (evidence: `packages/coding-agent/src/session/indexed-session-storage.ts`)
- Session Storage → Session Titles: serializes titles (evidence: `packages/coding-agent/src/session/session-storage.ts`)
- Session Index → Session Entries: parses entries (evidence: `packages/coding-agent/src/session/indexed-session-storage.ts`)
- Session Index → Session Titles: parses title slots (evidence: `packages/coding-agent/src/session/indexed-session-storage.ts`)
- Coding CLI → Provider Auth: resolves credentials
- Coding CLI → Model Catalog: discovers models
- Coding CLI → Usage Insights: records usage
- PTY Shell → Output Minimizer: minimizes output
- Output Minimizer → Command Filters: dispatches filters (evidence: `crates/pi-shell/src/minimizer/engine.rs`)
- Output Minimizer → Filter Pipelines: runs pipelines (evidence: `crates/pi-shell/src/minimizer/engine.rs`)
- Filter Pipelines → Text Primitives: transforms text (evidence: `crates/pi-shell/src/minimizer/pipeline.rs`)
- Terminal Editor → Editor Plugins: manages plugins
- Terminal Editor → Language Services: uses language services
- Terminal IDE → IDE Layout: manages layout (evidence: `termide/src/main.rs`)
- Text Tokenization → Token Counter: counts tokens (evidence: `crates/pi-natives/src/utok/claude/normalize.rs`)
- Coding CLI → Web Workbench: embeds runtime
- Coding CLI → Desktop Shell: embeds runtime
