App Catalog

Infrastructure¶

App	What It Does
git	Version control for notes and projects
link	Find and manage connections between notes
note	Create, read, list, and update notes
quick-action	One input, agent figures out what to do — capture, route, act
run	Execute shell commands and scripts
task	Add, complete, and query tasks across notes
tmpl	Create notes from templates with placeholders

Productivity¶

App	What It Does
assistant	AI chat — vault integration, multi-agent compare, voice I/O, PWA
dictionary	Word lookup, vault storage, SRS flashcards, quizzes
expense	Expense tracking — add, summarize, analyze spending
focus	Pomodoro focus timer with task suggestions
journal	Daily journaling — entries, milestones, mood tracking, reflection
projects	Project portfolio — scan vault, parse status, track progress
quotes	A simple quote of the day app that picks a random inspirational quote and shows it. Store quotes in app data
reader	Read books with AI scene visualization, concept map, and dictionary lookup
search	Vault search with AI-powered answers
weather	Current conditions, forecast, history — OWM → Open-Meteo → wttr.in fallback chain

Creative¶

App	What It Does
publish	Publish vault notes as a static website — blog, projects, digital garden

Career¶

App	What It Does
github-connector	Sync GitHub issues and PRs into EmptyOS projects

System¶

App	What It Does
app-analytics	Personal usage tracking + vault health — which apps you use, when, and what to fix or delete
app-gen	Generate apps and plugins — the system grows itself
billing	LLM + image cost tracking — real tokens, daily stats, budget alerts
hub	Generic home dashboard — aggregates panel contributions from any installed app. Zero hard dependencies
model-bench	Compare LLM models on real app scenarios from the system
reactor	Event chain reactions — the system's metabolism
release	Package EmptyOS for distribution — safety checks, tier packaging
settings	System configuration — view and manage EmptyOS settings
system-log	System activity feed — all events in one place
tests	In-daemon test runner — discovers and runs pytest files, tracks last-run results
web-analytics	Privacy-first pageview analytics for published sites — no cookies, no fingerprinting, data stays local

Other¶

App	What It Does
actions	Run named templates over selected vault items. Plain or LLM-backed; workflows chain multiple actions
agent	Claude-Code-like coding agent — tool-use loop, permission-gated. Same brain in terminal (eos chat) and web (/agent/)
app-builder	Consume app-spec notes: spawn claude-cli in an isolated git worktree to scaffold a new EmptyOS app per the spec, leave merge to a human
architecture-map	Generate, archive, and browse narrative architecture maps of this EmptyOS repo via CodeBoarding. Long-running LLM analyses get a dedicated surface — kick them off with a scope picker, watch progress live, cancel mid-run, diff against past generations
boards	Visual Work OS: Flexible boards with multiple views, automations, and offline export — backed by your Markdown Vault
bookme	Share your availability and let people book meetings — a self-hosted scheduling page
cables	Network/reticulation projects — schedules, batch IEC 60287 ampacity across many cables, topology. Use the `cable-rating` app for single-cable detailed analysis (em_engine layered IEC 60287 / 3D FEM / CYMCAP parse)
calendar	A unified view of your schedule, aggregating tasks, journal entries, and external events
canvas	Infinite canvas for note cards, connections, pan/zoom, and vault-backed boards
code	Code-IDE-shaped web frontend over apps/agent. File tree + preview + diff viewer + terminal pane + chat. NOT a new backend — pure frontend reusing agent's session model, tool loop, and consent manager
company	One Org primitive covering real teams, virtual sims, target employers, and mixed. Members can be humans (linked to apps/people/) or AI personas. Scenarios (critique / workshop / interview) operate on the AI members of any org
dharma-log	Personal Buddhist study log — capture studied material, log confusions, turn them into your own wisdom through contemplative AI dialogue
dogfood-agent	Spawn claude-cli as a persona to use EmptyOS like a real human, surface friction + behavior signal. Operator manual: docs/DOGFOOD-AGENT.md
earthing	Substation grounding-grid analysis — Wenner soil-resistivity test (RESAP) interpretation, IEEE Std 80 grid resistance (Sverak / Schwarz two-term, plate-bound feasibility), tolerable touch / step potentials per §8 Dalziel, mesh + step potentials per §16, IEEE 80 §15 D_f / C_p / S_f decomposition, ENA EG-0 / IEC 60479 probabilistic risk assessment with ALARP banding, 2D top-down conductor geometry editor with rectangle template, per-project design scenarios with side-by-side comparison, and a what-if parameter sweep that ranks cheapest passing designs across mesh density × rod count × burial depth
feature-pipeline	Drive a feature-brief through research → design → impl → dogfood → release. Each stage is a skill invoked as a focused claude-cli; reasoning between stages decides advance / retry / skip; the final publish step always lands in the room review gate
fix-agent	Consume dogfood-agent's fix-prompt queue: spawn claude-cli in an isolated git worktree, branch-per-fix, leave merge to a human
forge	Scaffold and track native apps. EmptyOS as a workbench for projects whose code lives outside the daemon
geo-cad	Georeferenced drawings on a tile basemap. Other apps drop in features (lines, polygons, points) carrying attributes and get a Leaflet-Geoman editor + GeoJSON storage. DXF/SHP/KML/GeoPackage interchange via the optional gdal plugin
geocode	Address ↔ lat/lon lookup via OpenStreetMap Nominatim. Free, cached, rate-limited to honour public-service usage policy
gesture	Real-time hand-gesture demo — browser camera + MediaPipe. Maps gestures to actions, emits gesture:detected. Camera bytes stay on the device
grill	Recipe-driven Socratic elicitation — surfaces the manifest knobs that bite later, writes a structured spec note before code exists
guideline	Organize prescriptive guidelines (rules, principles, conventions) by category
hands-free	Gesture-as-push-to-talk control mode. Open_Palm raises hand → voice command → gesture confirms. Routes through the command palette; no new app wiring needed. Camera + mic bytes stay on the device (Web Speech API uses Google servers for STT — noted in consent)
improv	Practice improvisational performance with an AI scene partner. Yes-and dialogue, genre swap, emotional pivot, status games, monologue prompts. Logs sessions to vault for review
interference	EMF / EMI studies. Phase A: 3D Biot-Savart B-field + image-method E-field around overhead lines and buried cables. Profile + grid analysis. Companion to apps/lines, apps/cables
kb	Domain-general knowledge base — concepts, formulas, standards, cases, lessons
lightning	Lightning protection (IEC 62305 / NFPA 780). Phase 1: 2D rolling-sphere shielding analysis along a profile. SESShield-3D-class visible-win deliverable; 3D heightfield analysis is Phase 2
music-library	Browse, play, and edit songs in your vault. Generate AI lyrics. No GPU required — pure vault + LLM
pattern-harvester	Detect duplicated code patterns across apps, score by frequency × complexity × template-bias, surface SDK extraction candidates
people	Person directory — roster, capacity, workload, relationships, birthdays, interactions. Absorbs the former contacts app
ppt	Markdown-driven decks. One vault note per deck — present in fullscreen, export to standalone HTML
providers	Manage think-capability providers — local LLMs, cloud APIs, Claude CLI. Edits the live capability chain without a restart
radio	Continuous mixed-source stream — music, podcasts, devlog, DJ chatter
repo	Read/edit/exec on the EmptyOS codebase, exposed as rooms verbs (chat-shape, [DO:]-gated). Parallel to apps/agent's bundled tools, which run inside the agent loop instead
reports	Professional documents — PDR, CDR, TRR, proposals, specs, reports — with structured tables, signoff, and PDF + DOCX export
rooms	Conversation rooms — single-agent (1:1) and multi-participant. Each room has a system prompt, optional knowledge files, and persistent history. The shared substrate where the user, named agents, and (in v2) CLI participants meet. Renamed from `gpts` 2026-05-09; existing per-agent histories migrate losslessly to 1:1 rooms
routing	Multi-stop route planning via OSRM. Free, cached, rate-limited. Pairs with geocode + EOS_MAP for trip planning from vault data
sandbox	HTTP API + status page for the sandbox-pool plugin: small pool of throwaway EmptyOS daemons on :9002+ that operators (Claude, /loop jobs, test scaffolds) lease, restart, and release. Routes a kill/restart through a daemon-owned endpoint instead of raw Bash taskkill, which the auto-classifier won't authorise
scroll	Vertical AI-generated short-clip feed driven by user-curated personas
sim	Native EMTP-class power-systems simulator. Runs netlists via the sim engine, persists runs in the vault. Other apps consume via the engine directly; this app is the run viewer + standalone-run UI
skill	Skill registry for rooms agents — system-prompt overlays + verb allowlists invoked by /. Parallel to apps/agent/skills.py which serves the agent loop
soil	Multi-layer soil resistivity inversion from Wenner sounding measurements. Paste a measurement table, pick a layer count, and get a converged ρ/h model with per-point fit, reflection coefficients, and Jacobian-SVD diagnostics that flag over-parameterised fits. Forward kernel validated against an independent industry reference case to within 0.1% RMS
store	Browse, install, and uninstall apps / plugins / skills. Restart-required toggle UI over the local catalog — every manifest in the repo shows up here, install state is per-user
test-app	test app
tiers	View and edit release tier membership for apps + plugins
tour	Walks the user through real EmptyOS surfaces. Apps contribute steps via contributes.tour.step; the tour orchestrator drives EOS.navigate + spotlight
trace-miner	Ambient syslog miner — groups recurring errors into prioritized, evidence-backed issues and feeds the fix-agent loop
vault-graph	Force-directed graph of vault notes, links, and references
video-digest	Queue YouTube URLs and turn them into vault Web-Clip digests with AI-distilled summaries
voice-assistant	Conversational voice assistant using listen, think, and speak capabilities
welcome	Public-facing landing page for an EmptyOS deployment — directs visitors to the publicly reachable surfaces (radio, etc.)
writing-editor	Workplace writing editor — paste a draft, pick audience + tone, get a revised version with per-edit rationale

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.