uninstall & status¶

status¶

foil status¶

Shortcut for 'foil server status'.

Usage:

foil status [OPTIONS]

Options:

  --help  Show this message and exit.

foil status is a shortcut for foil server status. Use it as a quick health check — it prints server state, active model, engine status, and GPU memory use.

uninstall (discouraged from the CLI)¶

Remove Foil and its data from the machine.

foil uninstall¶

Remove Foil completely from this machine.

Stops the server, removes ~/.foil (venv, database, settings, keys), removes the CLI from PATH, and optionally removes Foil.app.

Usage:

foil uninstall [OPTIONS]

Options:

  --keep-projects  Keep project knowledge graphs (findings, code maps)
  --keep-models    Keep downloaded models (~4+ GB each)
  -y, --yes        Skip confirmation
  --help           Show this message and exit.

Uninstall a Homebrew install¶

If you installed Foil via brew install --cask foil, the clean way to remove it is:

brew uninstall --cask foil

brew optionally zaps ~/.foil and the be.peachstudio.foil preferences for you (it will ask).

To wipe everything manually (app + data + preferences):

brew uninstall --cask foil
rm -rf ~/.foil
defaults delete be.peachstudio.foil

What gets removed¶

By default, foil uninstall removes:

~/.foil/venv/ — the isolated Python environment
~/.foil/foil.db — scan history
~/.foil/logs/ — server and engine logs
~/.foil/installation.id — license identity
Registered projects (but not your source code)
Downloaded models (unless --keep-models)

Use --keep-projects or --keep-models to preserve what you want to reuse.