## Problem
Installers always installed or verified every coding agent, so users
could not choose only Claude Code, Codex, or Pi. Windows could also
execute an intercepted HTML response as PowerShell. Fixes #1322.
## Changes
| Before | After |
| --- | --- |
| Interactive installs processed all three coding agents. | Interactive
installs ask about Claude Code, Codex, and Pi with Yes defaults. |
| Users could not skip individual agents. | No skips installation and
verification while leaving an existing agent unchanged. |
| Selecting no agents had no defined contract. | All-No re-prompts, and
installation requires at least one selected agent to be available. |
| Automation depended on the unconditional client flow. |
Non-interactive installs preserve the existing all-selected behavior. |
| Completion output advertised every required wrapper. | Completion
output advertises only selected and available coding agents. |
| Every nonempty downloaded file was executed as PowerShell. | Every
do…
## Problem
Free Claude Code's desktop surfaces had no shared visual identity. The
tray used a generated blue `F`, Windows shortcuts inherited the generic
executable icon, and the macOS app bundle declared no icon at all.
## Changes
| Before | After |
| --- | --- |
| Desktop artwork was generated independently at runtime. | A
deterministic SVG source and packaged PNG, ICO, and ICNS variants define
one high-contrast orange FCC mark. |
| The tray, Windows shortcuts, and macOS bundle displayed unrelated or
generic artwork. | Every desktop surface now consumes the same packaged
brand asset. |
| Installers had no native icon handoff contract. | `fcc-desktop
--export-icon` copies the wheel-owned format into installer-managed
locations, with fail-fast verification and uninstall coverage through
the existing managed paths. |
| Icon packaging and platform wiring were implicit. | Regression tests
validate native containers, byte-preserving export, Windows shortcut
metadata, macOS bundle metada…
## Problem
Selecting "Do nothing" in Pi's installer returned success without
installing Pi. FCC then required the missing command and stopped before
installing itself. Fixes #1240.
## Changes
| Before | After |
| --- | --- |
| A successful Pi installer exit always required a compatible `pi`
command. | A successful Pi installer exit may leave Pi unavailable while
FCC installation continues. |
| Pi verification and completion guidance always ran. | Pi verification
and completion guidance run only when Pi is available. |
| Installer documentation described Pi as mandatory. | Installer
documentation describes Pi as optional. |
| Skip behavior lacked cross-platform regression coverage. | Skip
behavior is covered on PowerShell and POSIX, including an unrelated
existing `pi` command. |
<!-- greptile_comment -->
<details open><summary><h3>Greptile Summary</h3></summary>
The PR makes Pi optional during installation.
- Continues FCC installation when Pi’s installer succeeds without
install…
Add a native FCC desktop launcher for Windows and macOS (#1225)
## Problem
Free Claude Code currently has to remain attached to a terminal, so
closing that window stops the proxy and users have no native way to
reopen Admin or control the background server. The contributed Windows
wrapper also would have introduced a second bundled server lifecycle
instead of reusing FCC's cleanup and restart ownership. Fixes #1147.
## Changes
| Before | After |
| --- | --- |
| Users keep `fcc-server` running in a terminal. | Windows and macOS
users can launch a console-free FCC Desktop host from a
desktop/application shortcut and control it from the tray or menu bar. |
| A wrapper would need to spawn and terminate a child server. | The
terminal and desktop paths share one in-process supervisor, one graceful
runtime shutdown path, and an OS-held singleton lock. |
| Installers manage only command entry points. | Windows installs
desktop and Start-menu shortcuts; macOS installs a per-user app bundle
and owned desktop link; uninstallers remove only those FCC artifa…
Remove obsolete init and server alias commands (#1220)
## Problem
FCC still publishes `fcc-init` and the `free-claude-code` server alias
from an obsolete installation flow. Configuration creation now belongs
to the Admin UI, while `fcc-server` owns startup and legacy migration.
## Changes
| Before | After |
| --- | --- |
| The package installs six console commands. | The package installs only
`fcc-server`, `fcc-claude`, `fcc-codex`, and `fcc-pi`. |
| `fcc-init` duplicates configuration creation outside the Admin UI. |
The Admin UI exclusively creates managed configuration, and server
startup retains legacy migration. |
| Smoke contracts and architecture describe the retired commands. |
Smoke contracts and architecture describe the supported command surface.
|
| Installer safety lists contain unexplained retired names. | Installer
safety lists document why retired names remain detectable during updates
and uninstall. |
| The package version is `4.11.4`. | The package version is `4.11.5`. |
<!-- greptile_comment -->
<details open><summa…
Fail safely when FCC is running during installation (#1182)
## Problem
A running Free Claude Code command can make `uv tool install --force`
fail after partially deleting the installed tool environment. The
installers did not detect this precondition, and the POSIX fallback
relied on truncated process names.
## Changes
| Before | After |
| --- | --- |
| Installers entered tool replacement while FCC commands were running. |
Installers report matching FCC commands and PIDs, then exit before
mutation. |
| A process starting during client or uv setup could reach tool
replacement. | Installers recheck immediately before `uv tool install`.
|
| The no-`pgrep` fallback compared truncated `comm` names. | Install and
uninstall fallbacks match full command lines. |
| Running-process coverage existed only for uninstallers. |
Cross-platform tests cover every FCC entry point, late starts, similar
names, and fallback detection. |
| The package version was 4.8.7. | The package version is 4.8.8. |
<!-- greptile_comment -->
<details open><summary><h3>Grepti…
Enable uv malware checks on every CI runner (#1177)
## Problem
Dependabot updates passed CI without uv checking their locked packages
against known malware advisories. The supported uv minimum also predated
this capability.
## Changes
| Before | After |
| --- | --- |
| Project, installers, and CI allowed uv versions without malware
checking. | All supported surfaces require uv `0.11.16` or newer. |
| Parallel CI runners synchronized dependencies without an OSV malware
check. | Workflow-wide uv environment settings enable the check
independently on every runner. |
| Installers treated prerelease builds as their equivalent stable
version. | Installers accept stable uv releases only while preserving
valid build metadata. |
| uv security-policy values and edge behavior could drift between
maintained surfaces. | Contract and installer tests enforce the shared
policy. |
| FCC reported version `4.8.5`. | FCC reports patch version `4.8.6`. |
<!-- greptile_comment -->
<details open><summary><h3>Greptile Summary</h3></summary>
This PR enabl…
## Problem
FCC had no first-class Pi path, so Pi users had to maintain provider
configuration themselves. FCC's installers and ownership docs also
covered only Claude Code and Codex.
## Changes
| Before | After |
| --- | --- |
| Pi required persistent user-managed provider configuration. | `fcc-pi`
registers an ephemeral FCC provider from the live model catalog and
leaves Pi-owned state untouched. |
| Client launchers normalized blank proxy authentication separately. |
Claude, Codex, and Pi share one neutral proxy-auth policy. |
| FCC installers and uninstallers did not account for Pi. | Installers
delegate missing Pi setup to its official platform installer, while
uninstallers remove only `fcc-pi` and preserve native Pi. |
| Pi compatibility had no executable FCC contract. | Deterministic
launcher and lifecycle coverage plus a real Pi 0.80.6 smoke verify model
discovery and `/v1/messages` end to end. |
<!-- greptile_comment -->
<details open><summary><h3>Greptile Summary</h3></su…
## Problem
FCC required Git solely to fetch its source from GitHub. Customers had
to install an unrelated prerequisite before running an otherwise
self-contained installer.
## Changes
| Before | After |
| --- | --- |
| Installers fetched FCC through a mutable `git+` repository URL. |
Installers fetch the same visible `main` source through GitHub's
generated ZIP archive. |
| Git had to exist before either installer could continue. | FCC
installation has no Git dependency or Git-specific branch. |
| The unnamed source requirement relied on Git metadata. | Every base
and voice variant uses a named direct-archive requirement. |
| Reinstallation relied on Git to discover the current branch head. |
`--refresh-package free-claude-code` fetches the current archive on
every rerun. |
| Installer tests provisioned a fake Git executable. | Windows and Linux
scenarios pass with no Git executable and verify archive and voice
specifications. |
| The README described installer internals and a manua…
Make installers native, fail-fast, and verifiable (#1086)
## Problem
The install and uninstall scripts mixed tool ownership, relied on npm
and package-manager detection, and could report success after native
commands or FCC removal failed. Users could be left without runnable FCC
commands or lose `~/.fcc` while the FCC tool remained. Fixes #547, #753,
#908, #942, #952, #1078, and #1080.
## Changes
| Before | After |
| --- | --- |
| Missing Claude Code and Codex were installed through global npm. |
Missing clients use their official native installers without requiring
Node.js or npm. |
| Existing uv installations were updated through package-manager
detection. | Compatible uv installations are preserved; missing or
obsolete uv uses Astral's standalone installer. |
| Python 3.14 was installed as a separate step. | `uv tool install
--python 3.14.0` owns Python selection and FCC installation together. |
| PowerShell relied on `$ErrorActionPreference` and process metadata. |
Native exits are checked explicitly and the PowerShell host resolves
t…