Adom Definitions
Canonical glossary of Adom platform terms. Use these definitions consistently in conversation, code, documentation, and wiki content.
Core Platform
| Term | Definition |
|---|
| Adom | The platform and company. Never say "Gallia" or "Hydrogen" to users — those are internal codenames. |
| Adom App (aka Workspace) | The full web app: toolbar, panels, VS Code, profile, workcell picker. Internal codename "Hydrogen". "Workspace" emphasizes the persistent panel layout stored in Docker container layout files. |
| Adom Viewer (AV) | The AI GUI panel inside the Adom App. Internal codename was "Gallia Viewer (GV)". This is where Views live. A single AV server (port 8770) can serve multiple independent AV panels — each is an AV instance with its own tabs, state, and content. |
| AV Instance | A single AV panel running inside a Web View panel. Each instance has a unique ID passed via URL param (?instance=<id>). Instances are independent — their own tabs, nav history, and dropdown state. The default instance (no param) is the general-purpose AV. |
| Panel | A rectangular area in the Adom App (Workspace) layout — like a window pane. Each panel has a tab with a name and icon. Panels can be split, resized, moved, and closed. Types include VS Code, Web View, 3D Viewer, Schematic Editor, cameras, sensors, etc. AV runs inside a Web View panel. |
| AV2 | DEPRECATED — was a second AV on separate ports (8790/8791/8792). Replaced by AV instances: just open another Web View panel pointed at ?instance=<id>. |
Views
| Term | Definition |
|---|
| View | A mini-app/tab inside AV. Each View has a View ID (e.g., SymView, FpView). Views are like apps on a desktop OS — each has its own icon, author, and real interactive content. |
| View ID | The short identifier for a View (e.g., SymView, Fp3dView, DkSearch). Used in code and the dropdown. |
| real-view | A keyword and enforcement rule meaning: always use the ACTUAL running view/app, never a fake mockup, placeholder, or approximation. This applies everywhere — dropdown landing pages, wiki submissions, demos, screenshots. If you're about to create an HTML page that looks like a view but isn't the real app, STOP — that's a fake. Use the real app with sample data instead. See av-creator skill Rule #2. |
| fake-view | Any static SVG/HTML/screenshot that approximates a real view but doesn't run the actual app code. Fake-views are BANNED. Examples: a hand-drawn SVG of a symbol instead of loading the real symbol viewer; a placeholder with "Ask Claude to..." text; a generated mockup that looks similar to the real thing. |
View IDs Reference
| View ID | Name | What it does |
|---|
| SymView | Symbol Creator | Interactive KiCad schematic symbol viewer with hover tooltips |
| FpView | Footprint Creator | 2D KiCad footprint viewer |
| Fp3dView | Footprint 3D | 3D Babylon.js pad geometry viewer (from fp-to-3d.js) |
| 3dView | 3D Component | STEP/GLB 3D model viewer with pad overlays and camera tours |
| Basic3dView | Basic 3D | Minimal GLB viewer — renders exactly as-is, no fixups |
| LibView | Library Review | Three-pane view: symbol + footprint + 3D side by side |
| SchView | Schematic Creator | Interactive schematic visualization with net highlighting |
| BoardView | Board Creator | Interactive board layout (2D SVG or 3D GLB) |
| DkSearch | DigiKey Search | Component search against DigiKey API |
| MsrSearch | Mouser Search | Component search against Mouser API |
| JlcSearch | JLCPCB Search | Component search against JLCPCB catalog |
| DeskConduit | Desktop Conduit | Bridge to user's local desktop (KiCad, Fusion 360, file transfer) |
| ContConduit | Container Conduit | Manage satellite containers (shell, files, monitoring) |
| GChat | Google Chat | Send/receive Google Chat messages as Kel |
| Instruments | Instrument Viewer | Live oscilloscope/DAQ waveform display |
| InstaPCB | InstaPCB | PCB fabrication quotes and DFM checks |
| PcbDesign | PCB Design | tscircuit-based PCB design |
| MovieMaker | Movie Maker | Record narrated video walkthroughs |
| SkillsMap | Skills Map | Visual map of all available skills |
| Prefs | Preferences | User preferences for symbol creator etc. |
Creators and Services
| Term | Definition |
|---|
| Creator | A service or skill that generates artifacts (symbols, footprints, 3D models, schematics, boards). |
| symbol-creator | Service at port 8781 that generates .kicad_sym files, metadata, SVG, branded viewer HTML. |
| footprint-creator | Skill that generates .kicad_mod files and viewer HTML. |
| fp-to-3d.js | CLI script that generates Babylon.js 3D pad viewer HTML from .kicad_mod files. |
| 3dcomponent-creator | Generates STEP/GLB 3D component models. |
| library-creator | Creates all three artifacts (symbol + footprint + 3D) and shows them in LibView. |
CLI Tools
| Term | Definition |
|---|
| adom-cli | Rust CLI for the Adom platform API — containers, repos, users, workspaces, SSH keys, orgs. Binary at /usr/local/bin/adom-cli. Repo: adom-inc/adom-cli. |
| adom-vscode | Rust CLI + VS Code extension for controlling code-server from Docker processes. Opens files, reveals in explorer, searches/installs extensions, starts Claude Code chats, switches UI modes. Extension runs HTTP server on port 8821. Binary at /usr/local/bin/adom-vscode. Repo: adom-inc/adom-vscode. |
| shotlog | Rust CLI + HTTP server for chronological screenshot logging. Supports multiple named channels, clipboard paste with auto-resize, real-time WebSocket updates. Server on port 8820. Binary at /usr/local/bin/shotlog. |
| pup | Puppeteer browser control via Desktop Conduit. Opens/closes Chrome windows, reloads pages, takes screenshots, evaluates JS, flashes taskbar alerts. Commands run via adom-desktop browser_*. Always lowercase. |
URLs
| URL Pattern | What it is |
|---|
https://hydrogen.adom.inc/{owner}/{repo} | Repo page — shows repo info, container status, README. Not the editor. |
https://hydrogen.adom.inc/{owner}/{repo}/edit | Editor — the full Adom App (Workspace) with panels, VS Code, AV, toolbar. This is what users open to work in their container. Always add /edit to get into the editor. |
https://hydrogen.adom.inc/{owner}/{repo}/tree/latest/{path} | File browser — browse project files in the repo. |
https://hydrogen.adom.inc/{owner}/{repo}/blob/latest/{path} | File viewer — view a single file in the repo. |
https://coder.{owner}-{repo}-{hash}.containers.adom.inc/ | Direct container URL — raw VS Code in browser, bypasses the Adom App. The hash is assigned by the platform. |
Key distinction: /{owner}/{repo} is the repo page. /{owner}/{repo}/edit is the editor (Adom App / Workspace). Always use /edit when you want users to actually work in the container.
Infrastructure
| Term | Definition |
|---|
| Skill | A Markdown document (SKILL.md) that teaches Claude Code how to perform a specialized task. Lives in gallia repo, deployed to ~/.claude/skills/. |
| Conduit | WebSocket bridge between containers or between container and desktop. Two types: Desktop Conduit (DeskConduit) and Container Conduit (ContConduit). |
| MCP | Model Context Protocol — the tool interface that connects Claude to services (viewer, DigiKey, Mouser, etc.). |
| Sample data | Pre-generated real view HTML files in viewer/samples/ used for dropdown landing pages. Ensures real-view compliance when no user data is available. |
Coordinate System
| Term | Definition |
|---|
| Z-up | Adom 3D convention: Z is always up. Ground plane is XY at z=0. Babylon.js scenes use zUp: true. |
| KiCad Y flip | KiCad Y points down; negate Y when converting to Adom 3D coordinates. |
| GLB 1000x scale | glTF uses meters, Adom uses mm. GLB models are scaled 1000x. Overlay meshes need positions multiplied by 1000. |
Tools & Brand Names
Use these names consistently in conversation, docs, CLI output, and skill files.
| Name | What it is | Notes |
|---|
| Adom Editor | The full Hydrogen web app (panels, toolbar, layout) | "Editor" always means this. Never call VS Code "the editor". |
| VS Code | The code IDE running inside the Docker container, powered by Coder's code-server | Primary name. Embedded as an iframe panel in the Adom Editor, or accessed directly via https://<slug>.adom.cloud/?folder=.... Synonyms to avoid in user-facing contexts: "code-server", "coder", "Coder.com". Use those only when discussing internals or infrastructure. Never call it "the editor" (that's Hydrogen). |
| AV | Adom Viewer — the AI GUI panel | Short form is fine in conversation and code. |
| pup | Puppeteer browser control via Desktop Conduit | Always lowercase. "Open in pup", "pup screenshot", "pup reload". |
| shotlog | Screenshot log viewer and injector | Always lowercase. CLI binary name = shotlog. |
| adom-vscode | VS Code extension + CLI for controlling code-server | Hyphenated. CLI binary name = adom-vscode. |
| adom-cli | Adom platform CLI (containers, repos, users, workspaces) | Hyphenated. Binary = adom-cli. |
| SB | Sandbox panel | User shorthand. "Show in sb" = show in the sandbox panel. |
Internal Names
The following names are used internally in code, repos, and infrastructure. Always use the public name in conversation, documentation, wiki, and anything user-facing.
| Internal Name | Public Name | Where you'll see the internal name |
|---|
| Hydrogen | Adom Editor (or just "Editor") | Repo paths (hydrogen.adom.inc), API endpoints, workspace control skill |
| Gallia | Adom | GitHub repo (adom-inc/gallia), skill/service source paths |
| GV | Adom Viewer (AV) | Old code comments, some variable names |
| Carbon | (no public name — backend only) | Container registry API (carbon.adom.inc), adom-cli carbon commands |
| code-server / Coder | VS Code | Docker infrastructure, server processes, port configs |
| conduit | Desktop Conduit or Container Conduit | Relay server code, WebSocket bridge internals |