Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
Open-source electrical CAD for machines and control panels: IEC schematics, live terminal/cable/wire lists, BOM, cabinet layout and PDF drawing sets. Local-first.
Saved setup from 1 min ago
Will it work on macOS?
docs/getting-started.mdCablePilot is a desktop app for the electrical design of machines and control panels: multi-page schematics with IEC symbols, reference designations, cross-references and wire numbers; terminal, cable and wire lists, PLC I/O lists and the BOM generated from the schematic; a cabinet layout in 2D and 3D; and a PDF drawing set in your company's frame and title block. It runs on your computer, needs no account and works offline.
Download the file for your computer from the latest release:
| Computer | File |
|---|---|
| Mac with Apple Silicon (M1 and later) | CablePilot-mac-arm64.dmg |
| Mac with an Intel processor | CablePilot-mac-x64.dmg |
| Windows 10 or 11 (64-bit) | CablePilot-win-x64.exe |
| Linux (64-bit) | CablePilot-linux-x86_64.AppImage |
The builds are not signed yet. On a Mac, open the app the first time with right-click > Open and confirm. On
Windows, choose More info > Run anyway if SmartScreen warns. On Linux, make the AppImage executable
(chmod +x CablePilot-linux-x86_64.AppImage) and run it.
Every feature is free for 30 days on each computer, with no account. After the trial CablePilot needs a license key, one per user or seat: see Pricing. Your projects and exports stay yours, also without a key.
-K1, -Q2...), following IEC 81346. R rotates and M mirrors while placing.08-E3 or 8.3, as set in the project settings).Everything you do can be undone (Ctrl+Z), including imports, renumbering and the assistant's proposals.
The command line at the bottom takes the commands electrical CAD users know: L, PL, REC, C, M, CO, RO,
MI, E, TR, EX, O, Z, ZE, U, PAN, LA, DI, plus CablePilot's own (INSERT, WIRE, NUMBER,
REPORT, CHECK, SIZE, ERP, LADDER, AUTOWIRE, HISTORY). Enter or Space repeats the last command,
Esc cancels. Points can be typed: 30,40 (absolute), @60,0 (relative), @50<90 (relative polar).
The status bar switches the drafting aids: grid F7, ortho F8, snap F9, object snap F3, polar
tracking F10. Press F1 for the full list of keys.
A project is one file, name.cablepilot.json: open, documented JSON that diffs well in Git
(file format). CablePilot autosaves while you work and offers to recover after a crash; History
keeps a daily backup and the versions you name, and restores one as a single undo step.
The AI assistant uses your own API key (Claude, OpenAI or Gemini), stored encrypted by your operating system. Open AI settings in the chat panel, paste the key and press Test key. The assistant proposes changes as a preview that you accept or reject; every claim shows its source, and electrical values are labelled as suggestions to confirm. Without a key, the app works fully.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/mojeee/cablepilot.git cd cablepilot
Node.js 24
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install 24
npm ci
npm run dev
npm test
The first release is being prepared. When it is out, download the file for your computer from the latest release:
| Computer | File |
|---|---|
| Mac with Apple Silicon | CablePilot-mac-arm64.dmg |
| Mac with Intel | CablePilot-mac-x64.dmg |
| Windows 10 or 11 (64-bit) | CablePilot-win-x64.exe |
| Linux (64-bit) | CablePilot-linux-x86_64.AppImage |
The builds are not signed yet: on a Mac open the app the first time with right-click > Open; on Windows choose More info > Run anyway. Until then, run it from source (below). Then follow Getting started.
Every feature is free for 30 days on each computer, with no account. After the trial CablePilot asks for a licence
key (CP1-…), one per user or seat: see Pricing (prices are not set
yet; request a key in GitHub Discussions). Your projects and
exports stay yours and stay readable without a key.
No reports for macOS yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.