How aiosai/aipass works
AIPass is a local, CLI-native workspace that scaffolds projects with persistent, collaborating AI agents. The main path is user setup or project adoption, followed by an agent conversation that can resume with identity and memory; agents share project files and can be reached through Drone for delegated work. Supporting branches provide scheduling, hooks, shared collaboration, host APIs, and backup. README statements support the high-level workflow; sampled source confirms selected notification, hook, feedback, and API behavior, but not every subsystem’s wiring.
Main entry points: aipass.py AIPass CLI · drone.py Drone CLI · post.py Shared Collaboration · init_flow.py Guided Init
Components 21
Setup & Projects
- AIPass CLI
src/aipass/aipass/apps/aipass.py - Guided Init
src/aipass/aipass/apps/modules/init_flow.py - New Project
src/aipass/aipass/apps/modules/new_project.py - Project Adoption
src/aipass/aipass/apps/modules/adopt.py - Health Check
src/aipass/aipass/apps/modules/doctor.py - Project Workspace
Agent Runtime
- Drone CLI
src/aipass/drone/apps/drone.py - Agent Registry
src/aipass/drone/apps/modules/registry.py - Memory Search
src/aipass/memory/apps/handlers/search/query_executor.py - Memory Governance
src/aipass/memory/apps/handlers/governance/engine.py - Hook Dispatcher
src/aipass/hooks/apps/modules/engine.py
Coordination
- Daemon Scheduler
src/aipass/daemon/apps/modules/schedule.py - Agent Mail
src/aipass/ai_mail/apps/modules/email.py - Shared Collaboration
src/aipass/commons/apps/modules/post.py - Commons Database
src/aipass/commons/apps/handlers/database/db.py
Workspace Services
- Backup & Restore
External Interfaces
- Host API
src/aipass/api/apps/modules/host_api.py - Integration Contracts
src/aipass/api/apps/modules/integrations_manager.py
Other components
- User
- Claude Code
- Opt-in APIs
Connections 20
- User → AIPass CLI: runs commands
- AIPass CLI → Guided Init: starts guided setup
- AIPass CLI → New Project: creates project
- AIPass CLI → Project Adoption: adopts project
- AIPass CLI → Health Check: checks health
- Guided Init → Project Workspace: scaffolds workspace
- New Project → Project Workspace: creates workspace
- Project Adoption → Project Workspace: uses directory
- Claude Code → Project Workspace: works in
- Drone CLI → Agent Registry: resolves agents
- Drone CLI → Project Workspace: dispatches work
- Project Workspace → Memory Search: stores agent memory
- Project Workspace → Memory Governance: provides surfaced items
- Claude Code → Hook Dispatcher: emits hook events
- Daemon Scheduler → Project Workspace: schedules workspace work
- Shared Collaboration → Commons Database: reads and writes
- Shared Collaboration → Agent Mail: notifies agents
- Backup & Restore → Project Workspace: snapshots files
- Host API → Project Workspace: serves workspace data
- Integration Contracts → Opt-in APIs: invokes contracts