# alineo remove
URL: /docs/cli/commands/remove

Delete a saved agent spec file from the current project.



```bash
bunx alineo-cli remove <name>
```

## Arguments [#arguments]

| Argument | Description                                        |
| -------- | -------------------------------------------------- |
| `name`   | The spec name as shown by `alineo list`. Required. |

## What it does [#what-it-does]

1. Looks for `<agentsDir>/<name>.json`. Throws `No agent spec named '<name>' in '<agentsDir>'. Run 'alineo list' to see available specs.` if it doesn't exist.
2. Deletes the file.

No network calls are made and no sandbox is touched — `remove` is a plain local file delete.

## Example [#example]

```bash
bunx alineo-cli remove node-toolchain
# Removed agent spec 'node-toolchain'
```

## Notes [#notes]

* `remove` only deletes the spec JSON file. It does not delete any sandbox snapshot created by a prior `Alineo.start()` — that's tracked separately, in `agent-snapshots.json` next to your ledger — nor does it touch the ledger itself.
* To remove a spec that was saved with `--name` on `add`, use that custom name, not the `name` field from inside the spec file.