Repository navigation
ContextOS 1.2.1 makes global agent instruction setup an explicit choice and strengthens installation and release validation.
Changes
- Global npm installation leaves user-wide coding-agent instruction files unchanged. Run
contextos enable --dry-run --jsonto preview optional setup, thencontextos enableto apply it. - Existing-project migration remains separate. Set
CONTEXTOS_SKIP_SETUP=1to defer automatic migration while that setting is active. For the older 1.2.0 package, bothCONTEXTOS_GLOBAL_INSTRUCTIONS=0andCONTEXTOS_SKIP_SETUP=1are needed to suppress both install-time hooks. - The upgrade guide covers removing older managed instruction blocks while preserving your guidance, later first-use migration, and recovery with saved data. Version 1.0.x daemons require an explicit manual stop; the installer does not force-kill them.
- Release validation includes direct upgrades from published 1.0.3 and 1.2.0, and packed-install checks on Linux, macOS and Windows with Node 22 and 24. npm publication uses the exact checksum-verified archive that passed these checks.
- The documentation site uses Next.js 16.4.6 to address GHSA-mfr8-8qww-v76h.
Update
npm install -g @siddharthakatiyar/contextos@1.2.1Reconnect your coding agent after updating. New projects still need contextos init.