os-init/README.md

os-init

Post-install initialization scripts, one directory per operating system.

Directory	Target	Script
debian/	Debian 13 (GNOME desktop)	debian13-init.sh
macos/	macOS	macos-init.sh

Conventions

• Each OS directory is self-contained: a single script, run directly on the target machine, plus its own AGENTS.md for OS-specific rules.
• Scripts must be idempotent (safe to run repeatedly) and must not change security-sensitive settings without an explicit opt-in.
• Add a new OS by creating <os>/ with <os><version>-init.sh and adding a row to the table above.

Known Issues

macOS: Wubi commits the candidate when switching to English

While composing with the built-in Wubi input method (com.apple.inputmethod.SCIM.WBX), for example typing wq with the candidate 你 showing, pressing Shift to switch to English commits 你 instead of the raw letters wq.

• Status: open. There is no system setting for it, and the state lives in the input method's sandbox container, so macos-init.sh cannot configure it.
• Workarounds: press Esc to cancel the composition before switching; press Return (not verified); or switch to the ABC keyboard (Caps Lock or Ctrl+Space) before typing.
• Possible fix: use Squirrel (Rime) with ascii_composer/switch_key: Shift_L: commit_code in default.custom.yaml. It must be installed manually, as the repository forbids curl | sh.
• Expected behavior: Shift during composition should commit the raw letters and then switch to English; only Space, a number key, or Return should confirm a candidate.
• Upstream: the input method is built into macOS and maintained by Apple. Report it through Feedback Assistant (macOS > Input Methods).