You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
System mode (v1): init hints name the system Python without the clone, which fails under PEP 668 #796
Debian 12 and Ubuntu 23.04+ refuse sudo pip install into the system Python (PEP 668), so sudo /usr/bin/python3 -m tracekit init works only from inside a clone of the release. Doctor's v2 re-init hint says so: it starts with "from a root-owned clone of the release (docs/deploy.md#laptop-system-mode)" (REINIT, tracekit/doctor.py:49-51).
Four v1 system-mode hints still give the bare command, sudo /usr/bin/python3 -m tracekit init --user <agent-user>:
tracekit/install.py:1207: migrate --system when there is no system-mode signer;
tracekit/install.py:1397 and :1400: the fixes of the D-SYSTEM-CONFIG results in v1_results;
tracekit/install.py:1402: reinstall, the fix for the signer python, venv config, runtime and unit file checks.
tracekit/install.py:1214, in the same migrate_system as line 1207, already adds "from a root-owned clone". The docs give the bare command too: docs/signing.md:10 (the System row), docs/doctor.md:111 (the fix for these checks), and the terminal recordings docs/walkthrough/terminal/06-demo-v1.txt:5 and docs/walkthrough/terminal/11-claude-code.txt:31 (the v2 form there, with --v2).
This is the PEP 668 item of #464, split out. The code hints for v2 that item listed now use REINIT; the rest are listed here.
Task
In tracekit/install.py, write the v1 hint once, worded like REINIT: "from a root-owned clone of the release (), sudo /usr/bin/python3 -m tracekit init --user ", with the link from wiki_url('docs/deploy.md', 'laptop-system-mode') (install.py imports wiki_url at line 32). Use it at lines 1207, 1397, 1400 and 1402.
In docs/signing.md:10 and docs/doctor.md:111, say the command runs from a root-owned clone of the release, linking deploy.md#laptop-system-mode. In the two terminal recordings, show the hint as the code prints it now.
Add a test to tests/test_system_install.py, class Doctor, next to test_fails_without_a_system_install (line 480): with client.system_config returning None, the D-SYSTEM-CONFIG fix line names the root-owned clone. It must fail on main.
Done when: the four hints, the two docs lines and the two recordings name the clone route, and pytest tests/test_system_install.py tests/test_docs.py passes.
Comment here to claim it. Commits need a DCO sign-off (git commit -s).
One v1 hint in tracekit/install.py, worded like doctor's REINIT and linking wiki_url('docs/deploy.md', 'laptop-system-mode'), used at lines 1207, 1397, 1400 and 1402
Docs:docs/signing.md:10 and docs/doctor.md:111 say the command runs from a root-owned clone of the release, linking deploy.md#laptop-system-mode
Recordings:06-demo-v1.txt:5 and 11-claude-code.txt:31 show the hint as the code prints it now
Test: in tests/test_system_install.py (Doctor), with client.system_config returning None, the D-SYSTEM-CONFIG fix line names the root-owned clone; it fails on main
It's yours; the plan covers it. For the two recordings, re-record them with the script that made them (or edit only the hint line, and say which in the PR), so they still match what the code prints. Commits need a DCO sign-off (git commit -s).
Activity
FTFaruque commentedon Nov 13, 2026
Hi, I'd like to take this one.
My Plan:
tracekit/install.py, worded like doctor'sREINITand linkingwiki_url('docs/deploy.md', 'laptop-system-mode'), used at lines 1207, 1397, 1400 and 1402docs/signing.md:10anddocs/doctor.md:111say the command runs from a root-owned clone of the release, linkingdeploy.md#laptop-system-mode06-demo-v1.txt:5and11-claude-code.txt:31show the hint as the code prints it nowtests/test_system_install.py(Doctor), withclient.system_configreturningNone, theD-SYSTEM-CONFIGfix line names the root-owned clone; it fails onmainLoopGlitch26 commentedon Nov 13, 2026
It's yours; the plan covers it. For the two recordings, re-record them with the script that made them (or edit only the hint line, and say which in the PR), so they still match what the code prints. Commits need a DCO sign-off (
git commit -s).Recording: doctor's D-PROCESS-BOUNDARY line as it prints now (Cygnux-…
System mode (v1): init hints name the root-owned clone (#796) (#802)