Upgrading from v0.76.0

  1. Stop sync --watch and migrate before installing. Narrow globs without alwaysApply now request conditional activation; add alwaysApply: true where unconditional loading was intended. Catch-all patterns stay always on. Unknown config keys and misspelled targets now stop loading, including local overrides.
  2. Align pins, then install. Manually update existing exact requires and schema pins to 0.77.0/v0.77.0; keep a deliberate minimum/range that accepts it. Do this before a package postinstall can sync. Choose your existing channel:

Prebuilt macOS binaries require macOS 13+. On macOS 12, use Go 1.26.8 or a newer 1.26 patch with GOTOOLCHAIN=local go install github.com/chemaclass/agnostic-ai/cmd/agnostic-ai@v0.77.0. Other install channels.

Standalone macOS 13+/Linux: agnostic-ai upgrade --version v0.77.0.

Project npm dependency: npm install --save-dev --save-exact agnostic-ai@0.77.0.

MCP re-import converts literal env/headers values, including non-secrets, into references. Set the named variables or restore non-secret literals; Continue IDE needs an ignored .env. Regenerate and review before restarting watchers:

agnostic-ai sync --plan
agnostic-ai sync
agnostic-ai sync --check
agnostic-ai lint

Use the local runner for project dependencies. Check agnostic-ai --version and commit pins, lockfile and tracked outputs together.

What agnostic-ai changed

Add a tool without losing native configuration

agnostic-ai use codex

use enables a target, adopts its native config where supported, and syncs; it also initializes new projects. Import previews expose conflicts before writes. Sync protects unimported instructions, backs up generated-file edits, and uses a project lock to prevent competing writers. Use and import, edit safeguards.

Share sources outside the checkout

Absolute directories now work through import, preview, sync, validation and watch:

sources:
  rules: /srv/team-specs/rules
  skills: /srv/team-specs/skills

Provide them on each machine. Imports write there; previews show destinations without writing. Source paths.

Use Codex aliases in model tiers

Alias in a spec or tierID written by v0.77.0
solgpt-6.1-sol
lunagpt-6-luna
astragpt-6-astra
models:
  strong: {claude: opus, codex: sol, effort: high}
  balanced: {claude: sonnet, codex: gpt-5.6-terra, effort: medium}
  fast: {claude: haiku, codex: luna, effort: low}

Use model: strong in an agent spec. Aliases resolve to explicit IDs; use exact IDs to hold a model steady. Terra uses its full ID in v0.77.0. Models and aliases.

Keep credentials portable and checks useful

Project imports replace credentials with ${NAME} references; sync translates them to native syntax or omits unsupported fields with a note. Explicit spec literals remain literal. Continue uses its secrets syntax and IDE .env files. alwaysLoad and bareElicitationCapability retain explicit true/false for Claude. MCP references.

Strict validation catches ignored config typos before writes. Rule activation follows narrow patterns where supported, with v0.76's selector union still applying. sync --check --plan now fails on drift. Rules, complete release notes.

What changed in the targets

  • Claude Code 2.1.287 (October 1): MCP deferral/handshake flags round-trip in v0.77. Executable Mods can use existing skill assets and native Settings; inspect their code because they run outside the Bash sandbox. Release notes, Mods.
  • Claude Code 2.1.286 (September 30): eligible verify/simplify skills are requested before commits. Sync team checks; use hooks or CI for enforcement. Check skills.
  • Kiro (workflows September 30; resources checked October 2): background workflows need native recipes, which agnostic-ai does not emit. Resource lists still inherit context unless native inheritance is disabled. Workflows, resources.
  • Cursor (references checked October 2): .cursor/config/bugbot.yaml service policy remains native-managed; agnostic-ai writes review instructions. Shared .agents/skills/ discovery is independent of compatibility imports. Bugbot, skills.
  • Copilot CLI (reference checked October 2): repository hooks stay inside an enabled sandbox. Adjust native grants when hooks need additional paths. Hooks.
  • Factory (reference/release checked October 2): image-model selection supports native Settings passthrough, without import round-trip support. Remove declared marketplaces at their project/organization source. Settings, release notes.
  • Codex 0.160.0 (October 1): Guardian context controls remain experimental and off by default, with native TOML configuration only. Release notes.