How wysl-2/aiprojectorganizer works
AI Project Organizer is a desktop application for organizing project workspaces into documents, features, and implementation packages. Users open or create a project, browse and edit its files, manage feature/package structure, and inspect or install package contents. The UI coordinates these workflows; project metadata, workspace structure, and package archive handling provide the domain layer. Evidence is limited to the supplied excerpts and SOURCE INDEX; links for unsampled UI behavior are omitted unless directly supported.
Main entry points: app.py Desktop Startup · main_window.py Main Window · project_view.py Project View · package_workspace_panel.py Package Workspace
Components 18
Application
- Desktop Startup
src/ai_project_organizer/app.py - Main Window
src/ai_project_organizer/ui/main_window.py - Application Theme
src/ai_project_organizer/ui/theme.py - UI Resources
src/ai_project_organizer/ui/resources.py
Projects and Workspaces
- Project Metadata
src/ai_project_organizer/project.py - Project Registry
src/ai_project_organizer/project_registry.py - Metadata Form
src/ai_project_organizer/ui/project_metadata_form.py
Workspace Organization
- Project View
src/ai_project_organizer/ui/project_view.py - Workspace Structure
src/ai_project_organizer/workspace_structure.py - Path Boundaries
src/ai_project_organizer/workspace_paths.py - File Browser
src/ai_project_organizer/ui/file_tree.py - Document List
src/ai_project_organizer/ui/document_list_panel.py - Section Panel
src/ai_project_organizer/ui/section_panel.py
Implementation Packages
- Package Workspace
src/ai_project_organizer/ui/package_workspace_panel.py - Package Drop List
src/ai_project_organizer/ui/implementation_package_drop_list.py - Package Archive Logic
src/ai_project_organizer/implementation_package.py - Package Install Dialog
src/ai_project_organizer/ui/package_install_dialog.py
Other components
- User
Connections 13
- User → Desktop Startup: starts
src/ai_project_organizer/app.py - Desktop Startup → Application Theme: applies
src/ai_project_organizer/app.py - Desktop Startup → Main Window: opens
src/ai_project_organizer/app.py - Project Metadata → Workspace Structure: initializes
src/ai_project_organizer/project.py - File Browser → Path Boundaries: checks boundaries
src/ai_project_organizer/ui/file_tree.py - Project View → Workspace Structure: reads structure
src/ai_project_organizer/ui/project_view.py - Main Window → Project View: sets workspace
src/ai_project_organizer/ui/main_window.py - Main Window → Package Install Dialog: handles install
src/ai_project_organizer/ui/main_window.py - Project View → Package Workspace: embeds panel
src/ai_project_organizer/ui/project_view.py - Package Workspace → Package Archive Logic: uses package logic
src/ai_project_organizer/ui/package_workspace_panel.py - Package Workspace → Package Drop List: uses drop list
src/ai_project_organizer/ui/package_workspace_panel.py - Document List → Section Panel: extends
src/ai_project_organizer/ui/document_list_panel.py - Document List → UI Resources: loads icons
src/ai_project_organizer/ui/document_list_panel.py