Skip to content
Atuin

atuin resume

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

Terminal window
atuin resume [OPTIONS] [QUERY]...
  • <QUERY>...: Search text, or a thread id (or unique id prefix) to resume without the picker
  • --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