Skip to content

Docs for firmware 3.1.0: user input modes, web derive mode, CLI additions, retired quick setup / plausible deniability / Travel Edition - #5

Open
0c-coder wants to merge 7 commits into
trustcrypto:mainfrom
0c-coder:docs/session-2026-09-07
Open

Docs for firmware 3.1.0: user input modes, web derive mode, CLI additions, retired quick setup / plausible deniability / Travel Edition#5
0c-coder wants to merge 7 commits into
trustcrypto:mainfrom
0c-coder:docs/session-2026-09-07

Conversation

@0c-coder

@0c-coder 0c-coder commented Sep 8, 2026

Copy link
Copy Markdown

Documentation for the firmware/CLI/App changes on the feat/user-input-modes branches (libraries ee95f16, OnlyKey-Firmware 8306772, python-onlykey ff44b79, lib-agent 237692c, OnlyKey-App f9ddf08). Written to be merged together with those; the version is referred to as 3.1.0 throughout.

What changed and where

page change
command-line new capabilities; storedkeymode / derivedkeymode are 0 challenge / 1 button press (default) / 2 no press (dev firmware only), config mode required; new webderivemode; 2ndprofilemode only accepts 1; sysadminmode and lockbutton had copy-pasted challenge-mode text — corrected; setkey/genkey add c (X25519 — x was documented as X25519 but is Ed25519), m (ML-KEM-768), w (X-Wing)
usersguide, duousersguide the three user input modes with the new default; new Web Derived Key User Input Mode section (#web-derive-mode); quick setup section replaced by a removal note; unconfigured-device button definitions
onlykey-agent button-press default and GPG notes; Derived key versions (--skey derived-v2, HKDF derivation added alongside the released one)
ite rewritten: Travel Edition retired, how to move a device to standard firmware
pdguide rewritten: plausible deniability retired; the automatic migration on first primary-PIN unlock; second PIN does not unlock until then; legacy support removed the release after
features, index, faq, webcrypt references updated to match

Slugs and anchors are unchanged so existing links (/ite, /pdguide, #derived-challenge-mode, #stored-challenge-mode, #quick-setup) still resolve.

Not covered (needs a decision first)

  • Screenshots in usersguide/app that show the "Plausible Deniability Profile" radio in the setup wizard.
  • An age-plugin-onlykey / onlyagent.app page — the web derive mode section links to onlyagent.app but there is no page for the derived X-Wing age workflow yet.

🤖 Generated with Claude Code

https://claude.ai/code/session_0159zPxi7DCuucC1ZcqYBB8W

T and others added 7 commits September 7, 2026 21:40
…ions, retired quick setup / plausible deniability / Travel Edition

- command-line: `capabilities`; `storedkeymode`/`derivedkeymode` now 0/1/2 with
  Button Press as the default and config mode required; new `webderivemode`;
  `2ndprofilemode` only accepts 1; `sysadminmode`/`lockbutton` descriptions were
  copy-pasted from the challenge-mode entries and are corrected; `setkey`/`genkey`
  gain `c` (X25519 - `x` was documented as X25519 but is Ed25519), `m`, `w`.
- usersguide / duousersguide: the three user input modes described once with the
  new default, plus the Web Derived Key User Input Mode section; quick setup
  section replaced by a note that it was removed; button definitions for an
  unconfigured device updated.
- onlykey-agent: button-press default, GPG notes, `--skey derived-v2` (HKDF
  derivation added alongside the released one).
- ite / pdguide: rewritten as retirement notices. pdguide documents the automatic
  migration of an existing plausible deniability profile (first primary-PIN
  unlock converts it; second PIN does not unlock until then) and the removal of
  legacy support in the following release. features / index / faq / webcrypt
  updated to match.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159zPxi7DCuucC1ZcqYBB8W
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159zPxi7DCuucC1ZcqYBB8W
Quick setup no longer exists, so the docs no longer describe it, not even as removed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159zPxi7DCuucC1ZcqYBB8W
Remove /ite from the sidebar and the guide index, and trim the features
note to plausible deniability only. The ite page stays as a retirement
notice for people who reach it by its old URL.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159zPxi7DCuucC1ZcqYBB8W
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant