release

Announcing Atuin v13

Release notes for Atuin v13

Ellie Huxtable

26 Feb 2023 — 5 min read

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

@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

Embedded iFrame

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!

Mastodon

We now have a Mastodon account over on Hachyderm! @atuin

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