How djoahp/logassist works
LogAssist is a Tauri desktop AI assistant. The main workflow runs from the user composing a chat turn, through context preparation and a configured LLM provider, to streamed, persisted and rendered replies; optional MCP/Web and GitHub tools extend that turn. SQLite holds conversations and knowledge, while API credentials stay in the Windows credential store. The graph retains documented settings, recovery, export and security-related capabilities. Source excerpts limit certainty about some runtime wiring, so undocumented links are omitted.
Main entry points: useChat.ts Turn orchestration · prepareConversationContext.ts Context preparation · App.tsx Desktop shell · ChatView.tsx Chat interface
Components 31
Conversation experience
- Desktop shell
src/App.tsx - Chat interface
src/components/chat/ChatView.tsx - Message composer
src/components/chat/InputBar.tsx - Turn orchestration
src/hooks/useChat.ts - Conversation navigation
src/components/sidebar/Sidebar.tsx
Models and context
- Provider settings
src/components/settings/ProvidersDialog.tsx - LLM adapters
src/lib/ai/openai-compat.ts - Context preparation
src/lib/chat/prepareConversationContext.ts - Context planning
src/lib/context/contextPlanner.ts - Knowledge retrieval
src/lib/context/knowledgeRetriever.ts - Prompt settings
src/lib/prompts/store.ts - Token metrics
src/lib/token/estimate.ts
Tools and integrations
- MCP and Web settings
src/components/settings/McpDialog.tsx - MCP runtime
src/lib/mcp/runtime.ts - Tool agent
src/lib/mcp/toolAgent.ts - MCP IPC client
src/lib/mcp/client.ts - MCP service
src-tauri/src/mcp/client.rs - MCP transport
src-tauri/src/mcp/transport.rs - GitHub connector UI
src/components/settings/GithubConnectorDialog.tsx - GitHub IPC client
src/lib/connectors/client.ts - GitHub service
src-tauri/src/connectors/service.rs
Persistence and security
- SQLite database
src/lib/db/database.ts - Conversation storage
src/lib/db/conversations.ts - Knowledge storage
src/lib/db/knowledge.ts - Message storage
src/lib/db/messages.ts - Credential Manager
- Markdown export
src/lib/export.ts
Other components
- User
- LLM provider
- TinyFish Web
- GitHub API
Connections 37
- User → Desktop shell: uses
- Desktop shell → Chat interface: shows
src/App.tsx - Desktop shell → Conversation navigation: shows
src/App.tsx - User → Message composer: composes
- Message composer → Turn orchestration: submits
src/components/chat/InputBar.tsx - Chat interface → Turn orchestration: renders
src/components/chat/ChatView.tsx - Turn orchestration → Context preparation: prepares context
src/hooks/useChat.ts - Context preparation → Context planning: plans tokens
src/lib/chat/prepareConversationContext.ts - Context preparation → Knowledge retrieval: retrieves passages
src/lib/chat/prepareConversationContext.ts - Context preparation → Prompt settings: loads prompts
src/lib/chat/prepareConversationContext.ts - Context preparation → Knowledge storage: loads knowledge
src/lib/chat/prepareConversationContext.ts - Turn orchestration → LLM adapters: creates provider
src/hooks/useChat.ts - Turn orchestration → LLM provider: streams request
- LLM provider → Turn orchestration: streams response
- Turn orchestration → Message storage: persists messages
src/hooks/useChat.ts - Turn orchestration → Conversation storage: updates conversation
src/hooks/useChat.ts - Chat interface → Token metrics: formats metrics
src/components/chat/ChatView.tsx - Provider settings → LLM provider: configures access
- Turn orchestration → MCP runtime: uses tools
src/hooks/useChat.ts - MCP runtime → MCP IPC client: calls
src/lib/mcp/runtime.ts - MCP IPC client → MCP service: invokes commands
src/lib/mcp/client.ts - MCP service → MCP transport: delegates connections
src-tauri/src/mcp/client.rs - MCP transport → TinyFish Web: calls
- Turn orchestration → Tool agent: dispatches tools
src/hooks/useChat.ts - Tool agent → LLM provider: requests tool decisions
src/lib/mcp/toolAgent.ts - MCP and Web settings → MCP runtime: configures
- Turn orchestration → GitHub IPC client: calls connector tools
src/hooks/useChat.ts - GitHub connector UI → GitHub IPC client: configures connector
- GitHub IPC client → GitHub service: invokes commands
src/lib/connectors/client.ts - GitHub service → GitHub API: reads repository
src-tauri/src/connectors/service.rs - Conversation storage → SQLite database: reads and writes
src/lib/db/conversations.ts - Knowledge storage → SQLite database: reads and writes
- Message storage → SQLite database: reads and writes
- Desktop shell → Conversation storage: loads conversations
src/App.tsx - Turn orchestration → Credential Manager: loads provider key
- GitHub service → Credential Manager: uses GitHub token
- Turn orchestration → Markdown export: exports conversation