app
Codex
Public Made by Adomby adom
Codex in Adom Hydrogen: ecosystem setup, dock dashboard and live engineering demos.
← Commit history
Explain how packaged PCB skills make the demonstrated methods reusable across Adom installations
4 files changed
+26−2
adom_codex.py+1−1@@ -3,7 +3,7 @@ import argparse,json,os,platform,shutil,subprocess,sys,time,urllib.request,urlli from pathlib import Path from http.server import SimpleHTTPRequestHandler,ThreadingHTTPServer ROOT=Path(__file__).resolve().parent-VERSION='0.1.4'+VERSION='0.1.5' def context(): ch=Path(os.environ.get('CODEX_HOME',Path.home()/'.codex')) return {'app':'adom/codex','version':VERSION,'container':{'system':platform.system(),'kernel':platform.release(),'hostname':platform.node(),'cwd':os.getcwd()},'tools':{n:shutil.which(n) for n in ['codex','adom-wiki','adom-cli','adom-bridge']},'instructionsInstalled':(ch/'skills/codex-adom/SKILL.md').exists(),'hostTarget':'Not inferred; select and verify through Adom Bridge','hydrogenControlConfigured':(Path.home()/'.adom/hydrogen-control-url').exists()}
docs/ASTRA-KICAD.md+22@@ -59,3 +59,25 @@ Read the [electrical-routing worked example](ELECTRICAL-ROUTING.md) for the deci Astra runs in the Hydrogen container. `kicad_routing_state` reads the board and revision; `kicad_route_net` commits calculated traces/vias with `expectedRevision`; `kicad_remove_route` clears copper from a copy. Native KiCad refill/DRC checks the saved result through the validation surface or a background `run_script` call, depending on the operation. `desktop_record_window_start` and `desktop_record_window_stop` capture KiCad, and `pull_file`/`send_files` move the media between the desktop and container. The routing bridge remains on its development branch, with [draft review #2](https://wiki.adom.inc/adom/kicad-bridge/prs/2); these films do not claim the separate Adom Bridge pin-protection fix is deployed. See [implementation, validation and narration details](ROUTING-IMPLEMENTATION.md), [the shared routing guide](ELECTRICAL-ROUTING.md), and [Codex setup](BOOTSTRAP.md).++## The methods ship to every user who installs Codex for Adom++These demonstrations also improve the shared `adom/codex` package. The lessons are written into reusable skills and worked examples inside its installable tarball, so another Adom user can start with the same routing and review guidance without reconstructing this conversation.++Install or update the integration from your Adom Hydrogen workspace:++```bash+adom-wiki pkg install adom/codex+```++The installer places the skills in your Codex skills directory and adds a managed entry point to `AGENTS.md`, preserving your other instructions. That entry point tells Codex to establish its Adom context, discover the connected desktop and Bridge capabilities, and consult the electrical-routing skill for PCB routing, power pours and copper-ablation work. A new Codex conversation can then discover the installed guidance; existing conversations must explicitly read newly installed skills. Installing this package does not automatically update every Adom user's workspace or an already-running conversation.++The tarball includes guidance for electrical-aware routing, copper ablation, live recording and narration, desktop video playback, and reliable Bridge operation. The routing skills cover schematic/BOM checks, load budgets, power and return paths, USB constraints, useful copper retention, thermal connections, native refill/DRC and accurate reporting. The worked example preserves both successful methods and failed approaches, including the test that removed thin power traces to prove the pours themselves connected the loads.++Try asking Codex:++> Use the Adom electrical-routing and ablation skills to inspect my PCB. Establish its load and fabrication requirements, preserve the original, calculate cleaner routing and useful copper pours, and validate the result in native KiCad. Then record and narrate a comparison that explains the decisions.++The skills give future users a reusable engineering workflow. Execution still requires an available Codex model, KiCad, a connected Adom Bridge and compatible routing verbs; the per-net KiCad Bridge changes shown here remain on a development branch. The package does not bundle a finished universal autorouter or guarantee a production-ready board. Each design's geometry, electrical limits and manufacturing requirements must be calculated and checked.++This is how the ecosystem carries the work forward: improvements are saved in shared source, released in the package tarball, installed into the user's AI environment, and applied to the next design. See the [electrical-routing guide](https://wiki.adom.inc/adom/codex/files/docs/ELECTRICAL-ROUTING.md) and [bootstrap details](https://wiki.adom.inc/adom/codex/files/docs/BOOTSTRAP.md).
docs/BOOTSTRAP.md+2@@ -25,3 +25,5 @@ Audit finding: wiki source was two commits ahead of the old 0.1.2 package. Sourc ## Electrical-routing skill in 0.1.4 An eighth skill, `codex-adom-electrical-routing`, puts schematic/BOM review, load and fabrication requirements, power/ground planning, differential signals and ablation copper retention before route generation. It separates measured connectivity from electrical qualification and teaches how to narrate those decisions. The entry point routes PCB electrical-review and copper-pour requests to it.++The current package contains nine focused skills, including both electrical-routing and ablation-routing guidance. The [KiCad showcase](https://wiki.adom.inc/adom/codex/files/docs/ASTRA-KICAD.md) explains how these methods reach other users through installation and the managed Codex entry point.
package.json+1−1@@ -4,7 +4,7 @@ "type": "app", "title": "Codex", "brief": "Codex in Adom Hydrogen: ecosystem setup, dock dashboard and live engineering demos.",- "version": "0.1.4",+ "version": "0.1.5", "description": "Adom ecosystem setup and a Hydrogen dashboard for Codex. Installs a managed instruction entry point and context helper, mounts the shared newbie panel, and presents verified Astra KiCad routing demonstrations. Codex Desktop bridge is planned.", "org": "adom", "needs_sudo": false,