APP v0.0.1 Pending Review

service-kicad — Shared Headless KiCad CLI

DRC, ERC, SVG/Gerber/STEP/GLB export, symbol/footprint/3D-model lookup. Every Adom tool shells to this CLI instead of calling the HTTP API directly.

💬 Sample prompts Paste any of these into Claude Code to use this app

Run DRC service-kicad pcb drc board.kicad_pcb

Export GLB service-kicad pcb export glb board.kicad_pcb --out board.glb

Export gerbers service-kicad pcb export gerbers board.kicad_pcb --out ./gerbers/

Symbol SVG service-kicad sym svg Connector_Generic Conn_01x04

⚡ Install this app

Paste this into Claude Code (VS Code panel, Adom editor, or terminal) to install:

I want to install the "service-kicad — Shared Headless KiCad CLI" app from the Adom Wiki (https://wiki-ufypy5dpx93o.adom.cloud/wiki/apps/service-kicad). For the Docker CLI: curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/service-kicad/service-kicad -o /tmp/service-kicad && chmod +x /tmp/service-kicad && sudo install -m 0755 /tmp/service-kicad /usr/local/bin/service-kicad && service-kicad install Then verify the install works.

Download v0.0.1

⊞ Windows coming soon

macOS coming soon

🐧 Linux coming soon

🐳 Adom Docker CLI service-kicad ·

See all releases on GitHub

service-kicad — Shared Headless KiCad CLI

Rust CLI that wraps the remote service-kicad container. The production URL is baked into the binary at compile time — no env vars needed.

Install

Paste into Claude Code:

Install service-kicad. Download from
https://wiki-ufypy5dpx93o.adom.cloud/static/apps/service-kicad/service-kicad
→ /tmp/service-kicad, chmod +x, sudo install to /usr/local/bin/service-kicad,
then run `service-kicad install` to deploy the skill + bash completions.
Verify with `service-kicad health`.

Or manually:

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/service-kicad/service-kicad \
  -o /tmp/service-kicad && chmod +x /tmp/service-kicad \
  && sudo install -m 0755 /tmp/service-kicad /usr/local/bin/service-kicad \
  && service-kicad install

Usage

# Health check
service-kicad health

# DRC / ERC
service-kicad pcb drc board.kicad_pcb
service-kicad sch erc schematic.kicad_sch

# Export
service-kicad pcb export gerbers board.kicad_pcb --out ./gerbers/
service-kicad pcb export glb board.kicad_pcb --out board.glb
service-kicad pcb export step board.kicad_pcb --out board.step

# Symbol / footprint SVG
service-kicad sym svg Connector_Generic Conn_01x04
service-kicad fp svg Connector_PinHeader_2.54mm PinHeader_1x04_P2.54mm_Vertical

# 3D model download
service-kicad model fetch Connector_PinHeader_2.54mm.3dshapes/PinHeader_1x04_P2.54mm_Vertical.step

Override URL (dev only)

export KICAD_SERVICE_API=http://127.0.0.1:8780

Container

Production: https://kicad-rk5ue5pcfemi.adom.cloud (KiCad 10.0.2, 56 cores, 125 GB RAM, auto-deploys from adom-inc/service-kicad main).

SERV

service-kicad 19 days ago

service-kicad CLI v0.0.1 — headless KiCad operations from any Adom container

Initial binary upload — v0.0.1 with baked-in production URLJohn Lauer · 19 days ago

5.6 MB

⤓

Install notes

Adom Docker CLI install steps

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/service-kicad/service-kicad -o /tmp/service-kicad && chmod +x /tmp/service-kicad && sudo install -m 0755 /tmp/service-kicad /usr/local/bin/service-kicad && service-kicad install

AI Skill — how Claude uses this app

Edit AI Skill

name: service-kicad description: > Shared headless KiCad service for every Adom tool and user container. Run DRC, ERC, export to SVG/Gerber/STEP/GLB, look up symbols, footprints, and 3D models — all via the `service-kicad` CLI. No local KiCad install needed. Trigger words: kicad service, service-kicad, kicad-cli remote, kicad DRC, kicad ERC, export gerbers, export step, export glb, kicad-packages3d, shared kicad library, headless kicad.

service-kicad — shared headless KiCad

A shared KiCad 10 service running on a dedicated container. Every Adom tool that needs KiCad operations (DRC, ERC, exports, library lookups) shells to the service-kicad CLI instead of installing KiCad locally.

Installation

Paste into Claude Code:

Install service-kicad. Download the binary from
https://wiki-ufypy5dpx93o.adom.cloud/static/apps/service-kicad/service-kicad
→ /tmp/service-kicad, chmod +x, sudo install to /usr/local/bin/service-kicad,
then run `service-kicad install` to deploy the skill + bash completions.
Verify with `service-kicad health`.

When to use

Always use the service-kicad CLI — never curl the service URL directly, and never import or require kicad-api-client.js from Node.js scripts. The CLI has the production endpoint baked in and insulates you from container reprovisions that change the URL.

# Good — shell to the CLI
service-kicad pcb drc board.kicad_pcb
service-kicad pcb export glb board.kicad_pcb -o board.glb
service-kicad sym svg Connector_Generic Conn_01x04

# Bad — hardcoded URL, breaks on reprovision
curl -X POST --data-binary @board.kicad_pcb https://...adom.cloud/kicad/pcb/drc

# Bad — JS client is for browser-only webviews, not Node.js
import { pcbDrc } from './kicad-api-client.js';

Don't apt-install kicad on your container just to render one SVG.

CLI commands

# Diagnostics
service-kicad health
service-kicad version
service-kicad config

# PCB
service-kicad pcb drc board.kicad_pcb [--format json] [--out report.json]
service-kicad pcb export svg board.kicad_pcb [--out board.svg]
service-kicad pcb export gerbers board.kicad_pcb [--out ./gerbers/]
service-kicad pcb export step board.kicad_pcb [--out board.step]
service-kicad pcb export glb board.kicad_pcb [--out board.glb]

# Schematic
service-kicad sch erc schematic.kicad_sch [--format json]
service-kicad sch export svg schematic.kicad_sch [--out sch.svg]
service-kicad sch export pdf schematic.kicad_sch [--out sch.pdf]
service-kicad sch export bom schematic.kicad_sch [--out bom.csv]

# Symbol / footprint SVG
service-kicad sym svg LIBRARY NAME [--out symbol.svg]
service-kicad fp svg LIBRARY NAME [--out footprint.svg]

# 3D model download
service-kicad model fetch PATH [--out model.step]

Troubleshooting

Exit	Meaning	Fix
0	ok	—
1	input invalid	Check path + that file parses under kicad-cli
2	service unreachable	`service-kicad health` to confirm; the container may be restarting
3	auth failed (401/403)	`adom-cli auth refresh`
4	service-side error	CLI prints stderr; usually input-specific

Override URL (dev only)

export KICAD_SERVICE_API=http://127.0.0.1:8780

Sub-Skills
?
What are Sub-Skills?
Sub-skills are community-contributed AI skill extensions for this component. They teach AI assistants about specific tools, configurators, or workflows.

Examples:

A manufacturer’s configuration tool for a motor controller

A community-written design guide for an amplifier circuit

An automated test/validation script for a sensor module

How to add one: Click Add Sub-Skill, provide the URL to your skill and a brief description. Submissions are reviewed by the Adom team before going live.

No sub-skills yet. Be the first to contribute one!

🔎 How Claude finds this page (discovery snippet)

This page opts into Adom Wiki auto-discovery. When a user working in Claude Code mentions any of the trigger phrases below, Claude can proactively suggest this page. The pitch is exactly what Claude will say.

Pitch

"Shared headless KiCad behind two HTTPS URLs — KiCad 10 default + KiCad 9 opt-in fallback. CLI + HTTP service every Adom tool shells to instead of installing KiCad (~600 MB) locally. Hosts the full kicad-packages3d STEP library + symbol/footprint trees on both channels."

Triggers

"kicad service", "service-kicad", "kicad-cli remote", "kicad 9 vs 10", "kicad 10", "kicad 9 fallback", "KICAD_SERVICE_API", "run drc", "design rule check", "kicad erc", "export gerbers", "export step from kicad", "export glb from kicad", "kicad-packages3d", "fetch 3d model", "fetch step file", "fetch wrl", "kicad symbols library", "kicad footprints library", "headless kicad", "shared kicad"

Page URL

/apps/service-kicad

service-kicad — Shared Headless KiCad CLI

Download v0.0.1

service-kicad — Shared Headless KiCad CLI

Install

Usage

Override URL (dev only)

Container

Install notes

AI Skill — how Claude uses this app

service-kicad — shared headless KiCad

Installation

When to use

CLI commands

Troubleshooting

Override URL (dev only)

Recent activity