App Catalog
Infrastructure¶
| App | What It Does |
|---|---|
| tmpl | Creates notes from templates with placeholders to fill in |
| link | Finds and manages links between your notes |
| note | Create, read, list, and update your notes |
| quick-action | Turns one input into the right capture, routing, or action |
| run | Execute shell commands and scripts locally |
| task | Add, complete, and search tasks across your notes |
| git | Tracks versions of your notes and projects so you can review or restore changes |
Productivity¶
| App | What It Does |
|---|---|
| academy | Helps you learn English with onboarding, progress tracking, reviews, and practice launchers |
| dictionary | Looks up words, saves them to your vault, and turns them into flashcards and quizzes |
| improv | Practice improv with an AI scene partner and save sessions for review |
| radio | Plays music, podcasts, devlogs, and DJ chatter |
| search | Searches your vault and answers questions using AI |
| weather | Shows the weather using multiple forecast sources with automatic fallback |
| actions | Runs templates and chained workflows on selected vault items, with optional AI |
| business-case | measured before/after for one engagement → a one-page business case (PDF) the buyer can act on |
| feedback | User feedback intake, duplicate clustering, voting, roadmap status, and changelog drafts |
| guideline | Organize rules, principles, and conventions into categories |
| work | describe an outcome; the system plans, assembles it from your vault + apps, and hands you the artifact to judge |
| assistant | Helps you search your vault, compare agents, and use voice conversations |
| boards | Organizes work in flexible boards with multiple views, automations, and offline export |
| bookme | Share your availability and let others book meetings on a self-hosted scheduling page |
| braindump | Dump a pile of mixed thoughts (type or speak) — it summarizes, splits them into tasks / journal / notes, and proposes each for your review. Triggered, never always-on |
| calendar | Shows your schedule by combining tasks, journal entries, and external events |
| codoc | Bridge to the live co-doc collaboration service — persist a live doc snapshot into the vault |
| commons | Publish vault notes to a shared commons with visibility control — public, private, or shared with specific people. Outbound is consent-gated and leak-scanned; nothing leaves the vault without an explicit publish |
| company | Manage organizations with human and AI members, and run simulated team scenarios |
| expense | Track, summarize, and analyze your spending |
| focus | Times focused work sessions and suggests tasks to tackle next |
| journal | Capture journal entries, milestones, moods, and reflections over time |
| kb | Stores concepts, formulas, standards, cases, and lessons for quick reference |
| learn | Turns your notes into structured courses with lessons, quizzes, and progress tracking |
| people | Manage people, relationships, workload, capacity, birthdays, and interaction history |
| ppt | Create presentations from Markdown notes, present fullscreen, and export standalone HTML |
| projects | Scans your vault to parse project status and track progress |
| quotes | Shows a random inspirational quote from your stored collection each day |
| reader | Reads books with AI scene visualization, concept maps, and dictionary lookup |
| reports | Creates structured technical reports, proposals, and specs with signoff and PDF/DOCX export |
| runbook | Builds, schedules, and publishes typed block pipelines |
| sheet | a grid of cells with per-cell formulas (=SUM, =IF, =TODAY), stored as a markdown table in a vault note |
| worklog | project-grouped, status-tagged daily entries |
| writing-editor | large-print documents with voice dictation and PDF export, plus draft revision with audience + tone awareness |
Creative¶
| App | What It Does |
|---|---|
| canvas | Creates infinite vault-backed boards for note cards, connections, and pan-and-zoom exploration |
| designer | Creates styled standalone HTML page mockups from your prompts and chosen design systems |
| jianpu | click-to-insert palette, live preview, print and PDF export |
| music-library | Browse, play, and edit songs in your vault, and generate AI lyrics |
| publish | Publishes vault notes as a static website for blogs, projects, or a digital garden |
| scroll | Shows an AI-generated short video feed tailored to your chosen personas |
| viz | Creates standalone visual explainers, diagrams, charts, and Three.js scenes from plain-language briefs |
Career¶
| App | What It Does |
|---|---|
| github-connector | Syncs GitHub issues and pull requests into EmptyOS projects |
Engineering¶
| App | What It Does |
|---|---|
| feature-pipeline | Moves feature briefs through research, design, implementation, dogfooding, and release with review gating |
| cable-library | Store and edit detailed cable layer data, dimensions, limits, and electrical parameters |
| cable-stress | Calculates coaxial cable insulation electric-field stress and sizing under service and impulse voltages |
| cable-network | Plans cable networks with scheduling, topology, load flow, short circuit, and batch ampacity calculations |
| cad | Parametric 3D CAD editor + 2D drafting workspace. 3D models are a parameter-driven feature tree (primitives + booleans) rendered live in the browser via Three.js, compiling to exact B-rep solids + STEP via the cadquery plugin (Phase 2). 2D drawings (eos-draft/1) get an AutoCAD-style canvas editor — command line, osnap, layers, dimensions, title block — with DXF import/export via ezdxf |
| design-package | Combines substation, transmission line, and cable studies into one markdown and PDF deliverable |
| devices | register, categorize, and compose M5Stack & other devices over the event bus |
| earthing | Design grounding grids by analyzing soil, safety limits, layouts, and cost-optimized scenarios |
| engineering-scene | Places yard equipment, georeferences it, and links each item to electrical nodes |
| geo-cad | Edit georeferenced drawings on maps with feature attributes and GeoJSON import/export |
| hv-clearance | AS 2067:2016 substation clearance calculator + 2D layout designer. Looks up minimum phase-to-earth / phase-to-phase clearances and derives the section (S), horizontal (H) and vertical (V) work safety clearances from Tables 3.1/3.2; the designer places HV equipment on a plan and flags any walkway/access infringement of the safety envelope |
| interference | Analyzes electric and magnetic fields around overhead lines and buried cables |
| lightning | Analyzes 2D lightning shielding along a profile using rolling-sphere protection standards |
| overhead-line | Calculates overhead line thermal rating, sag-tension, and ground clearance |
| power-study | Performs load-flow and 3-phase or single-phase short-circuit analysis with single-line reports |
| reliability | Calculates power-system reliability, availability, breaker failure impacts, and annual outage costs |
| sc-force | Short-circuit mechanical forces on a substation bay (IEC 60865-1, rigid + flexible conductors), wind force (AS/NZS 1170.2), and the governing maximum combined load (AS 2067 Table 2.1). Sizes post-insulator / support loads, conductor stress, and displacement-vs-clearance |
| short-circuit | Calculates conductor short-circuit thermal withstand, permissible current, fault pass/fail, and minimum cross-section |
| sim | View and run EMTP-class power-system simulations, with runs saved in your vault |
| soil | Inverts Wenner sounding measurements into multilayer soil resistivity models with fit diagnostics |
| tree-protection | AS 4970:2025 tree-protection-zone calculator for development sites. From a tree's DSH it computes the Notional Root Zone (NRZ = DSH×12, clamped 2–15 m) and the Structural Root Zone (SRZ = (D×50)^0.42×0.64, min 1.5 m), and classifies an open excavation / trench encroachment as minor / moderate / major per §3.3 — with the compensatory-area requirement and the required arborist response |
| bess-analyser | Optimises battery charging and discharging against NEM prices to estimate arbitrage revenue |
System¶
| App | What It Does |
|---|---|
| app-gen | Creates and evolves system apps and tools from your needs |
| model-bench | Compares LLM models using real scenarios from your system |
| release | Runs safety checks and packages releases into deployment tiers |
| tests | Discovers and runs pytest files, tracking the most recent test results |
| web-analytics | Tracks pageviews for published sites locally without cookies or fingerprinting |
| hub | Combines panel content from installed apps into one hub |
| settings | View and manage EmptyOS settings |
| system-log | Shows all system and app events in one place |
| app-analytics | Tracks app usage and vault health to show what to fix or delete |
| billing | Tracks token usage, daily stats, and budget alerts |
| reactor | Manages the system's internal activity and state changes |
Ai¶
| App | What It Does |
|---|---|
| daily-brief | Summarizes selected feeds with AI into one daily note |
| explore | External web research with cited answers, source cards, vault comparison, and saved research notes |
| gesture | Detects hand gestures with your camera and triggers actions locally |
| model-serving | Browse local Ollama models and serve one with VRAM-aware setup without terminal editing |
| synth | Iteratively generates, checks, calibrates, and fixes outputs until quality and coverage goals are met |
| agent | Runs a permission-gated AI agent that uses tools in terminal and web |
| dictation | Hold a hotkey in any text field and speak — your words are transcribed, lightly polished (punctuation, casing, your custom terms preserved), and inserted at the caret. Works in any EmptyOS input, textarea, or rich editor. Speak to create, type to refine |
| hands-free | Control EmptyOS by raising your hand, speaking, then confirming with a gesture |
| proactive | a restrained engine that scans your state for things worth surfacing (deadlines, journaling gaps, today's load, budget overruns) and nudges you through a quiet-hours + frequency-capped gate |
| replay | turn a finished agent session into a reusable, parameterized Replay (a saved workflow), then run it again later with every state-changing step routed through the review gate. Demonstrate once, replay safely |
| rooms | Create persistent one-on-one or shared AI rooms with prompts, files, and history |
| video-digest | Queue YouTube or web URLs and turn them into vault Web-Clip digests with AI-distilled summaries |
| voice-assistant | Talks with you by listening, thinking, and speaking back |
Core¶
| App | What It Does |
|---|---|
| providers | Manage local models, cloud APIs, and Claude CLI in the live capability chain |
| store | Browse, install, and uninstall local apps, plugins, and skills for your account |
| vault-backup | Creates scheduled vault snapshots with retention rules and alerts when backups become outdated |
| vault-graph | Visualizes your vault notes, links, and references as an interactive graph |
| workspaces | Organizes related apps into navigable spaces around a goal |
Dev¶
| App | What It Does |
|---|---|
| app-builder | Consume app-spec notes: spawn the configured agent runner in an isolated git worktree to scaffold a new EmptyOS app per the spec, leave merge to a human |
| architecture-map | Generates, stores, and compares narrative architecture maps of your EmptyOS repo |
| dogfood-agent | Uses a Claude persona to operate EmptyOS and reveal usability friction and behavior patterns |
| eink-bridge | Expose a Claude Code (or any) terminal over your LAN via ttyd, to view on an e-ink reader's browser as a second screen |
| fix-agent | Consume dogfood-agent's fix-prompt queue: spawn the configured agent runner in an isolated git worktree, branch-per-fix, leave merge to a human |
| kb-butler | Monitors knowledge base health, fixes broken reciprocal links, and summarizes structural issues |
| kb-gap-miner | finds repeatedly-asked questions the KB doesn't cover and proposes new KB notes through the review gate |
| memory-fidelity | Scheduled proposer for Attested Memory (docs/MEMORY.md §8) — audits machine-touched memory and surfaces degraded (suspect) claims as 'confirm or correct?' review-gate proposals. Dark until [apps.memory-fidelity] enabled |
| pattern-harvester | Finds repeated code patterns across apps and highlights good SDK extraction candidates |
| Reviews background runs and pending actions from your phone with reachability status | |
| progress | a cumulative, NIW-framed build record (sessions, commits, week-streak, theme roadmap) read from the devlog + git |
| promote | Drafts review-ready release promos from devlogs and git, with approval before publishing |
| rag-eval | Benchmarks vault retrieval quality using hit@k, MRR, and source precision/recall |
| repo | Read, edit, and run codebase actions through chat-style room commands |
| run-center | Monitor, review, merge, verify, and revert background agent runs in one place |
| sandbox | Leases and restarts temporary EmptyOS daemons through an HTTP API and status page |
| skill | Invokes slash commands that apply prompt overlays and allowed actions |
| tiers | View and edit which release tiers apps and plugins belong to |
| trace-miner | Groups recurring errors into prioritized, evidence-backed issues for the fix-agent loop |
| code | Edit files with chat, terminal, previews, and diffs in an IDE-style workspace |
| forge | Scaffold and track native apps whose code lives outside the daemon |
Meta¶
| App | What It Does |
|---|---|
| grill | Helps you define risky implementation details early by writing a structured spec note |
| welcome | Shows visitors the public pages and links for your EmptyOS deployment |
| engagements | segments EmptyOS already serves plus measured customer engagements, with an honest value rollup |
| workflows | Build and run visual workflows with reversible actions and human approval steps |
| geocode | Looks up addresses and coordinates using OpenStreetMap geocoding |
| portal | Routes thinking, capture, search, and learning into organized rooms with shared context |
| routing | Plans multi-stop routes for trip planning using cached OSRM directions |
| tour | Guides you through EmptyOS features with interactive steps across real screens |
Personal¶
| App | What It Does |
|---|---|
| garden | Creates a programmatic SVG garden reflecting your vault entities across four wellbeing plots |
| vlog | record or import a clip a day, auto-transcribed and laid out on a calendar, with an optional compile-to-montage |
Other¶
| App | What It Does |
|---|---|
| test-app | Runs a basic test app |
| test-app-wiring | A simple test app for validating EmptyOS app wiring and basic interactions |
The Pattern¶
Every app follows the same structure:
apps/{id}/
├── manifest.toml # Declares id, capabilities, events, routes
├── app.py # Python class extending BaseApp
├── __init__.py
└── pages/ # HTML files for custom UI (optional)
└── index.html
Apps without pages/ get an auto-generated UI. Apps with custom pages get hot-reloaded HTML — edit and refresh, no restart needed.