Codex

Codex gets a practical home in the Adom ecosystem: a dependable setup entry point, a dock dashboard, and recorded engineering demonstrations.

Install the Adom integration with adom-wiki pkg install adom/codex, then open the Codex dock card or run adom-codex serve --print-url.

This package configures Codex for Adom. It does not install or replace the OpenAI Codex executable or your credentials.

Guides

• Bootstrap: preparing Codex for Hydrogen
• Dock dashboard, newbie panel and demos
• Astra: live KiCad routing and comparison log
• Codex Desktop installation and Bridge roadmap

Astra drives live KiCad

The videos below are real KiCad window recordings. Astra runs in the Adom Hydrogen container and sends explicit trace-routing commands through Adom Bridge to KiCad on AdomLapper. Idle footage is trimmed; routing plays at 3x with explanatory captions.

Six nets: the first trace-routing demo

Download the 23-second video. Six nets, 13 pads, 20 trace segments and two vias. KiCad measured zero DRC errors and zero unconnected items; three warnings identify synthetic footprint libraries.

24-net crossover: calculated paths and branches

Download the 31-second video. A permutation maps each input to an output column. Horizontal front-layer traces cross vertical back-layer traces, and each net branches to a third pad. Result: 72 pads, 120 segments, 48 vias, zero DRC errors, zero unconnected items, and three synthetic-library warnings.

This establishes explicit per-net/per-trace control. The crossover fixture uses a constructed routing algorithm; it is not evidence of arbitrary-board autorouting.

Public Adom board: first routing pass

Download the preview. Uses the public Adom Teazzers Solenoid Driver RP2040 v1.1, with 94 footprints and five channels. Astra calculates paths independently, then commits them live through Adom Bridge. Precomputed geometry and 3x playback are labeled. This first pass adds 60 connections as 106 segments, reducing native open items from 118 to 60. Five baseline errors remain. This is the earlier partial run; the full comparison below completes connectivity.

Real Adom boards

The public Teazzers comparison shows the reference, a stripped copy, independently calculated routing, and measured native KiCad results. Only publicly accessible designs are used in published recordings. A combined reel will follow approval of the individual runs.

Public Adom board: full routing comparison

Download the full comparison. The public Teazzers Solenoid Driver RP2040 v1.1 has 94 footprints and five output channels. The video tours the original human layout, removes all 484 segments and 58 vias from a copy, verifies zero remaining traces/vias, and shows Astra's independently calculated routing appearing through live KiCad IPC edits.

Astra runs in Adom Hydrogen and writes a custom geometry/A* planner. It reads the retained placement, pads, netlist and zone outlines; checks candidate paths against copper, pads, holes and board edges; and uses back copper and vias where needed. No Freerouting or other external autorouter is used, and the original trace geometry is not used to generate the replacement paths. Planning and iterative native DRC happened before this recorded execution. The tour and result play at normal speed; route creation plays at 3x, with the validation wait omitted.

The final saved live board contains 1,463 segments and 33 vias, with zero unconnected items after native KiCad zone refill and DRC. Four pre-existing errors remain: two courtyard overlaps, one zone intersection and one starved thermal. There are no new clearance or crossing errors. The human reference reports three open items and 27 errors under the same KiCad checks; the stripped starting copy reports 118 open items and five errors. This demonstrates connectivity routing on this board. Current capacity, USB signal integrity and production electrical qualification remain engineering review tasks.

kicad_routing_state supplies the live revision and verifies copper counts. kicad_remove_route removes the original copper in one native Undo transaction. Then 132 kicad_route_net calls create the independently calculated segments and vias, guarded by expectedRevision. These calls use validate:false because the whole candidate was already checked; the actual saved live board is checked again using kicad-cli pcb drc --refill-zones through Adom Bridge run_script. desktop_record_window_start / desktop_record_window_stop capture one continuous KiCad-window take. The edited film is derived from that take, with caption timing and an edit manifest retained.