# atuin resume

<!-- Generated by web/apps/docs/scripts/gen-reference.ts from the Atuin source. Do not edit. -->

Pick a captured coding-agent thread and resume it (short for `atuin threads resume`)

```sh
atuin resume [OPTIONS] [QUERY]...
```

## Arguments

- `<QUERY>...`: Search text, or a thread id (or unique id prefix) to resume without the picker

## Options

- `--print`: Print the resume command instead of running it
- `--in <HARNESS>`: Continue the thread QUERY names (by id, or a unique id prefix) in another agent: it is written out as a new session there, tool calls carried over as its own where it has a like tool (notes where they weren't captured whole), and resumed. One that went on separately on several machines needs `--branch`
  - `claude-code`
  - `codex`
  - `copilot`
  - `grok`
  - `hermes`
  - `kiro`
  - `opencode`
  - `pi`
  - `omp`
- `--fork`: Fork the thread QUERY names (by id, or a unique id prefix): it is written out as a new session of the same agent, with the same history, and resumed. The original is left as it is
- `--as-is`: Resume this machine's copy of the thread QUERY names as it is, without catching it up with sync
- `--switch`: Switch this machine's copy of the thread QUERY names to another branch (the one `--branch` names, else the only one it can be switched to), in place, and resume it: the history it shares with that branch is kept as it is, and the branch's messages since are appended from sync. The branch it was on stays in atuin, for `--fork` to bring back, and the copy as it was is kept as a backup. Only when sync holds all of it and no agent here has it open
- `--branch <BRANCH>`: The branch of the thread QUERY names to catch up to, to switch to with `--switch`, to fork from with `--fork`, or to continue with `--in`: `this`, `@<host id>`, or the start of its head's id. The newest by default; `--in`, and `--switch` with several branches to switch to, need it named
- `--filter-mode <FILTER_MODE>`: The filter the picker opens in (default: global)
  - `global`: Every thread, from every host
  - `host`: Threads recorded on this host
  - `workspace`: Threads whose working directory is inside the current git repository
  - `directory`: Threads started in the current directory
  - `branch`: Threads on the current git branch of the current repository
- `--inline-height <INLINE_HEIGHT>`: Height of the inline picker; 0 for fullscreen