Skip to content

Agent-fox

v4.0.3 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agentic-ai agentic-workflow

Affected surfaces

breaking_upgrade

Summary

AI summary

Config 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.toml exists, it is the sole config source — the global ~/.agent-fox/config.toml is 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

Mental Model

  • No local config → global config at ~/.agent-fox/config.toml applies
  • 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

Track Agent-fox

Get notified when new releases ship.

Sign up free

About Agent-fox

All releases →

Related context

Earlier breaking changes

  • v3.6.4 Remove deprecated coding field from default config template.
  • v3.6.2 Removes fallback_model option from session pipeline

Beta — feedback welcome: [email protected]