Skip to main content

​
Uninstall

Two paths:
  • Easy path if fased is still installed.
  • Manual service removal if the CLI is gone but the service is still running.

​
Easy path (CLI still installed)

Recommended: use the built-in uninstaller:
Non-interactive:
Manual steps (same result):
  1. Stop the gateway service:
  1. Uninstall the gateway service (launchd/systemd/schtasks):
  1. Delete state + config:
If you set FASED_CONFIG_PATH to a custom location outside the state dir, delete that file too.
  1. Delete your workspace (optional, removes agent files):
  1. Remove the repo-backed CLI launcher:
If you used an older package-manager install, remove that package separately.
  1. If you installed the macOS app:
Notes:
  • If you used profiles (--profile / FASED_PROFILE), repeat step 3 for each state dir (defaults are ~/.fased-<profile>).
  • In remote mode, the state dir lives on the gateway host, so run steps 1-4 there too.

​
Manual service removal (CLI not installed)

Use this if the gateway service keeps running but fased is missing.

​
macOS (launchd)

Default label is ai.fased.gateway (or ai.fased.<profile>; legacy com.fased.* may still exist):
If you used a profile, replace the label and plist name with ai.fased.<profile>. Remove any legacy com.fased.* plists if present.

​
Linux (systemd user unit)

Default unit name is fased-gateway.service (or fased-gateway-<profile>.service):

​
Legacy native Windows installs (Scheduled Task)

The current public Windows path runs inside WSL2 and uses the Linux/systemd instructions above. Use this section only to clean up an older native Windows installation created before WSL2 became the required public path. Default task name is FasedAgent Gateway (or FasedAgent Gateway (<profile>)). The task script lives under your state dir.
If you used a profile, delete the matching task name and ~\.fased-<profile>\gateway.cmd.

​
Normal install vs source checkout

​
Normal install (repo install.sh)

If you used the repo-backed install.sh, uninstall the gateway service first. Then remove the repo checkout and ~/.fased data if you want a full wipe.

​
Source checkout (git clone)

If you run from a repo checkout with the installed fased command:
  1. Uninstall the gateway service before deleting the repo (use the easy path above or manual service removal).
  2. Delete the repo directory.
  3. Remove state + workspace as shown above.