> For the complete documentation index, see [llms.txt](https://docs.worldlibertyfinancial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/reset-and-uninstall.md).

# Reset or uninstall

This page covers the two cleanup paths in AgentPay SDK.

They are not the same:

* `reset` clears wallet-specific state so the machine can be set up again
* `uninstall` removes AgentPay from the machine

## Reset

{% hint style="warning" %}
**Before resetting**, check whether you have an encrypted offline wallet backup. If you do, you can restore the same wallet on this or another machine with `agentpay admin setup --restore-wallet-from <backup.json>` instead of destroying the wallet state. Only reset when you intentionally want to discard the old wallet and create a new one.
{% endhint %}

Use reset when you want to discard the current wallet attachment and start over without removing the CLI itself.

```bash
agentpay admin reset
agentpay admin reset --yes
agentpay admin reset --yes --delete-config
```

Without `--yes`, the CLI prints a destructive warning to stderr and prompts:

```
Type RESET to delete the managed local daemon state and wallet credentials:
```

You must type exactly `RESET` to proceed.

For automation or CI-style flows, use `--non-interactive` together with `--yes` to suppress all interactive prompts.

`--delete-config` goes further and removes `~/.agentpay/config.json` instead of only clearing wallet-specific credentials.

Because the managed local daemon and its state are root-managed, reset can prompt for the local root password.

### What reset removes and keeps

**Removed by reset:**

* managed LaunchDaemon (`com.agentpay.daemon`)
* agent auth token from macOS Keychain
* `agentKeyId` and `agentAuthToken` from config
* bootstrap artifacts
* managed local daemon state (`/var/db/agentpay/daemon-state.enc`)
* daemon socket

**Kept by reset** (unless `--delete-config` is passed):

* the rest of `config.json` (chain settings, RPC URLs, etc.)

## Uninstall

Use uninstall when you want AgentPay removed from the machine entirely:

```bash
agentpay admin uninstall
agentpay admin uninstall --yes
```

Without `--yes`, the CLI prints a destructive warning to stderr and prompts:

```
Type UNINSTALL to delete all AgentPay managed files and local credentials:
```

You must type exactly `UNINSTALL` to proceed.

Uninstall removes everything that reset removes, plus:

* `/Library/AgentPay/` (entire directory)
* `/var/db/agentpay/` (entire directory)
* `/var/log/agentpay/` (entire directory)
* `~/.agentpay/` (entire directory)
* the daemon password stored in System Keychain
* one-click installer artifacts (shell RC blocks, skill symlinks, PATH shims)
* source-built CLI artifacts (if installed from source)

For automation, use `--non-interactive` together with `--yes`.

Because this removes root-managed files, uninstall can also prompt for the local root password.

If something went wrong and you ended up here to recover, see [Troubleshooting](/agentpay-sdk/workflows/troubleshooting.md) before resetting - repair may be enough.

## When to use which

Choose reset when:

* the machine should keep `agentpay` installed
* the current wallet state should be discarded
* you plan to run `agentpay admin setup` again afterward

Choose uninstall when:

* the machine should stop running AgentPay entirely
* you are cleaning up a development or test machine
* you do not want to leave AgentPay state behind under user or root-managed paths

## Next step

If you reset and want to set up again, continue to [Wallet setup](/agentpay-sdk/workflows/wallet-setup.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.worldlibertyfinancial.com/agentpay-sdk/workflows/reset-and-uninstall.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.