What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Neo.mjs - Self-Evolving Software Organism

Frontmatter

title	docs(workstation): document fresh-checkout theme build (#15179)
author	neo-gpt-emmy
state	Merged
createdAt	Jul 14, 2026, 9:23 PM
updatedAt	Jul 14, 2026, 10:09 PM
closedAt	Jul 14, 2026, 10:09 PM
mergedAt	Jul 14, 2026, 10:09 PM
branches	`dev` ← `codex/15179-workstation-fresh-checkout`
url	https://github.com/neomjs/neo/pull/15181
contentTrust
projected
quarantined	0
signals	[]

Merged

neo-gpt-emmy commented on Jul 14, 2026, 9:23 PM

Resolves #15179

Workstation's standalone README now carries the same verified fresh-checkout sequence as Dock Demo: install, non-interactive development theme build, then server start. The complete apps/**/README.md census found no other runnable sequence requiring a change.

Evidence: L1 (the exact documented command built 635 development theme files and registered Workstation in resources/theme-map.json) -> L1 required (documentation-only setup correction). No residuals.

Related: #15146 Related: #14589 Related: #13158

Deltas from ticket

Corrected the explanatory location: application theme CSS is generated under dist/development/css/**; resources/theme-map.json is generated separately. Both are ignored. The README keeps the accurate user-facing "ignored development CSS and theme-map.json" wording.
Audited all four apps/**/README.md files. Dock Demo already has the three-command sequence from merged PR #15177; Colors and RealWorld2 contain no local run instructions and are N/A. Only Workstation required a change.
Did not create a shared run guide or change install hooks; the two showcase READMEs remain self-contained.

Test Evidence

Workstation setup: npm run build-themes -- -n -e dev -t all - 635 files, exit 0; generated Workstation source/dark/light CSS and theme-map.json entries for apps.workstation.Viewport plus a source entry for Workspace.
README census: rg --files apps -g 'README.md' - four files; only Workstation and Dock Demo contain local run sequences.
Hygiene: npm run agent-preflight -- --no-fix apps/workstation/README.md and git diff --check passed.

Post-Merge Validation

Follow the three-command sequence from a clean checkout and open http://localhost:8080/apps/workstation/index.html.

Evolution

The ticket described "apps/** development CSS"; live themes.mjs behavior and generated output place those files under dist/development/css/**. The implementation preserves the correct user-facing instruction while keeping filesystem claims exact.

Authored by Emmy (GPT-5.6 Sol Ultra, Codex), consuming Vega's A+FU handoff - session A a8b22c4c-dc82-440e-a8fb-95570036aa4e, session B adddb25d-fc36-4b08-b9a3-3a62a108cda1.

neo-gpt-emmy commented on Jul 14, 2026, 9:25 PM

Cross-family review exception: this is a pure-documentation micro-change with no runtime impact (apps/workstation/README.md, four insertions only). Full CI is green on current head c8ecce8c4; no primary reviewer is being assigned so the remaining Claude-family review budget stays available for substantive QT docking changes.