Documentation Inventory
This inventory was generated from read-only inspection of local OrganicOS source trees, notes, scripts, configuration files, service units, launchers, diagnostics, and the existing Nebula system map.
It is not final product documentation. It is the starting queue for documentation work. Anything not fully verified from local project evidence is marked Needs Review.
Evidence Sources
Section titled “Evidence Sources”/home/shane1806481/organicos/home/shane1806481/dev/organic-glass/home/shane1806481/dev/organic-os-decoration/home/shane1806481/dev/input-nebula/home/shane1806481/dev/moonlight-nebula-filedrop/home/shane1806481/dev/plasma-wallpaper-application/home/shane1806481/HomeDevNovaGlassEngineCapture/home/shane1806481/NebulaAI/home/shane1806481/.openclaw/workspace/organic-os/home/shane1806481/.config/systemd/user/home/shane1806481/.local/bin/home/shane1806481/.local/share/applications/home/shane1806481/shared/linux-port-handoff/home/shane1806481/shared/windows-port-handoff/home/shane1806481/organicos-wsl2-package.sh/home/shane1806481/organicos-wsl2-package.test.sh
The existing Nebula system map database reports mapped asset counts: 9 integrations, 341 launchers, 60 mounts, 76 Plasma packages, 146 ports, 5 project roots, 90 services, and 91 service files. It also reports a warning that the Nebula AI Drive is mounted more than once.
Sensitive Documentation Notes
Section titled “Sensitive Documentation Notes”/home/shane1806481/dev/moonlight-nebula-filedrop/WINDOWS-CODEX-HANDOFF.mdcontains a file-drop token. Do not publish it as-is./home/shane1806481/shared/windows-port-handoff/OrganicOS-WSL2-Linux-Handoff.mdsays credential-bearing user state was intentionally preserved in the WSL artifact. Treat WSL documentation and artifacts as security-sensitive.- Any public release documentation must include a redaction pass for tokens, keys, browser/session state, private hostnames, LAN addresses, and tailnet-only endpoints.
Core System Inventory
Section titled “Core System Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| OrganicOS vision and architecture | .openclaw/workspace/organic-os/VISION.md, ARCHITECTURE.md, SUBSYSTEMS.md |
Vision, architecture, subsystem boundaries, current vs future state | Needs Review |
| OrganicOS system map | .openclaw/workspace/organic-os/SYSTEM_MAP.md, NebulaAI/system-map/system-map.sqlite |
Canonical project roots, services, ports, launchers, stale areas, map update process | Needs Review |
| OrganicOS Portal | /home/shane1806481/dev/organicos-portal |
Local startup, docs authoring, search/versioning plan, public release path | Draft |
| OrganicOS installation | WSL packager, shell/theme staging, service files | Fresh install, upgrade, local dev setup, image/bake process | Needs Review |
| OrganicOS configuration | .config, .local/share/organicos, service units, launchers |
Config file locations, precedence, safe edit rules, reset paths | Needs Review |
| OrganicOS diagnostics | TODAY_DIAGNOSTIC_2026-04-21.md, diagnostics scripts, logs noted in source trees |
Health checks, runtime snapshots, common diagnostic commands | Needs Review |
| Troubleshooting | Existing diagnostics, service logs, test files, recovery notes | Common failures, service restart paths, port conflicts, UI recovery | Needs Review |
| Recovery | freeze points, WSL handoff, backup-heavy roots, staged artifacts | Rollback, restore points, clean recovery, artifact validation | Needs Review |
| Security and public release redaction | sensitive handoff notes, WSL artifact report, service/env references | Secret handling, redaction checklist, local-only vs public-safe content | Needs Review |
Desktop, Shell, and UI Inventory
Section titled “Desktop, Shell, and UI Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| OrganicOS KDE shell bundle | dev/organic-os-decoration/organic-os-shell/README.md |
Included themes, icons, cursors, defaults, staged install behavior | Needs Review |
| KDecoration / OrganicOS window decoration | dev/organic-os-decoration/kdecoration/*.cpp, *.h, organicdecoration.json |
Build, install, configuration, exception rules, theme behavior | Needs Review |
| OrganicOS application style | dev/organic-os-decoration/organic-os-style |
Style plugin purpose, build/install, settings, limitations | Needs Review |
| OrganicOS color scheme, icon theme, cursor theme | organic-os-shell/color-schemes, icons, cursors |
Asset provenance, install locations, customization rules | Needs Review |
| SDDM / login theme | organic-os-shell/sddm-theme/organic-os-login |
Login theme install, defaults, rollback | Needs Review |
| Organic boot wallpaper assets | organic-os-shell/wallpapers/organic-boot, Organic Glass assets |
Wallpaper/boot media usage, file formats, performance notes | Needs Review |
| Plasma application wallpaper substrate | dev/plasma-wallpaper-application/README.md, QML files |
Installation, Xwayland behavior, performance, OrganicOS-specific usage | Needs Review |
| Moonlight Nebula wallpaper | freeze points, wallpaper scripts, system-map notes | Runtime model, launch commands, diagnostics, known-good baselines | Needs Review |
| Organic AI live wallpaper | /home/shane1806481/organic-ai-live-wallpaper |
Source purpose, build/install, relation to wallpaper substrate | Needs Review |
| OrganicOS terminal dock | .local/bin/organic-os-terminal-dock, shell bundle README |
Launcher behavior, titlebar integration, configuration | Needs Review |
| Plasma Users KCM override | organicos/plasma/USERS_KCM_OVERRIDE.md, QML files |
What is overridden, assistant account UI, limitations | Needs Review |
| Assistant Accounts | organicos/assistant_accounts/README.md, assistantctl.py, ACCOUNT_SCHEMA.md |
Data schema, CLI, lifecycle, policy, Plasma integration | Needs Review |
| AI Settings stack | organicos/AI_SETTINGS_STACK.md, PLASMA_AI_INTEGRATION_PLAN.md |
KCM information architecture, voice/accessibility/runtime settings | Needs Review |
| Organic crystallize effect | organicos/effects/organic-crystallize.html |
Effect purpose, usage, integration status | Needs Review |
Organic Glass Inventory
Section titled “Organic Glass Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| Organic Glass app shell | dev/organic-glass/package.json, main.js, preload.js, system.tray.js |
App architecture, launch modes, process model, tray behavior | Needs Review |
| Organic Glass command socket | main.js uses ORGANIC_GLASS_COMMAND_PORT default 41235 |
JSON command protocol, actions, safety, examples | Needs Review |
| Organic Launcher | organic-launcher.html, .desktop, .local/bin launchers |
App tiles, local portals, launcher commands | Needs Review |
| Organic Nexus | organic_nexus.html, main.js actions |
File/navigation model, managed app list, media previews | Needs Review |
| Organic media panel | organic_media_panel.html, organic_nexus_media.html |
Media folders, preview behavior, controls | Needs Review |
| Nova Terminal | NovaTerminal.html, nova-terminal/ |
Terminal features, IPC, shell profiles, xterm/node-pty use | Needs Review |
| Notes, clock, calendar, appointments, world clocks | NovaNotes.html, clock_panel.html, calendar_panel.html, appointment_panel.html, world_clocks_panel.html |
Panel purpose, launch actions, storage model | Needs Review |
| Assistant panel and assistant text panel | assistant_panel.html, assistant_text_panel.html, main.js |
Wake/listen path, command forwarding, Home Assistant/OpenClaw relation | Needs Review |
| Overlay HUD | overlay-hud/README.md, overlay-hud/main.js |
HUD behavior, IPC, window rules, limitations | Needs Review |
| Kokoro Organic Glass apps | kokoro.app.js, kokoro-mini.html, kokoro-speak-out-loud.html |
TTS UI, endpoint config, voice settings, local service dependency | Needs Review |
| Chrome Kokoro side panel | chrome-kokoro-sidepanel/README.md, manifest/scripts |
Extension install, Tailscale-private endpoint, side panel/floating player | Needs Review |
| Home Assistant wrapper | home-assistant.app.js |
Local wrapper purpose, endpoint assumptions, auth boundary | Needs Review |
| OpenWebUI wrapper | nebula-open-webui.app.js, launcher/service evidence |
Local AI UI wrapper, proxy relation, startup | Needs Review |
| OpenClaw control wrapper | nebula-openclaw-control.app.js, .desktop |
Control UI, gateway dependency, port/proxy behavior | Needs Review |
| Cockpit and Jellyfin wrappers | cockpit.app.js, jellyfin.app.js |
Admin/media wrapper purpose and local endpoints | Needs Review |
| Organic Glass tests | dev/organic-glass/tests |
Test coverage, how to run, expected behavior | Needs Review |
Apollo, Moonlight, Streaming, and Windows Bridge Inventory
Section titled “Apollo, Moonlight, Streaming, and Windows Bridge Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| Apollo | .local/share/applications/apollo.desktop, .local/bin/apollo-app, package/wrapper evidence |
Role, launch path, source root, relation to Supernova | Needs Review |
| Apollo Nebula app | dev/organic-glass/apollo-nebula.*, .desktop launchers |
App shell, preload/store/probes, UI behavior | Needs Review |
| Apollo Nebula dashboard | apollo-nebula-dashboard.html, apollo-nebula-dashboard.app.js |
Dashboard purpose, controls, launch commands | Needs Review |
| Apollo Nebula KCM | apollo-nebula-kcm files in Organic Glass and freeze points |
KCM install, settings, relation to System Settings | Needs Review |
| Supernova / Apollo streaming host | .config/supernova, service/process notes, windows/linux handoffs |
Ports, configuration, service lifecycle, GPU capture settings | Needs Review |
| Moonlight Nebula Linux client | .local/share/applications/moonlight-nebula.desktop, shared/linux-port-handoff |
Build/install, host pairing, Android/phone integrations | Needs Review |
| Moonlight Nebula file drop | dev/moonlight-nebula-filedrop/README.md, service unit |
Protocol, config, service, Windows upload client, security | Needs Review |
| Windows port handoff | shared/windows-port-handoff/README.md |
Handoff layout, source provenance, build paths, exclusions | Needs Review |
| Linux port handoff | shared/linux-port-handoff/README.md |
Handoff import process, source snapshots, acceptance checks | Needs Review |
| Windows components | shared/windows-port-handoff, PowerShell setup files, Windows paths in app sources |
Windows build/setup docs, platform boundaries, artifact handling | Needs Review |
| WSL integration | organicos-wsl2-package.sh, test script, WSL handoff report |
Packaging, import, service disables, security, validation, first boot | Needs Review |
Input, Android, and Device Control Inventory
Section titled “Input, Android, and Device Control Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| Input Nebula | dev/input-nebula/package.json, main.js, service/desktop files |
App purpose, launch modes, settings, service lifecycle | Needs Review |
| Input Nebula control socket | runtime/control-protocol.js, runtime/control-socket.js |
JSON protocol, supported actions, socket path, redaction behavior | Needs Review |
| ADB discovery and pairing | dev/input-nebula/main.js IPC handlers |
Device discovery, QR pairing, trusted wireless, troubleshooting | Needs Review |
| scrcpy phone mirroring | dev/input-nebula/main.js, launch scripts |
Launch/stop, opacity/title settings, process recovery | Needs Review |
| Phone shell | dev/input-nebula/main.js phone shell handlers |
Profiles, PTY behavior, start/stop/write/read/resize | Needs Review |
| Input Leap | dev/input-nebula, dev/input-leap-nebula, service evidence |
Shared keyboard/mouse setup, supervisor, config, recovery | Needs Review |
| DroidCam / VNC phone tools | input-nebula handlers and launchers |
Tool prerequisites, start/stop, ports, known failures | Needs Review |
| Waydroid / Android runtime | system-map notes and WSL exclusion report | What is active, what is excluded from WSL, setup limits | Needs Review |
AI, Voice, and Automation Inventory
Section titled “AI, Voice, and Automation Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| Nebula core | NebulaAI/core/progress/CODEX_NEBULA_PROGRESS.md, skills/nebula-core/SKILL.md |
Architecture, startup order, local stack, memory rules | Needs Review |
| Nebula Reflex | NebulaAI/tools/mcp/nebula-reflex/README.md, code/tests/modules |
Catalog schema, commands, MCP tools, Kokoro audio cache, testing | Needs Review |
| Nebula module packs | NebulaAI/modules/*/{module.json,docs.md,actions.json,responses.json,skills.json} |
Module conventions, action metadata, response/audio lifecycle | Needs Review |
| Nebula System Map MCP | NebulaAI/tools/mcp/nebula-system-map |
Scanner scope, asset types, SQLite schema, MCP tools, findings | Needs Review |
| Nebula Event Recorder | NebulaAI/tools/nebula-event-recorder and service |
HMAC events, routes, storage, hot-path usage | Needs Review |
| Nebula Home Assistant MCP | NebulaAI/tools/mcp/nebula-homeassistant |
Tools, auth model, inventory, service calls, safety | Needs Review |
| Nebula voice media router | NebulaAI/tools/mcp/nebula-reflex/voice_router.py, nebula-voice-media.service |
MP3 serving, Home Assistant cast playback, LAN exposure | Needs Review |
| Hermes fork/dashboard/gateway | NebulaAI/hermes-fork/codex-nebula, Hermes services |
Dashboard, gateway, MCP connection, API server, auth boundaries | Needs Review |
| OpenClaw gateway | .config/systemd/user/openclaw-gateway.service, Organic Glass bridge code |
Gateway role, port 18789, compatibility proxies, command flow |
Needs Review |
| OpenClaw workspace memory/docs | .openclaw/workspace, .openclaw/workspace/organic-os |
Memory/documentation relationship, safe editing rules | Needs Review |
| Home Assistant | MCP tools, service notes, wrapper app, local endpoint evidence | Entity inventory, service call examples, auth, recovery | Needs Review |
| Kokoro TTS | Organic Glass Kokoro apps, Reflex Kokoro client, user services/launchers | API, voices, MP3 cache, KRunner/STT relation | Needs Review |
| Wyoming Whisper/openWakeWord | Nebula progress and service notes | STT/wakeword setup, ports, pipeline relation | Needs Review |
| Ollama and OpenWebUI | system-map integrations, services/proxies, wrappers | Model/runtime setup, local endpoints, proxy chain | Needs Review |
| Tailscale Serve | Nebula progress and system-map notes | Tailnet routes, ports, local vs tailnet access, security | Needs Review |
| Jellyfin and Cockpit | system-map integrations, wrapper apps, service/launcher evidence | Local admin/media surfaces and access model | Needs Review |
Media, Capture, and Hardware Runtime Inventory
Section titled “Media, Capture, and Hardware Runtime Inventory”| Component | Evidence | Documentation Needed | Status |
|---|---|---|---|
| Hardware/runtime layer | .openclaw/workspace/organic-os/HARDWARE_RUNTIME.md |
CPU/GPU/runtime assumptions, Linux vs WSL differences | Needs Review |
| HDMI GPU broadcast | HomeDevNovaGlassEngineCapture/hdmi_gpu_broadcast*.py |
Known-good script, backup cleanup, ports, GPU selection | Needs Review |
| Switch capture web UI | HomeDevNovaGlassEngineCapture/switch/*webui*.py |
Capture flow, UI, stream stability, recovery | Needs Review |
| Media transport experiments | HomeDevNovaGlassEngineCapture, system-map notes |
What is active vs legacy, cleanup strategy | Needs Review |
| Docker/container services | system-map notes, WSL exclusions, local service integrations | Which services run in containers, ports, lifecycle, backups | Needs Review |
Required Cross-Cutting Docs
Section titled “Required Cross-Cutting Docs”| Documentation Area | Evidence | Coverage Needed | Status |
|---|---|---|---|
| Installation | WSL packager, shell bundle, services, launchers | Linux local install, WSL import, dependency setup, first run | Needs Review |
| Configuration | config roots, service units, package manifests | All config files, env vars, defaults, safe overrides | Needs Review |
| Diagnostics | diagnostics notes, tests, system-map scanner | Health commands, port checks, service status, log locations | Needs Review |
| Troubleshooting | diagnostics notes, service/proxy evidence | Known failures, symptoms, fixes, escalation boundaries | Needs Review |
| Recovery | freeze points, backups, WSL artifacts | Restore points, rollback commands, artifact validation | Needs Review |
| APIs | Organic Glass socket, Input Nebula socket, MCP servers, file-drop protocol | Protocol schemas, examples, auth, error handling | Needs Review |
| Command reference | package scripts, .local/bin, desktop files, services |
Canonical commands, launchers, service lifecycle, tests | Needs Review |
| Service reference | .config/systemd/user, system-map service counts |
Unit files, dependencies, ports, restart behavior | Needs Review |
| Port/reference map | system-map port count, service configs, source endpoints | Local ports, LAN ports, tailnet ports, conflicts | Needs Review |
| Public release checklist | sensitive notes, WSL report, handoff folders | Redaction, artifact policy, public/private split | Needs Review |
Immediate Documentation Queue
Section titled “Immediate Documentation Queue”- OrganicOS architecture overview from existing notes.
- Local portal operating guide.
- Organic Glass command/socket reference.
- Nebula Reflex and System Map MCP references.
- Input Nebula control protocol.
- WSL integration security-reviewed guide.
- Service and port reference.
- Troubleshooting and recovery index.
- Public release redaction checklist.