How linxira-os/linxira-zeta works
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: src Coding CLI · app.rs Zeta Workspace · suite.rs Suite Launch · indexed-session-storage.ts Session Index
Components 27
Terminal Workbench
- Zeta Workspace
main/crates/zeta-main/src/app.rs - Pane Layout
main/crates/zeta-main/src/layout.rs - Suite Launch
main/crates/zeta-main/src/suite.rs - PTY Shell
crates/pi-shell/src/shell.rs
Coding Agent
- Coding CLI
packages/coding-agent/src - Agent Tools
packages/coding-agent/src/tools - Session Storage
packages/coding-agent/src/session/session-storage.ts - Session Index
packages/coding-agent/src/session/indexed-session-storage.ts - Session Entries
packages/coding-agent/src/session/session-entries.ts - Session Titles
packages/coding-agent/src/session/session-title-slot.ts - Web Workbench
web-ui - Desktop Shell
desktop/src/main.ts
Shared Runtime
- Provider Auth
packages/ai/src/auth-storage.ts - Model Catalog
packages/catalog/src/model-manager.ts - Usage Insights
packages/stats/src/trace.ts - Output Minimizer
crates/pi-shell/src/minimizer/engine.rs - Command Filters
crates/pi-shell/src/minimizer/filters - Filter Pipelines
crates/pi-shell/src/minimizer/pipeline.rs - Text Primitives
crates/pi-shell/src/minimizer/primitives.rs
Editor Tools
- Terminal Editor
editor/cmd/ttt/main.go - Editor Plugins
editor/internal/plugin/manager.go - Language Services
editor/internal/lsp/manager.go - Terminal IDE
termide/src/main.rs - IDE Layout
termide/crates/layout/src/layout_manager.rs
Native Capabilities
- Text Tokenization
crates/pi-natives/src/utok/claude/normalize.rs - Token Counter
crates/pi-natives/src/utok/claude/engine.rs
Other components
- Workbench User
Connections 26
- Workbench User → Zeta Workspace: opens workspace
- Zeta Workspace → Pane Layout: manages panes
main/crates/zeta-main/src/app.rs - Zeta Workspace → Suite Launch: launches tools
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
packages/coding-agent/src/session/indexed-session-storage.ts - Session Index → Session Storage: uses backend
packages/coding-agent/src/session/indexed-session-storage.ts - Session Storage → Session Titles: serializes titles
packages/coding-agent/src/session/session-storage.ts - Session Index → Session Entries: parses entries
packages/coding-agent/src/session/indexed-session-storage.ts - Session Index → Session Titles: parses title slots
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
crates/pi-shell/src/minimizer/engine.rs - Output Minimizer → Filter Pipelines: runs pipelines
crates/pi-shell/src/minimizer/engine.rs - Filter Pipelines → Text Primitives: transforms text
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
termide/src/main.rs - Text Tokenization → Token Counter: counts tokens
crates/pi-natives/src/utok/claude/normalize.rs - Coding CLI → Web Workbench: embeds runtime
- Coding CLI → Desktop Shell: embeds runtime