File Manifest

Complete listing of all source files in the Parachute codebase, organized by component and feature.

Summary Statistics

247
Flutter App Files
78,240 lines of Dart
81
Python Computer Files
23,273 lines of Python
328
Total Source Files
101,513 total lines

Flutter App (app/lib/)

Unified mobile and desktop application built with Flutter and Riverpod.

Entry Point

File Lines Purpose
main.dart 695 App initialization, routing, and theme configuration

Core Module (14,559 lines)

Core infrastructure and shared services.

Providers

File Lines Purpose
app_state_provider.dart 464 Global app state management
sync_provider.dart 614 Vault sync orchestration
feature_flags_provider.dart 111 Feature flag management
server_providers.dart 84 Server connection state
streaming_voice_providers.dart 73 Voice streaming state
file_system_provider.dart 72 File system access state
lima_vm_provider.dart 67 Lima VM state

Services - Server & System

File Lines Purpose
sync_service.dart 1,396 Vault synchronization engine
streaming_voice_service.dart 1,177 Real-time voice streaming
file_system_service.dart 1,127 File system operations
bare_metal_server_service.dart 989 Bare metal server management
lima_vm_service.dart 808 Lima VM management
base_server_service.dart 697 Computer server communication
bundled_server_service.dart 478 Bundled server operations
logging_service.dart 446 Logging infrastructure
model_download_service.dart 418 Model download management
deep_link_service.dart 361 Deep link handling

Services - AI/Transcription

File Lines Purpose
sherpa_onnx_service.dart 710 Local ONNX transcription
audio_service.dart 685 Audio capture/playback
sherpa_onnx_isolate.dart 356 Isolate-based ONNX runner
parakeet_service.dart 345 Parakeet model transcription
transcription_service_adapter.dart 312 Transcription abstraction
smart_chunker.dart 239 Smart audio chunking
simple_vad.dart 175 Voice activity detection

Chat Feature (21,855 lines)

Conversational AI interface and session management.

Key Files

File Lines Purpose
chat_providers.dart 2,079 Chat state management & logic
chat_service.dart 2,059 Chat logic & API calls
message_bubble.dart 1,570 Message display widget
chat_screen.dart 1,318 Main chat interface
chat_input.dart 1,076 Chat input/submission widget
curator_session_viewer_sheet.dart 1,042 Curator session viewer
agent_hub_screen.dart 859 Agent browser/selector
claude_code_import_screen.dart 776 Claude Code integration
collapsible_thinking_section.dart 774 Extended thinking display
session_info_sheet.dart 730 Session info display
context_file_viewer_screen.dart 719 File context viewer

Models

File Lines Purpose
curator_session.dart 361 Curator session metadata
session_transcript.dart 343 Session transcript storage
attachment.dart 284 File attachment handling
typed_error.dart 279 Error type definitions
chat_message.dart 275 Message data structure
chat_session.dart 222 Chat session metadata
prompt_metadata.dart 220 Prompt metadata storage

Daily Feature (23,101 lines)

Journal, recording, and reflection system.

Journal Core

File Lines Purpose
journal_screen.dart 2,156 Main journal UI
journal_input_bar.dart 1,379 Input bar with voice/text
journal_service.dart 1,261 Journal operations
journal_entry_row.dart 992 Entry row in list
journal_entry_card.dart 606 Entry card display
journal_providers.dart 593 Journal state & logic
entry_edit_modal.dart 572 Entry editing modal
curator_log_screen.dart 550 Curator log viewer
agent_output_header.dart 511 Agent output header
journal_merge_service.dart 468 Journal merge/sync

Recorder Services

File Lines Purpose
omi_capture_service.dart 610 Omi device capture
live_transcription_service.dart 547 Live transcription engine
omi_connection.dart 409 Omi connection management
omi_bluetooth_service.dart 406 Bluetooth communication
background_recording_service.dart 401 Background recording
streaming_audio_recorder.dart 400 Audio recording stream
transcription_queue.dart 346 Transcription queue management
device_connection.dart 272 Device connection

Vault Feature (4,020 lines)

File browser and document viewer.

File Lines Purpose
markdown_viewer_screen.dart 857 Markdown file viewer
remote_markdown_viewer_screen.dart 547 Remote markdown viewer
remote_files_screen.dart 546 Remote file browser
files_screen.dart 519 Local file browser
text_viewer_screen.dart 430 Local text viewer
remote_text_viewer_screen.dart 382 Remote text viewer
file_browser_service.dart 233 File browsing
remote_file_browser_service.dart 199 Remote file browsing
file_browser_provider.dart 116 File browser state
file_item.dart 112 File metadata

Settings Feature (4,573 lines)

App configuration and setup.

File Lines Purpose
settings_screen.dart 1,937 Main settings UI
computer_setup_wizard.dart 1,805 Parachute Computer setup
parachute_computer_section.dart 653 Computer settings
api_key_section.dart 631 API key management
lima_vm_section.dart 606 Lima VM settings
bare_metal_section.dart 572 Bare metal configuration
omi_device_section.dart 477 Omi device settings

Python Computer (computer/parachute/)

AI orchestration server built with FastAPI.

Entry Points & Server

File Lines Purpose
server.py 296 FastAPI server initialization
mcp_server.py 694 MCP (Model Context Protocol) server
config.py 99 Configuration management

API Routes Module (4,810 lines)

File Lines Purpose
api/modules.py 785 Module management endpoints
api/sync.py 533 Vault synchronization endpoints
api/imports.py 450 Import handling endpoints
api/claude_code.py 446 Claude Code integration
api/mcp.py 420 MCP server management
api/sessions.py 298 Session management endpoints
api/bots.py 298 Bot connector endpoints
api/workspaces.py 253 Workspace management endpoints
api/skills.py 264 Skills management
api/context_folders.py 253 Context folder endpoints
api/chat.py 234 Chat endpoints
api/filesystem.py 230 File system endpoints
api/auth.py 173 Authentication endpoints
api/prompts.py 122 Prompt endpoints
api/scheduler.py 103 Job scheduler endpoints
api/health.py 98 Health check endpoints
api/usage.py 92 Usage tracking endpoints

Core Module (9,568 lines)

Orchestration

File Lines Purpose
core/orchestrator.py 1,336 Agent orchestration engine
core/session_manager.py 850 Session lifecycle management
core/permission_handler.py 752 Permission & access control
core/chat_log.py 424 Chat log operations
core/claude_sdk.py 311 Claude SDK integration
core/orchestrator_tools.py 272 Orchestration tools

Module System & Connectors

File Lines Purpose
core/module_loader.py 240 Module discovery & loading
core/interfaces.py 37 Module interface definitions
core/sandbox.py 286 Docker sandbox management
connectors/base.py 349 Bot connector base class
connectors/telegram.py 707 Telegram bot connector
connectors/discord_bot.py 441 Discord bot connector
connectors/config.py 71 Bot connector configuration

Daily & Reflection

File Lines Purpose
core/daily_agent.py 465 Daily reflection agent
core/daily_agent_tools.py 384 Daily agent tools

Imports & Context

File Lines Purpose
core/import_service.py 524 Import orchestration
core/scheduler.py 332 Job scheduling
core/context_folders.py 306 Context folder logic
core/migrate_contexts.py 292 Context migration
core/skills.py 291 Skills management
core/agents.py 251 Agent management
core/claude_usage.py 231 Token usage tracking
core/context_parser.py 128 Context parsing

Database Module (841 lines)

File Lines Purpose
db/database.py 834 SQLite database operations

Library/Utilities Module (1,906 lines)

File Lines Purpose
lib/mcp_loader.py 448 MCP server loader
lib/typed_errors.py 318 Type-safe error definitions
lib/ignore_patterns.py 255 Gitignore pattern handling
lib/permissions.py 234 Permission utilities
lib/vault_utils.py 188 Vault utilities
lib/agent_loader.py 178 Agent loader
lib/server_config.py 175 Server configuration
lib/context_loader.py 150 Context loader
lib/auth.py 136 Authentication utilities
lib/logger.py 108 Logging setup
lib/para_id.py 66 Paragraph ID utilities

Models Module (749 lines)

File Lines Purpose
models/events.py 316 Event definitions
models/session.py 221 Session models
models/requests.py 171 Request schemas
models/agent.py 141 Agent models

Hooks Module (403 lines)

File Lines Purpose
hooks/activity_hook.py 400 Activity tracking hooks