# jackin eject (https://jackin.tailrocks.com/commands/eject/)



## Synopsis [#synopsis]

```bash
jackin eject <SELECTOR> [OPTIONS]
```

Stop a running agent container.

## Arguments [#arguments]

| Argument   | Required | Description                                   |
| ---------- | -------- | --------------------------------------------- |
| `SELECTOR` | Yes      | Role selector, instance ID, or container name |

## Options [#options]

| Option    | Description                                                                                                    |
| --------- | -------------------------------------------------------------------------------------------------------------- |
| `--all`   | Stop every matching instance. Without `--all`, the command errors if more than one instance matches the target |
| `--purge` | Also delete persisted state after stopping                                                                     |
| `--debug` | Print every external command jackin issues and their captured output. Also enabled by `JACKIN_DEBUG=1`.        |

## Examples [#examples]

```bash
# Stop a specific agent
jackin eject agent-smith

# Stop all instances of agent-smith
jackin eject agent-smith --all

# Stop and delete all persisted state
jackin eject agent-smith --purge

# Stop a specific indexed instance
jackin eject k7p9m2xq

# Stop a specific container by name
jackin eject jk-k7p9m2xq-agentsmith
```

## What gets cleaned up [#what-gets-cleaned-up]

When you eject an agent:

* The agent container is stopped and removed
* The DinD sidecar container is stopped and removed
* The TLS certs volume (`{container}-dind-certs`) is removed
* The per-agent Docker network is removed

When you add `--purge`:

* All of the above, plus the agent's persisted state (conversation history, forwarded credentials, `gh` state, plugins) is deleted

Use `--purge` when Docker resources still exist and you want to delete local recovery state in the same operation. Plain `jackin purge` is local-state-only and refuses while the matching role container or DinD sidecar still exists.