qmk/qmk_cli

A program to help users work with QMK

Stars: 187
Forks: 53
Open beginner issues: 0
Indexed issues: 7

Dominant language: Python
License: MIT
Last GitHub push: Aug 3, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

7 open issues indexed

[Bug] qmk setup fails with "fatal: Unable to read current working directory" when deleting existing qmk_firmware Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

qmk/qmk_cli#253 · 1 comment · Opened Aug 30, 2026
[Feature Request] Use Shallow Clone for firmware Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

qmk/qmk_cli#235 · 1 comment · Opened May 23, 2026
[Bug] qmk make fails with latest ghcr.io/qmk/qmk_cli due to missing Python packages. Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 38/100

qmk/qmk_cli#220 · 2 comments · Opened Dec 13, 2025
[Bug] No module named 'qmk.cli.ci.validate_aliases' after fresh install Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 25/100

qmk/qmk_cli#174 · 1 comment · Opened Mar 24, 2024
[Bug] qmk setup -H <path> ignores <path> but still uses user.qmk_home read from .config/qmk/qmk.ini Open

bug help wanted

Difficulty 3/5 1-2 days Newbie friendliness 45/100

qmk/qmk_cli#170 · Opened Dec 30, 2023
[Feature Request] Warn when setting qmk_{firmware,userspace} paths if they contain spaces Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

qmk/qmk_cli#167 · Opened Dec 17, 2023
[Feature Request] Catch `KeyboardInterrupt`s (CTRL-C) in the CLI Open

enhancement help wanted

Difficulty 3/5 1-2 days Newbie friendliness 35/100

qmk/qmk_cli#160 · 1 comment · Opened Sep 29, 2023

A short digest of beginner-friendly GitHub issues.