Getting started¶
Install¶
curl -fsSL https://raw.githubusercontent.com/KC-OU/KC-LEGO-CLI-NEW/main/scripts/install.sh | sh
Downloads the latest release, verifies its SHA-256, checks the binary runs, and installs wms-go into /usr/local/bin.
Download the .deb, .rpm or .apk from the releases page
and install it with your package manager. It also installs the systemd units.
docker run --rm ghcr.io/kc-ou/kc-lego-cli-new:latest version
The image runs the sync engine (wms sync serve); the interactive interface needs a real terminal on the host.
go install github.com/KC-OU/KC-LEGO-CLI-NEW/cmd/wms@latest
Needs Go 1.26 or newer. No C compiler.
Check the install and see what is set up:
wms-go doctor
doctor reports OK / WARN / FAIL for each thing it checks and says what to do about each. Warnings such as "Part-DB API
token: not set" are fine for now.
The first ten minutes¶
1. Load the offline catalog¶
wms-go lego catalog refresh
One download of about 16 MB from Rebrickable's free data files (allowed once a day). From now on search and adding work with no internet. No download possible? Load it from files.
2. Search¶
wms-go lego search sets falcon
wms-go lego search parts "brick 2 x 4"
3. Add a part¶
wms-go lego add-part 3001 --color red --qty 25
Or do it in the interface, which asks for each thing in turn: start it with wms-go, press Ctrl-K, type add owned.
KCPARTS 2026-09-20 12:00:00 PICK CHOOSE User: admin (100%) Role: admin Source: ModernWMS ADMIN ──────────────────────────────────────────────────────────────────────────────── 1=Overview 2=PartDB Hub 3=Operations 4=Script Hub 5=LEGO Collection 6=Admin ──────────────────────────────────────────────────────────────────────────────── F1=Help F2=Go To F3=Exit F9=Undo F6=Quick Add F10=Lock F12=Cancel Colours 3001 comes in: 1. Blue 2. Red Type a number, or part of a name to narrow the list. Anything else is kept as a typed colour. Blank = no colour. Colour: ✓ 3001 — Brick 2 x 4 (from offline catalog).
4. See what you could build¶
wms-go lego build
5. Open the interface¶
wms-go
Sign in with a ModernWMS or Part-DB account. Press F1 for the keys on any screen and Ctrl-K to jump anywhere.
KCPARTS 2026-09-20 12:00:00 MAIN MODERNWMS & PART-DB CONTROL SUITE User: admin (100%) Role: admin Source: ModernWMS ADMIN ──────────────────────────────────────────────────────────────────────────────── 1=Overview 2=PartDB Hub 3=Operations 4=Script Hub 5=LEGO Collection 6=Admin ──────────────────────────────────────────────────────────────────────────────── F1=Help F2=Go To F3=Exit F9=Undo F6=Quick Add F10=Lock F12=Cancel ╭──────────────────────────────────── Menu ────────────────────────────────────╮ │ Main Navigation Hub: │ │ > 1. Overview │ │ 2. PartDB Hub │ │ 3. Operations │ │ 4. Script Hub │ │ 5. LEGO Collection │ │ 6. Admin │ │ 9. Log out │ │ 0. Exit │ ╰──────────────────────────────────────────────────────────────────────────────╯ ✓ Login Successful! Welcome, admin [ModernWMS] (admin). First sign-in recorded … ──────────────────────────────────────────────────────────────────────────────── F1=Help F2=Go To F3=Exit F9=Undo F6=Quick Add F10=Lock F12=Cancel Selection or command ===>
Optional next steps¶
| You want | Do |
|---|---|
| Parts to appear in Part-DB | Create an Edit-level API token in Part-DB and paste it under Admin → Settings & API Keys → Part-DB API Token. Until then parts are saved locally and flagged not in Part-DB yet. |
| Live Rebrickable lookups | Add a free key under Settings & API Keys → Rebrickable. Not needed for anything offline. |
| Prices | Set up BrickLink. |
| Alerts on your phone | Alerts. |
| Reach it from another machine | Telnet and the web terminal. |
| Import your old collection | wms-go lego import (the legacy JSON files) or wms-go lego import-parts (Export and import). |