atuin/docs/blog/2023/02-26-release-v13/index.md

title	description	slug	authors	tags
Announcing Atuin v13	Release notes for Atuin v13	release-v13	ellie	release

We have since released patch v13.0.1. v13 had a regression exposed when trying to register a new user. This would only affect people self-hosting Atuin Server. Please update!

Announcing a new release of Atuin! v13 is out now. Atuin allows you to easily search and sync your shell history across many machines.

You can update your installation via your system package manager, or by downloading the latest release from the release page.

We had a lot of changes in this release - I'll call out a few, but this is not exhaustive.

Crossterm

Deserving of a special callout, we now use Crossterm as our TUI backend - this has been a huge effort, and has taken almost a year. Thank you to Conrad for pushing through it, and @pdecat for your contributions!

In the future this will allow for things like (possible) Windows support, and only using a small part of the screen for the search UI. It also handles async input better.

Please let us know if you experience any issues!

New features

Pretty Stats

While procrastinating writing his talk, Conrad added a new and improved stats display! Just run atuin stats to see your statistics. It'd be awesome to see what yours looks like, so please share it with us on Twitter or Discord!

Custom history list format

List history however you want! You can now specify the output format of atuin history list

Example

atuin history list --format "{time} - [{duration}] - {directory}$\t{command}"

See more on the docs page!

History filter

The history filter allows you to exclude commands from history tracking - maybe you want to keep ALL of your curl commands totally out of your shell history, or maybe just some matching a pattern.

This supports regular expressions, so you can hide pretty much whatever you want! Thanks for the PR @jbaiter

Configure it in your client-side Atuin config, for example

## Note that these regular expressions are unanchored, i.e. if they don't start
## with ^ or end with $, they'll match anywhere in the command.
history_filter = [
   "^secret-cmd",
   "^innocuous-cmd .*--secret=.+"
]

Mnemonic key (BIP39)

Previously, it was awkward to copy your Atuin key from machine to machine. Even more awkward to back it up!

We now use BIP39 to display your key in a nice + easily readable haiku-style format. Still - please don't share it!

Improvements

• Better error messages
• Nix install files + instructions
• Exit when pushing the down arrow from the most recent entry
• Refactor to support generic server-side databases
• Make it easier to disable the ctrl-r and/or up arrow bindings
• Update to axum6

Fixes

• Fish now handles multi-line commands properly
• Listing history for the current session now works
• Fix atuin init for Fish

Contributor Shoutout!

@patricksjackson

• Fix minor typo in config.md in https://github.com/ellie/atuin/pull/615
• Re-enable arm docker builds in https://github.com/ellie/atuin/pull/616
• Handle multiline commands in fish shell in https://github.com/ellie/atuin/pull/623
• install.sh: Fallback to using cargo in https://github.com/ellie/atuin/pull/639
• Fix session history listing in https://github.com/ellie/atuin/pull/620

@pdecat

• Add support for some additional keys in interactive mode in https://github.com/ellie/atuin/pull/634
• Allow overriding filter and search modes from CLI in https://github.com/ellie/atuin/pull/635

@Sciencentistguy

• Rework atuin init in https://github.com/ellie/atuin/pull/652
• Improve error message when $AUTIN_SESSION is not set. in https://github.com/ellie/atuin/pull/654
• Add nix files and install instructions in https://github.com/ellie/atuin/pull/477

@BapRx

• chore(#621): Exit atuin when pressing down arrow on most recent entry in https://github.com/ellie/atuin/pull/659
• docs: Remove human short flag from docs, duplicate of help -h in https://github.com/ellie/atuin/pull/663
• feat(history): Add new flag to allow custom output format in https://github.com/ellie/atuin/pull/662

@yolo2h

• docs: Fix typo in zh-CN/README.md in https://github.com/ellie/atuin/pull/666

@s1ck

• Fix CI build badge in https://github.com/ellie/atuin/pull/683

@conradludgate

• display mnemonic key in https://github.com/ellie/atuin/pull/694
• axum6 with typesafe state in https://github.com/ellie/atuin/pull/674
• crossterm support in https://github.com/ellie/atuin/pull/331
• stats in https://github.com/ellie/atuin/pull/707

@evanpurkhiser

• Remove whitespace in template client config.tom in https://github.com/ellie/atuin/pull/697
• Fix missing - in key-binding.md in https://github.com/ellie/atuin/pull/698

@eripa

• docs(README): add static activity graph example by @eripa in https://github.com/ellie/atuin/pull/680

@trygveaa

• Allow using existing key file on login by @trygveaa in https://github.com/ellie/atuin/pull/688

@frukto

• Make the install script more robust by @frukto in https://github.com/ellie/atuin/pull/692

@jbaiter

• Add history_filter setting to exclude commands from history by @jbaiter in https://github.com/ellie/atuin/pull/716

@hunger

• fish: Fix atuin init for the fish shell by @hunger in https://github.com/ellie/atuin/pull/699

@ekroon

• Add support for generic database in AppState by @ekroon in https://github.com/ellie/atuin/pull/711

New Contributors

I very much appreciate the work from all contributors, but a special mention to everyone who made their first contribution in this release, no matter how large or small

• @pdecat made their first contribution in https://github.com/ellie/atuin/pull/634
• @BapRx made their first contribution in https://github.com/ellie/atuin/pull/659
• @yolo2h made their first contribution in https://github.com/ellie/atuin/pull/666
• @s1ck made their first contribution in https://github.com/ellie/atuin/pull/683
• @evanpurkhiser made their first contribution in https://github.com/ellie/atuin/pull/697
• @eripa made their first contribution in https://github.com/ellie/atuin/pull/680
• @trygveaa made their first contribution in https://github.com/ellie/atuin/pull/688
• @frukto made their first contribution in https://github.com/ellie/atuin/pull/692
• @jbaiter made their first contribution in https://github.com/ellie/atuin/pull/716
• @hunger made their first contribution in https://github.com/ellie/atuin/pull/699
• @ekroon made their first contribution in https://github.com/ellie/atuin/pull/711

Future plans

I've been talking about it for ages and ages, but now that my life has finally settled down I'm going to be focusing on getting deletions out for the next release. We will be switching to an event-based sync, which should allow for many more features and cool things in the future!

Other changes

Talk

I spoke about Atuin at FOSDEM! If you want to know more about the project + video is your thing, you can watch it here

Website

Well... this is new. Previously I never bothered writing much about new releases, and basically just used the autogenerated GitHub release. The docs should be much easier to find here too!

Twitter

I also opened a Twitter account for Atuin - @atuinsh

If you fancy chatting to us about anything here, or otherwise, please feel free to drop by the Discord!

Full Changelog: https://github.com/ellie/atuin/compare/v12.0.0...v13.0.0