How anoop-kumar-31/ghost-ai works
Ghost AI is a floating desktop chat workspace: users open or create conversations, configure a provider, submit prompts, and receive streamed responses; they can also transcribe microphone or system audio into the composer for review. The main window coordinates chat/history views and persists workspace state. Separate branches cover provider configuration and credentials, voice transcription, and native window behavior. The graph follows the supplied excerpts and SOURCE INDEX; some documented capabilities, including attachments and shortcuts, are not separately mapped because their implementation details were not shown.
Main entry points: main_window.py Main window · chat_view.py Chat composer · ai_service.py AI request worker · config.py Provider configuration
Components 23
Desktop workspace
- Main window
ghost_ai/main_window.py - Header and tabs
ghost_ai/header_bar.py - Window controls
ghost_ai/controls.py - Icon rendering
ghost_ai/icon_manager.py
Conversation experience
- Chat history
ghost_ai/history_view.py - Chat composer
ghost_ai/chat_view.py - Markdown rendering
ghost_ai/markdown_renderer.py - Voice transcription
ghost_ai/voice_worker.py
AI and configuration
- Settings dialog
ghost_ai/settings_dialog.py - Provider configuration
ghost_ai/config.py - AI request worker
ghost_ai/ai_service.py
Local privacy
- Workspace persistence
ghost_ai/persistence.py - Local chat data
- Credential management
ghost_ai/secure_store.py
Platform integration
- Platform dispatch
ghost_ai/platform_utils.py - Windows integration
ghost_ai/win32_utils.py - macOS integration
ghost_ai/macos_utils.py
Other components
- Desktop user
- Application launcher
main.py - AI provider APIs
- OS credential store
- Native window APIs
- Audio input devices
Connections 30
- Desktop user → Application launcher: launches
main.py - Application launcher → Main window: starts
main.py - Desktop user → Main window: uses
README.md - Main window → Header and tabs: coordinates
ghost_ai/main_window.py - Main window → Chat history: updates
ghost_ai/main_window.py - Main window → Chat composer: coordinates
ghost_ai/main_window.py - Main window → Workspace persistence: loads and saves
ghost_ai/main_window.py - Main window → Window controls: uses
ghost_ai/main_window.py - Main window → Platform dispatch: uses
ghost_ai/main_window.py - Chat composer → AI request worker: starts requests
ghost_ai/chat_view.py - AI request worker → AI provider APIs: sends requests
ghost_ai/ai_service.py - AI request worker → Provider configuration: uses provider settings
ghost_ai/ai_service.py - Chat composer → Provider configuration: loads configuration
ghost_ai/chat_view.py - Chat composer → Voice transcription: starts transcription
ghost_ai/chat_view.py - Voice transcription → Audio input devices: captures audio
README.md - Chat composer → Markdown rendering: renders responses
ghost_ai/chat_view.py - Chat composer → Icon rendering: uses icons
ghost_ai/chat_view.py - Chat history → Icon rendering: uses icons
ghost_ai/history_view.py - Header and tabs → Icon rendering: uses icons
ghost_ai/header_bar.py - Main window → Settings dialog: opens
ghost_ai/main_window.py - Settings dialog → Provider configuration: loads and saves
ghost_ai/settings_dialog.py - Settings dialog → AI request worker: tests connection
ghost_ai/settings_dialog.py - Provider configuration → Credential management: loads API keys
ghost_ai/config.py - Workspace persistence → Credential management: gets encryption key
ghost_ai/persistence.py - Credential management → OS credential store: stores credentials
ghost_ai/secure_store.py - Workspace persistence → Local chat data: reads and writes
README.md - Platform dispatch → Windows integration: dispatches on Windows
ghost_ai/platform_utils.py - Platform dispatch → macOS integration: dispatches on macOS
ghost_ai/platform_utils.py - Windows integration → Native window APIs: controls windows
- macOS integration → Native window APIs: controls windows