atuinsh/atuin · error

unknown alias record version {other:?}

Error message

unknown alias record version {other:?}

What it means

Decoder guard in AliasRecord::deserialize: the record's version field holds a value other than V0, meaning the record was written by an Atuin release with a wire-format version this client does not know how to decode. It is a forward-compatibility stop — the client refuses rather than mis-parsing unknown versions.

Source

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

                        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 shell alias record. malformed");
                        }

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

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

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

impl AliasStore {
    // 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 the Atuin client to a release that supports the record version in {other:?}
2. Re-sync or re-encode the dotfiles data with a compatible client version

When it happens

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