Reset or uninstall
Wipe the native package’s data and start over, or remove Agent Fleet from the host. The program and the data live in different places, so you can remove either one alone.
How it works
Section titled “How it works”| What you do | What happens |
|---|---|
Run af reset |
The fixed user’s home and claude-config (including the Claude login) are deleted. The DB and the rootfs are kept |
Run af reset --all |
All of WS_DATA is deleted: the DB, every home, claude-config, the extracted rootfs |
| Remove the unit, the data and the program in turn | Agent Fleet is gone from the host |
Wipe the data
Section titled “Wipe the data”Stop the Control Plane first; af reset refuses while it runs.
./af reset # dev user's data only (DB and rootfs are kept)./af reset --all # all of WS_DATA (full wipe incl. the extracted rootfs)- It asks before deleting.
--yesskips the question ./afis the form for running it in the extracted tar’s directory. After an installer install,afis~/.local/bin/af, so runaf resetfrom anywhere
Uninstall
Section titled “Uninstall”# 1. If you set up the systemd user unit, stop and remove it firstsystemctl --user disable --now agent-fleet 2>/dev/nullsystemctl --user disable --now agent-fleet-update.timer 2>/dev/null # auto-update timerrm -f ~/.config/systemd/user/agent-fleet.service \ ~/.config/systemd/user/agent-fleet-update.service \ ~/.config/systemd/user/agent-fleet-update.timer# otherwise just stop `af start` with Ctrl-C
# 2. Wipe all data (skip to keep it — data is separate from the program)# installed via install.sh:af reset --all# extracted from a tar directly, in the extracted directory:./af reset --all
# 3. Remove the program# installed via install.sh:rm -f ~/.local/bin/af && rm -rf ~/.local/opt/agent-fleet# extracted from a tar directly: just delete the extracted directory| Step | Notes |
|---|---|
| 1. Stop and remove the units | Without systemd, just stop af start with Ctrl-C |
| 2. Wipe the data | af reset --all after an installer install; ./af reset --all in the extracted directory for a tar. Do it before removing the program, or the data stays behind (“When af is already gone” below). Skip it to keep the data |
| 3. Remove the program | If you extracted the tar directly, delete that directory |
When af is already gone
Section titled “When af is already gone”Remove the data by hand. Go module caches inside workspace homes are write-protected, so restore write permission first.
chmod -R u+w ~/.local/share/agent-fleet && rm -rf ~/.local/share/agent-fleetUse your $WS_DATA path if you overrode it.
Related
Section titled “Related”For agents
Send this prompt to your agent to read this page.
Read https://agent-fleet.org/docs/operate/native/uninstall/index.md