store
atuin store
Section titled “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.
Subcommands
Section titled “Subcommands”atuin store status
Section titled “atuin store status”Print the current state of the record store — how many records exist locally, per tag and per host.
atuin store statusStart here when diagnosing a sync problem.
atuin store verify
Section titled “atuin store verify”Check that every local record can be decrypted with your current key.
atuin store verifyFailures 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.
atuin store purge
Section titled “atuin store purge”Delete the local records that fail decryption.
atuin store purgeRun 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.
atuin store rekey [KEY]
Section titled “atuin store rekey [KEY]”Re-encrypt the entire local store with a new key. Omit the key to have one generated for you.
atuin store rekeyatuin store rebuild <TAG>
Section titled “atuin store rebuild <TAG>”Rebuild derived state from the record store — for example, regenerate the
history database from history records.
atuin store rebuild historyUseful 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.
atuin store push
Section titled “atuin store push”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) |
atuin store pull
Section titled “atuin store pull”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.