This release includes 2 breaking changes for platform teams planning a safe upgrade.
Published 24d
AI Agents & Assistants
✓ No known CVEs patched
✓ No known CVEs patched in this version
Topics
agentic-ai
agentic-workflow
Affected surfaces
breaking_upgrade
Summary
AI summaryConfig loading now uses a sole local .agent-fox/config.toml when present, ignoring the global config.
Full changelog
What's Changed
Refactors
- Simplified local config.toml creation and loading (#667)
- Local config is now opt-in via
af init --config(replaces--force) - When a local
.agent-fox/config.tomlexists, it is the sole config source — the global~/.agent-fox/config.tomlis ignored entirely - Local config template now uses the same promoted-fields style as the global config
- Removed config merge logic and the save/restore hack from
init_cmd
- Local config is now opt-in via
Mental Model
- No local config → global config at
~/.agent-fox/config.tomlapplies - Local config present → only local config applies (global ignored)
Install / Upgrade
curl -fsSL https://raw.githubusercontent.com/agent-fox-dev/agent-fox/refs/heads/main/install.sh | sh
Full Changelog: https://github.com/agent-fox-dev/agent-fox/compare/v4.0.2...v4.0.3
Breaking Changes
- Removed merge logic; when `.agent-fox/config.toml` exists it is the sole config source, completely ignoring `~/.agent-fox/config.toml`.
- Changed flag: `--force` removed; use `af init --config` to opt‑in to local config creation.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Agent-fox
All releases →Related context
Related tools
Beta — feedback welcome: [email protected]