How v7ren/lane works
Loomria is a desktop workspace for running multiple coding-agent TUIs, with manifest-discovered agents, terminal panes, session-aware chat, and supporting editor/review and settings surfaces. The main flow starts in the React app shell, which coordinates panes and sessions; the terminal/session hooks connect UI activity to Tauri operations, while protocol modules support agent-specific events. The README also documents custom TOML agents. Some Rust command wiring and several UI subsystems were not sampled, so their links are omitted or marked unverified rather than inferred.
Main entry points: App.tsx Application entry · tauri.ts Tauri client · useAgentSession.ts Agent session state · usePaneRegistry.ts Pane registry
Components 25
App shell
- Application entry
packages/app/src/App.tsx - Workspace shell
packages/app/src/components/shell/AppShell.tsx
Agent sessions
- Agent view
packages/app/src/components/agent/AgentView.tsx - Agent session state
packages/app/src/hooks/useAgentSession.ts - Agent event model
packages/app/src/lib/agent-events.ts - Session rail state
packages/app/src/hooks/useSessionRail.ts
Terminal runtime
- Pane registry
packages/app/src/hooks/usePaneRegistry.ts - Terminal lifecycle
packages/app/src/hooks/useTerminalSession.ts - Terminal session
packages/app/src/terminal/terminal-session.ts - Pane stream
packages/app/src/terminal/pane-stream.ts
Agent integrations
- Tauri client
packages/app/src/lib/tauri.ts - Desktop commands
packages/app/src-tauri/src/commands.rs - Agent catalog
packages/app/src-tauri/src/agents/catalog.rs - Manifest loading
packages/app/src-tauri/src/agents/manifest.rs - Protocol modules
packages/app/src-tauri/src/protocol/mod.rs - Claude streams
packages/app/src-tauri/src/protocol/claude_stream_json.rs - Codex events
packages/app/src-tauri/src/protocol/codex_notifications.rs - Codex WebSocket
packages/app/src-tauri/src/protocol/codex_ws.rs - OpenCode client
packages/app/src-tauri/src/opencode/client.rs - Session bridge
packages/app/src/lib/bridge.ts
Workspace tools
- Editor context
packages/app/src/lib/editor/EditorContext.tsx - Scoped filesystem
packages/app/src/lib/editor/fs-client.ts - Diff review
packages/app/src/components/review/ReviewPanel.tsx - Settings storage
packages/app/src/lib/settings.ts
Other components
- User
Connections 24
- User → Application entry: uses
- Application entry → Workspace shell: renders
packages/app/src/App.tsx - Application entry → Pane registry: creates
packages/app/src/App.tsx - Application entry → Session rail state: subscribes
packages/app/src/App.tsx - Workspace shell → Agent view: renders
packages/app/src/components/shell/AppShell.tsx - Workspace shell → Pane registry: uses
packages/app/src/components/shell/AppShell.tsx - Pane registry → Tauri client: manages panes
packages/app/src/hooks/usePaneRegistry.ts - Pane registry → Pane stream: creates streams
packages/app/src/hooks/usePaneRegistry.ts - Agent view → Agent session state: loads session
- Agent session state → Agent event model: reduces events
packages/app/src/hooks/useAgentSession.ts - Agent session state → Tauri client: loads history
packages/app/src/hooks/useAgentSession.ts - Agent session state → OpenCode client: optional chat
packages/app/src/hooks/useAgentSession.ts - Terminal lifecycle → Terminal session: mounts
packages/app/src/hooks/useTerminalSession.ts - Terminal lifecycle → Tauri client: resizes and writes
packages/app/src/hooks/useTerminalSession.ts - Protocol modules → Claude streams: declares module
packages/app/src-tauri/src/protocol/mod.rs - Protocol modules → Codex events: declares module
packages/app/src-tauri/src/protocol/mod.rs - Protocol modules → Codex WebSocket: declares module
packages/app/src-tauri/src/protocol/mod.rs - Tauri client → Desktop commands: invokes commands
- Editor context → Scoped filesystem: reads and writes
packages/app/src/lib/editor/EditorContext.tsx - Diff review → Editor context: opens file
packages/app/src/components/review/ReviewPanel.tsx - Diff review → Tauri client: requests diffs
- Session rail state → Session bridge: subscribes events
packages/app/src/hooks/useSessionRail.ts - Application entry → Settings storage: loads settings
packages/app/src/App.tsx - Agent catalog → Manifest loading: loads manifests