Skip to content
Atuin

store

Atuin keeps your history in an encrypted, append-only record store. Sync works by exchanging these records, rather than by copying rows between databases. atuin store inspects and repairs that store.

Most people never need these commands. Reach for them when sync is misbehaving, or when a machine ends up holding records encrypted with a key it no longer has.

Print the current state of the record store — how many records exist locally, per tag and per host.

Terminal window
atuin store status

Start here when diagnosing a sync problem.

Check that every local record can be decrypted with your current key.

Terminal window
atuin store verify

Failures mean some records were written with a different key — usually because a machine was logged in with an old key, or a key was regenerated.

Delete the local records that fail decryption.

Terminal window
atuin store purge

Run atuin store verify first, so you know you’re clearing up a genuine key mismatch rather than deleting data blindly. See Deleting History for the full procedure.

Re-encrypt the entire local store with a new key. Omit the key to have one generated for you.

Terminal window
atuin store rekey

Rebuild derived state from the record store — for example, regenerate the history database from history records.

Terminal window
atuin store rebuild history

Useful when the record store is intact but the local view of it isn’t.

atuin store rebuild threads rebuilds the daemon’s index of captured threads from the thread records alone: the daemon (started for it if daemon.autostart is on) deletes it and replays every record in the background (atuin threads waits for it meanwhile). atuin store purge and atuin store pull --force do the same after deleting records, so their threads leave the index. The index belongs to the daemon, so this needs it enabled and running: without it, the command fails and leaves the index as it was, and a purge or forced pull says the index still lists the deleted threads until atuin store rebuild threads runs with the daemon up.

Upload local records to the sync server, one way.

Flag Description
--tag/-t Only push this tag (for example, history). Defaults to all tags
--host Only push this host, given as a host UUID. Defaults to the current host
--force Clear the remote store, then upload everything local, for all hosts and tags
--page How many records to upload at a time (default: 100)

Download records from the sync server, one way.

Flag Description
--tag/-t Only pull this tag. Defaults to all tags
--force Wipe the local store first, then download everything from the remote
--page How many records to download at a time (default: 100)

For ordinary two-way syncing, use atuin sync instead.