Upgrading from v0.76.0
- Stop
sync --watchand migrate before installing. NarrowglobswithoutalwaysApplynow request conditional activation; addalwaysApply: truewhere unconditional loading was intended. Catch-all patterns stay always on. Unknown config keys and misspelled targets now stop loading, including local overrides. - Align pins, then install. Manually update existing exact
requiresand schema pins to0.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 tier | ID written by v0.77.0 |
|---|---|
sol | gpt-6.1-sol |
luna | gpt-6-luna |
astra | gpt-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/simplifyskills 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.yamlservice 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.