atuinsh/atuin · error

unknown var record version {other:?}

Error message

unknown var record version {other:?}

What it means

Decoder guard in VarRecord::deserialize: the record's version discriminant is a value other than V0, i.e. the record was produced by an Atuin release whose wire format this client predates. The client stops rather than guessing at the unknown layout.

Source

Thrown at crates/atuin-dotfiles/src/store/var.rs:90

                        let bytes = bytes.remaining_slice();

                        let (key, bytes) =
                            decode::read_str_from_slice(bytes).map_err(error_report)?;

                        if !bytes.is_empty() {
                            bail!("trailing bytes in encoded dotfiles var record. malformed");
                        }

                        Ok(Self::Delete(key.to_owned()))
                    }

                    n => {
                        bail!("unknown Dotfiles var record type {n}");
                    }
                }
            }
            other => {
                bail!("unknown var record version {other:?}");
            }
        }
    }
}

#[derive(Debug, Clone)]
pub struct VarStore {
    pub store: SqliteStore,
    pub host_id: HostId,
    pub encryption_key: paseto_v4::Key,
}

impl VarStore {
    // will want to init the actual kv store when that is done
    #[must_use]
    pub fn new(store: SqliteStore, host_id: HostId, encryption_key: paseto_v4::Key) -> Self {
        Self {
            store,

View on GitHub (pinned to c0c717ab04)

Solutions

1. Upgrade Atuin to a version supporting record version {other:?}
2. Re-sync the dotfiles store with a compatible client

When it happens

Trigger: Thrown at crates/atuin-dotfiles/src/store/var.rs:90 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of atuinsh/atuin@c0c717ab04 (2026-09-12). Data as JSON: /api/errors/e40a106a2ba52ca2. Report an issue: GitHub.