How gultar/aether-web works
Aether-Web is a local-first, browser-based desktop workspace. A user works through its desktop shell and application windows; the shell exposes productivity tools, system features, and a separate OS agent, while local Node.js and optional Python services provide integrations and AI. The graph preserves the documented capabilities even where their implementations were not sampled. Some subsystem connections are based on README descriptions rather than inspected call sites; those edges cite the README.
Main entry points: init.js Desktop shell · web_main.py Agent service · server.js Local Node service · terminal.js Terminal
Components 23
Desktop shell
- Desktop shell
js/dashboard/init.js - Window manager
js/window-manager/create-window.js - Appearance and layout
js/dashboard/appearance.js - Dock and launcher
js/dashboard/dock.js - System monitor
js/dashboard/system.js - Terminal
js/terminal/terminal.js
Productivity apps
- Scheduled tasks UI
js/dashboard/cron.js - Outlook calendar
private/calendar/outlook_ics.js - Geomancy app
apps/geomancy/geomancy-app.js
AI agents
- Tiny Agent UI
private/tiny-web-agent/static/app.js - OS agent UI
js/dashboard/os-agent.js - Skills routing
private/tiny-web-agent/skill_manager.py - Agent service
private/tiny-web-agent/web_main.py - Conversation runtime
private/tiny-web-agent/web_agent.py - Tool registry
private/tiny-web-agent/tools/tool_registry.py - Research pipeline
private/tiny-web-agent/research_pipeline.py - Document attachments
private/tiny-web-agent/tools/attachments.py
Local services
- Persistent scheduler
private/cron/cron_scheduler.js - Local Node service
server.js - Voice transcription
private/voice/whisper_worker.py
Other components
- User
- Local LLM
- Published Outlook feed
Connections 24
- User → Desktop shell: uses
- Desktop shell → Window manager: opens windows
- Desktop shell → Appearance and layout: configures
- Desktop shell → Dock and launcher: launches apps
- Desktop shell → System monitor: offers monitoring
- Desktop shell → Terminal: opens
- Desktop shell → Tiny Agent UI: opens
- Desktop shell → OS agent UI: opens
- Desktop shell → Scheduled tasks UI: opens
- Desktop shell → Geomancy app: launches
- Tiny Agent UI → Agent service: sends chat requests
- OS agent UI → Agent service: sends OS requests
private/tiny-web-agent/web_main.py - Agent service → Skills routing: routes skills
private/tiny-web-agent/web_main.py - Agent service → Conversation runtime: runs agent turn
private/tiny-web-agent/web_main.py - Conversation runtime → Tool registry: loads tools
private/tiny-web-agent/web_agent.py - Agent service → Research pipeline: uses research
private/tiny-web-agent/web_main.py - Agent service → Document attachments: handles attachments
private/tiny-web-agent/web_main.py - Conversation runtime → Local LLM: runs inference
- Scheduled tasks UI → Local Node service: manages tasks
- Local Node service → Persistent scheduler: schedules and stores
server.js - Local Node service → Outlook calendar: serves calendar data
server.js - Outlook calendar → Published Outlook feed: reads ICS feed
- Terminal → Local Node service: uses local services
- Terminal → Voice transcription: sends audio