How igmarmelis/kibridge works
KiBridge is a KiCad plugin with two user-controlled workflows: inspect/export a board for review and apply approved workspace suggestions; or send a board to the local KiRouter web app, route it, and import the result. KiRouter also provides board visualization and first-pass DRC. The graph reflects documented flows and indexed or excerpted calls; some unsampled workspace and UI internals are represented at directory level, and uncertain links are omitted.
Main entry points: action_plugin.py Toolbar actions · server.py HTTP API server · workspace_applier.py Validation and apply · __init__.py Routing engine manager
Components 27
KiBridge plugin
- Toolbar actions
plugin/kibridge/action_plugin.py - Board inspection
plugin/kibridge/board_inspector.py - Inspection reports
plugin/kibridge/report_writer.py - Send board
plugin/kibridge/send_to_kirouter.py - HTTP board client
plugin/kibridge/kirouter_client.py - Import route result
plugin/kibridge/import_from_kirouter.py - Schema version
plugin/kibridge/version.py
Workspace assistance
- Workspace export
plugin/kibridge/workspace_exporter.py - Open workspace
plugin/kibridge/workspace_open.py - Workspace suggestions
workspace_template - Apply suggestions
plugin/kibridge/workspace_apply.py - Validation and apply
plugin/kibridge/workspace_applier.py - Script sandbox
plugin/kibridge/script_runner.py - Safety checks
plugin/kibridge/safety.py - Board operations API
plugin/kibridge/kibridge_api.py
KiRouter app
- HTTP API server
router/kirouter/server.py - Loaded board state
router/kirouter/state.py - Canvas web app
router/kirouter/static
Routing and checks
- Routing engine manager
router/kirouter/router_engine/__init__.py - First-pass DRC
router/kirouter/drc.py
Freerouting adapter
- DSN export
router/kirouter/freerouting/dsn_export.py - Freerouting process
router/kirouter/freerouting/runner.py - SES result import
router/kirouter/freerouting/ses_import.py
Other components
- KiCad user
- Copilot
- Browser user
- KiCad board
Connections 31
- KiCad user → Toolbar actions: uses tools
README.md - Toolbar actions → Board inspection: dispatches inspection
plugin/kibridge/action_plugin.py - Board inspection → KiCad board: reads board
plugin/kibridge/board_inspector.py - Toolbar actions → Inspection reports: writes reports
plugin/kibridge/action_plugin.py - Toolbar actions → Open workspace: dispatches open
plugin/kibridge/__init__.py - Open workspace → Workspace export: creates snapshot
plugin/kibridge/workspace_open.py - Workspace export → Board inspection: uses inspection
plugin/kibridge/workspace_exporter.py - Copilot → Workspace suggestions: reviews snapshot
README.md - Toolbar actions → Apply suggestions: dispatches apply
plugin/kibridge/__init__.py - Apply suggestions → Validation and apply: invokes
plugin/kibridge/workspace_apply.py - Validation and apply → Script sandbox: runs scripts
plugin/kibridge/workspace_applier.py - Validation and apply → Safety checks: checks safety
plugin/kibridge/workspace_applier.py - Validation and apply → Board operations API: applies actions
plugin/kibridge/workspace_applier.py - Board operations API → KiCad board: modifies board
README.md - Toolbar actions → Send board: dispatches send
plugin/kibridge/__init__.py - Send board → HTTP board client: builds and posts
plugin/kibridge/send_to_kirouter.py - HTTP board client → HTTP API server: uploads JSON
README.md - HTTP API server → Loaded board state: stores board
router/kirouter/server.py - Browser user → Canvas web app: views and controls
README.md - Canvas web app → HTTP API server: calls API
README.md - HTTP API server → Routing engine manager: submits route
router/kirouter/server.py - HTTP API server → First-pass DRC: runs DRC
router/kirouter/server.py - Routing engine manager → DSN export: exports design
README.md - Routing engine manager → Freerouting process: runs subprocess
README.md - Routing engine manager → SES result import: parses session
router/kirouter/router_engine/__init__.py - HTTP API server → Loaded board state: reads board
router/kirouter/server.py - Toolbar actions → Import route result: dispatches import
plugin/kibridge/__init__.py - Import route result → HTTP board client: fetches route
plugin/kibridge/import_from_kirouter.py - HTTP board client → HTTP API server: gets result
README.md - Import route result → KiCad board: backs up and applies
README.md - Send board → Schema version: uses version
plugin/kibridge/send_to_kirouter.py