How teoritty/xquakshell works
xQuakShell is a portable remote-access desktop application: users unlock an encrypted vault, select a saved connection, and open a tab for an SSH or plugin-provided session; they can then use terminal, file-transfer, and forwarding capabilities. The frontend also manages local-terminal tabs, plugins, trust prompts, settings, and audit history. The README documents these product capabilities, while sampled frontend excerpts show session orchestration and tab routing. Backend internals are only partly sampled, so several UI-to-backend and unsampled subsystem links are marked unverified.
Main entry points: sessionActions.ts Session orchestration · App.svelte Desktop workspace · session_lifecycle_service.go Session services · tabActions.ts Tab routing
Components 22
Workspace
- Desktop workspace
frontend/src/App.svelte - Application state
frontend/src/stores/appState.ts - Runtime events
frontend/src/events/subscribe.ts - Tab routing
frontend/src/actions/tabActions.ts
Connections and sessions
- Connection management
frontend/src/lib/ConnectionDetails.svelte - Session orchestration
frontend/src/actions/sessionActions.ts - Session API
frontend/src/api/sessions.ts - Session services
internal/usecase/session_lifecycle_service.go - Terminal sessions
frontend/src/lib/terminalPool.ts - SFTP and transfers
internal/infra/sftp/client.go - Local terminal
frontend/src/actions/localTerminalActions.ts
Plugin platform
- Plugin management UI
frontend/src/lib/plugins/PluginsDialog.svelte - Plugin management
internal/usecase/plugin_manager.go - Plugin process and IPC
internal/infra/plugin/process_host.go
Vault and trust
- Vault interface
frontend/src/lib/VaultUnlock.svelte - Encrypted vault storage
internal/infra/vault/storage.go - Host-key verification
internal/domain/ssh_stack.go - Audit log
internal/infra/auditlog/repository.go
Operations and settings
- Settings and locale
frontend/src/actions/settingsActions.ts - Audit log viewer
internal/presentation/logwindow/manager.go - Desktop backend
app.go
Other components
- User
Connections 26
- User → Desktop workspace: uses
README.md - Desktop workspace → Vault interface: gates workspace
frontend/src/App.svelte - Desktop workspace → Session orchestration: opens sessions
frontend/src/App.svelte - Desktop workspace → Tab routing: routes tab actions
frontend/src/App.svelte - Session orchestration → Session API: opens and closes
frontend/src/actions/sessionActions.ts - Session orchestration → Application state: updates session state
frontend/src/actions/sessionActions.ts - Tab routing → Session orchestration: closes sessions
frontend/src/actions/tabActions.ts - Tab routing → Local terminal: closes local tabs
frontend/src/actions/tabActions.ts - Session orchestration → Terminal sessions: transfers terminal
frontend/src/actions/sessionActions.ts - Runtime events → Application state: updates from events
frontend/src/events/subscribe.ts - User → Connection management: configures access
README.md - User → SFTP and transfers: transfers files
README.md - Session API → Desktop backend: calls backend
- Desktop backend → Session services: dispatches sessions
- Session services → Terminal sessions: serves terminal sessions
- User → Local terminal: opens local tab
README.md - User → Plugin management UI: manages plugins
README.md - Plugin management UI → Plugin management: requests installation
- Plugin management → Plugin process and IPC: starts plugin process
- Plugin process and IPC → Session services: contributes protocols
README.md - User → Vault interface: unlocks vault
README.md - Vault interface → Encrypted vault storage: unlocks encrypted data
- Session services → Host-key verification: verifies host keys
README.md - User → Settings and locale: changes preferences
README.md - User → Audit log viewer: reviews audit log
README.md - Audit log viewer → Audit log: reads audit records