Skip to content

Agent-fox

v4.0.0 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

Summary

AI summary

Updates Bug Fixes, Highlights, and Full Changelog https://github.com/agent-fox-dev/agent-fox/compare/v4.0.0-rc5...v4.0.0 across a mixed release.

Full changelog

agent-fox v4.0.0

First stable release of the agent-fox v4 series.

Highlights

  • Standalone nightshift CLI — Night Shift daemon is now its own package (nightshift) with its own entry point, separate from the af CLI
  • Spec format v1.2 — New JSON-based spec format (via afspec library) replacing the old markdown format; specs 132–135 cover the transition
  • DuckDB reader/writer split — Separate read and write connections for concurrent safety
  • Enriched session summaries — Structured enrichment fields in session summary schema for better post-session analysis
  • Global + local config system — New af init scaffolding with global and local config creation, merge, and CLI wiring
  • Drift finding supersession — File-based drift finding lifecycle with supersede-by-files capability
  • Knowledge system overhaul — Removed legacy knowledge subsystems (extraction, embeddings, search, retrieval, causal, etc.) in favor of a streamlined three-channel architecture
  • Worktree path collision fix — Role/mode-aware worktree paths prevent collisions in parallel sessions

Bug Fixes

  • Purge stale audit files on startup (#651)
  • Remove python-specific tool references from agent prompt templates (#634)
  • Auto-commit uncommitted changes from coder sessions
  • Order issues by priority label in topological sort (#632)
  • Replace second knowledge store connection with cursor (#627)
  • Deduplicate issue summaries via af:implemented label (#648)
  • Hot-loader respects --spec filter (#630)
  • Cross-check and remove orphaned worktree dirs (#618)
  • Don't block on WEAK audit findings (#639)
  • Shield worktree cleanup from asyncio cancellation (#638)

Full Changelog

https://github.com/agent-fox-dev/agent-fox/compare/v4.0.0-rc5...v4.0.0

Breaking Changes

  • Removed legacy knowledge subsystems (extraction, embeddings, search, retrieval, causal) in favor of a streamlined three‑channel architecture
  • Spec format v1.2 replaces the old markdown format; existing markdown specs must be migrated to JSON

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]