docs: settings pull-through after #207 - secrets file path on Windows and with XDG in the 1Password how-to; 1Password approval is per terminal session, not per value
CI / verify (push) Successful in 8m4s
CI / pwsh (push) Successful in 2m31s

Files changed:
- docs/explanation/configuration-tiers.md
- docs/how-to/use-1password-for-settings.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-10 18:10:07 +02:00
1 parent f6aaadc413
commit e085a8b6c1
2 files changed
+7 -4

No files matched your search

+3 -2
View File
@@ -76,8 +76,9 @@ What limits the exposure without preventing it:
- a 1Password vault of its own for this instance's entries, so an unlocked `op` reaches nothing
else;
- the approval prompt of the 1Password desktop app, which asks a human before each new process
reads a value;
- the approval prompt of the 1Password desktop app, which asks a human before the CLI may read
anything - per terminal session, not per value, so it stops a session nobody approved and not
one that already was;
- in CI, a service account that sees only that vault.
The rule in [AGENTS.md § Settings](../../AGENTS.md#settings) - a secret never passes through the
+4 -2
View File
@@ -36,8 +36,10 @@ A reference by name works the same way without `op`:
- set the reference: `tools/wikitool config set <section>.<field> --ref <name>`;
- put the value into `WIKITOOL_SECRET_<NAME>` (the name upper-cased) in the environment, or into
the secrets file `~/.config/chemenu/<instance_id>/secrets.json` as `{"<name>": "<value>"}`,
readable by you only (`chmod 600`). The `instance_id` is in `wikitool.json`.
the secrets file as `{"<name>": "<value>"}`: `~/.config/chemenu/<instance_id>/secrets.json`
(`$XDG_CONFIG_HOME` instead of `~/.config` when it is set), readable by you only
(`chmod 600`) - on Windows `%APPDATA%\chemenu\<instance_id>\secrets.json`. The `instance_id`
is in `wikitool.json`.
## In CI