Fonn 0.2.3

Fonn 0.2.3

A calmer fonn ui, and a new look for Fonn.

• Fonn has a logo: one line settling inside a rounded frame. It is the icon of fonn ui, the docs site and the repository, and the files are in brand/.

• Projects are a grid of cards with Open and Rules buttons, and a search box at the top that narrows them as you type.

• A project's overview shows three things: its filter mode, filter level and filter rules, each with where it comes from. One line says how much Fonn saved there once it filtered something.

• Link buttons look like the other buttons, and long folders keep their ~ at the start.

On the docs site, the "How it works" visualiser picks its sample from a dropdown, so its controls fit on one row.

Upgrade with brew upgrade --cask nord-forge/fonn/fonn. Documentation: https://fonn.nord-forge.dev.

Fonn 0.2.2

Fonn 0.2.2

fonn ui now puts hooks and filter rules first.

• Build a filter rule from real output. Paste what a command printed, click the lines the model does not need, and Fonn suggests a plain text for each one without its numbers or times. A live preview shows what goes, and marks lines about errors, failures or warnings that always stay.
• Projects have their own page, with search, instead of a list in the sidebar. A project you save settings or rules for stays listed before any agent works in it, and Forget takes it off the list without changing the project.
• The Rules page says its rules are global and links to each project's rules. Save rules and Add rule sit side by side.
• The overview and each project's overview lead with what the hook uses: hooks installed, filter rules, filter mode and level. Profile and subagents only apply when Fonn starts the agent, so they sit lower.
• Agent cards only show the actions that apply, with their buttons lined up, and disabled buttons no longer show a busy cursor.
• Paths in your home folder show as ~, so screenshots do not carry your user name.

Upgrade with brew upgrade --cask nord-forge/fonn/fonn. Documentation: https://fonn.nord-forge.dev.

Fonn 0.2.1

Fonn 0.2.1

• The Codex hook now has a name. Codex lists it as "Fonn output filter" in /hooks instead of "Unnamed hook".
• fonn hooks reports a Codex hook installed by 0.2.0 as written by an older Fonn. Run fonn hooks install --agent codex to add the name. Codex then asks you to trust the hook again in /hooks, because the hook changed.
• The install guide shows the plan Fonn prints before it writes, and the Codex review screens.

Upgrade with brew upgrade --cask nord-forge/fonn/fonn. Documentation: https://fonn.nord-forge.dev.

Fonn 0.2.0

Fonn 0.2.0

Fonn now works inside the agent you already use. Add its hook once and keep running claude, codex, Crush, OpenCode or a desktop app on top of them.

• Run fonn hooks install to add Fonn's output filter to Claude Code, Codex, Crush and OpenCode through their own user settings. Fonn shows a diff with likely secrets hidden and asks before writing. It keeps your other settings and hooks, saves your original once as <file>.fonn-backup, and only ever changes the exact entry it added. fonn hooks shows the status, fonn hooks uninstall removes the entry, and fonn hooks unlock clears a lock left by an earlier run. Codex still asks you to trust the hook in /hooks; Fonn never does that for you.
• The Homebrew hook uses the stable /opt/homebrew/bin/fonn link, so it keeps working after brew upgrade.
• Run fonn ui for a local web interface on 127.0.0.1 behind a private link. The Agents page installs, updates and removes hooks. Other pages edit global and project settings, write filter rules and try them on a test bench, approve project rules, manage profiles, and list every hooked session and launch with what was shortened and the full originals.
• Write your own filter rules: plain-text "remove lines containing" matches for commands with a given prefix. They never remove problem lines. Rules in a project's files apply only after you approve them with fonn config approve-rules.
• Save global and project settings with fonn config: profile, filter mode, filter level and subagents.
• Clean up saved originals with fonn records clean --older-than <days>, or from the Activity page in fonn ui. Nothing is deleted on its own.
• Choose from built-in profiles for every listed Codex model, and run open models through Codex with a profile source, such as Ollama or LM Studio.
• Run fonn chat --model <model> for a small coding agent for open models with the filter built in. Its first request is under 1,000 tokens. It asks before every command and file change, and before reading likely secrets or sending files to a remote server.
• Use the standalone filter with Crush, OpenCode and Ollama, with a guide for other agents.

Documentation: https://fonn.nord-forge.dev. Upgrade with brew upgrade --cask nord-forge/fonn/fonn, then run fonn hooks install. The desktop GUI is planned and is not included. Character reductions are not measured token or billing savings.

Fonn 0.1.0

Fonn 0.1.0

Initial CLI release of Fonn, an independent local harness for Claude Code and Codex, with structured tasks through the Claude Agent SDK.

• Run fonn to open the native CLI selected by your profile with an Opus or Sonnet effort profile and collapsed tool details. In Claude, Ctrl+O expands details; display collapsing does not reduce model context.
• Use native subagents proactively by default with normal permissions; opt out of delegation guidance with --subagents off. Session-wide filtering also handles supported subagent shell output for every model.
• Reopen native sessions with the fonn resume command printed on shutdown, retaining saved launch settings and using a session-picker fallback when tracking is unavailable.
• Choose the default coding agent with fonn --default claude or fonn --default codex; explicit agent commands and profiles override it for one launch.
• Select Fable 5.2 or Mythos 5.2 with namespaced built-in profiles or pinned custom short names, subject to upstream account access.
• Create and edit local model/effort profiles and choose a default with fonn profiles; resumed SDK tasks retain their saved profile.
• Run fonn codex for the native Codex CLI, retaining its login, sandbox, approval and hook-trust flow. Codex SDK tasks are not included.
• Use fonn run for bounded SDK tasks with structured results, explicit approvals, recoverable output artifacts and estimated usage accounting.
• Download the standalone Node filtering modules and configure local Claude/Codex hooks without installing Fonn or npm dependencies.
• Reduce recognized noisy shell output conservatively, or choose observe/off modes. Format adapters cover PHPUnit, Pest, PHPStan, tsc, pytest, Jest and Vitest. Failures, warnings and the runners' summaries always stay.
• Choose how far filtering goes with --filter-level strict|standard|similar, and save a default with fonn --default-filter-level. standard, the default, also collapses runs of identical lines from any command to one copy and an exact count. similar also collapses lines that differ only in numbers or IDs, and never merges lines that mention errors, failures or warnings. strict uses the format adapters only. Other unknown output and arbitrary MCP payloads remain unchanged.
• Ask Claude to work with another agent CLI, such as codex exec, and it runs it through the normal approval prompt. Without such a request, agents keep to their built-in subagents.
• Install the CLI through the cask in this repository. The archive contains Fonn JavaScript and lockfiles; Homebrew Node installs runtime dependencies on the user's machine without lifecycle scripts.

Documentation: https://fonn.nord-forge.dev. The desktop GUI is planned and is not included. Install and authenticate ordinary Claude Code separately for interactive use. SDK task runs require an explicit API key and separate API billing. Estimated stop thresholds can be exceeded, and character reductions are not measured token or billing savings.