Getting Started
Atuin captures your activity in the terminal including all the commands you ran, optionally with the command output, the AI threads you had with your agents.
You can either keep this data E2E-encrypted, or you can choose to share it inside or outside your team.
Install
Section titled “Install”Running our official install script will get you started:
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | shThis installer will prompt you to set Atuin up:
At this point Atuin is recording new commands. Depending on how you configured Atuin, press Ctrl+R or the ↑ arrow to search your commands.
Setup imports your current shell’s history file.
You can run atuin setup again at any time to change what it set up.
Make it yours
Section titled “Make it yours”Once you’re up and running:
- Basic usage — what Atuin records, and how to drive the TUI
- Filter and search modes — narrow searches to this directory, this machine, or this session
- Key bindings — including how to
disable the up arrow binding
with
atuin setup --only --no-up-arrowif it isn’t for you - Configuration reference — every setting, including an inline window instead of full screen
Atuin Web
Section titled “Atuin Web”Atuin hosts both a sync server, and Atuin Hub. Atuin Hub is Atuin’s web platform. Atuin Hub enables you to see your Atuin data in the browser, share your data with anyone, and allow your team to see each other’s context.
TODO 20s DEMO
To get started with Atuin Hub, create an account on
Atuin Hub, and connect it with your Atuin by running
atuin login:
atuin loginDepending on your atuin setup options, Atuin will either:
- Upload all your data to Atuin Hub.
- Upload only data in workspaces with
.atuin.luafiles to Atuin Hub. - Completely disable Atuin Hub support. Atuin Web acts as a sync server.
You can go to https://atuin.sh/threads to see all your updated threads.
Atuin has an awesome community. Open a topic on the forum, join our Discord, tweet at us on Twitter or chat with us on Bluesky or file an issue.