atuinsh/atuin · error

unknown Dotfiles var record type {n}

Error message

unknown Dotfiles var record type {n}

What it means

Decoder guard in VarRecord::deserialize: a dotfiles var record's tag byte is neither 0 (Create) nor 1 (Delete), so the record type is unknown to this client. Usually means the record was written by a newer Atuin version, or the stored payload is corrupted.

Source

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

                    // delete
                    1 => {
                        let nfields = decode::read_array_len(&mut bytes).map_err(error_report)?;
                        ensure!(nfields == 1, "too many entries in v0 dotfiles var delete record");

                        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 {

View on GitHub (pinned to c0c717ab04)

Solutions

1. Upgrade the Atuin client to the latest version
2. Locate and remove the malformed record, then re-sync the dotfiles data

When it happens

Trigger: Thrown at crates/atuin-dotfiles/src/store/var.rs:85 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/c44a3e2cf001873d. Report an issue: GitHub.