# atuin setup

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

Setup Atuin features

```sh
atuin setup [OPTIONS]
```

## Options

- `--yes`: Set up without asking, as the flags say: sync is off unless `--sync` says otherwise
- `--only`: Change only what the flags say, without asking, and leave the rest as it is
- `--no-import`: Don't import the shell history and threads already on this machine
- `--shell-history`: Capture your shell history
- `--no-shell-history`: Don't capture your shell history
- `--shells <SHELL>`: The shells to hook into: zsh, bash, fish and powershell. Can be repeated.
- `--output-capture`: Capture what your commands print
- `--no-output-capture`: Don't capture what your commands print
- `--threads`: Capture your conversations with your agents
- `--no-threads`: Don't capture your conversations with your agents
- `--agent-history`: Capture the commands your agents run
- `--no-agent-history`: Don't capture the commands your agents run
- `--agents <AGENT>`: The agents to hook into and connect, of amp, claude-code, codex, copilot, grok, hermes, kiro, opencode, pi, omp. Can be repeated.
- `--ctrl-r`: Search with ctrl-r
- `--no-ctrl-r`: Leave ctrl-r to your shell
- `--up-arrow`: Search with the up arrow
- `--no-up-arrow`: Leave the up arrow to your shell
- `--mcp`: Let your agents search Atuin over MCP
- `--no-mcp`: Don't let your agents search Atuin over MCP
- `--daemon`: Run the daemon, which thread and output capture need
- `--no-daemon`: Stop the daemon, and keep it off
- `--sync <cloud|off|URL>`: Where to sync: `cloud`, `off`, or your own server's address