How mohammednoordehalvi/noor-ai-studio works
Noor AI Studio is a local desktop command center for coordinating AI-assisted project work. Its main workflow is: a user creates a Project Head mission, Noor inspects the project and proposes a dependency-aware plan, the user approves it, specialists execute through configured providers, and Noor validates the work and offers reversible review. The README also describes Shared Room conversations, provider management, project tools, and manual Antigravity handoff. Several source excerpts are partial, so links for unsampled UI and runtime details rely on README statements or the SOURCE INDEX rather than inspection of those implementations.
Main entry points: project-head.cjs Mission lifecycle · app.js Command center UI · main.cjs Desktop IPC runtime · providers.cjs Provider manager
Components 21
Desktop experience
- Command center UI
renderer/app.js - Command palette
renderer/command-palette.js - Desktop IPC runtime
src/main.cjs - Renderer bridge
src/preload.cjs
Project Head missions
- Mission lifecycle
src/lib/project-head.cjs - Project inspection
src/lib/project-inspector.cjs - Plan prompts
src/lib/project-head-prompt.cjs - Task dependencies
src/lib/task-graph.cjs - Approval policy
src/lib/command-policy.cjs - Edit checkpoints
src/lib/checkpoint-manager.cjs
AI collaboration
- Agent orchestration
src/lib/orchestrator.cjs - Provider manager
src/lib/providers.cjs - Specialist routing
src/lib/provider-router.cjs - Model registry
src/lib/model-registry.cjs - Shared Room journal
src/lib/shared-context.cjs
Project tools and safety
- Project file safety
src/lib/fs-utils.cjs - Backup and restore
src/lib/backup.cjs - Process utilities
src/lib/process-utils.cjs
Local state
- Application state
src/lib/store.cjs - Atomic file writes
src/lib/atomic-file.cjs
Other components
- User
Connections 32
- User → Command center UI: uses
README.md - Command center UI → Renderer bridge: requests actions
- Renderer bridge → Desktop IPC runtime: bridges IPC
- Desktop IPC runtime → Mission lifecycle: dispatches mission actions
src/main.cjs - Desktop IPC runtime → Agent orchestration: dispatches room and run actions
src/main.cjs - Desktop IPC runtime → Provider manager: manages providers
src/main.cjs - Desktop IPC runtime → Application state: loads state
src/main.cjs - Desktop IPC runtime → Shared Room journal: manages contexts
src/main.cjs - Mission lifecycle → Project inspection: inspects project
src/lib/project-head.cjs - Mission lifecycle → Plan prompts: builds plan prompts
src/lib/project-head.cjs - Mission lifecycle → Task dependencies: normalizes dependencies
src/lib/project-head.cjs - Mission lifecycle → Specialist routing: selects specialists
src/lib/project-head.cjs - Mission lifecycle → Approval policy: applies approval modes
src/lib/project-head.cjs - Mission lifecycle → Edit checkpoints: protects edits
src/lib/project-head.cjs - Mission lifecycle → Agent orchestration: delegates work
src/lib/project-head.cjs - Agent orchestration → Provider manager: requests provider work
src/lib/orchestrator.cjs - Agent orchestration → Shared Room journal: reads and appends context
src/lib/orchestrator.cjs - Agent orchestration → Backup and restore: snapshots and reviews edits
src/lib/orchestrator.cjs - Specialist routing → Shared Room journal: labels providers
src/lib/provider-router.cjs - Provider manager → Model registry: uses model definitions
src/lib/providers.cjs - Provider manager → Process utilities: runs local processes
src/lib/providers.cjs - Shared Room journal → Atomic file writes: writes index atomically
src/lib/shared-context.cjs - Application state → Model registry: migrates model IDs
src/lib/store.cjs - Application state → Atomic file writes: writes state atomically
src/lib/store.cjs - Backup and restore → Project file safety: snapshots project files
src/lib/backup.cjs - Backup and restore → Atomic file writes: writes backup atomically
src/lib/backup.cjs - Edit checkpoints → Backup and restore: creates and restores snapshots
src/lib/checkpoint-manager.cjs - Command center UI → Command palette: offers command navigation
README.md - Command center UI → Project file safety: supports project file tools
- Command center UI → Process utilities: offers terminal and validation
- Command center UI → Provider manager: configures connected providers
README.md - Provider manager → User: connects to model services
README.md