diff options
| author | Ellie Huxtable <ellie@elliehuxtable.com> | 2023-02-26 21:22:29 +0000 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-02-26 21:22:29 +0000 |
| commit | fe5f728aa6f060a9f2c4cbbb22c5e10ea2ffbff9 (patch) | |
| tree | 2cfef16e7e4de2376d85054d3ba3ff9ce5021a79 /docs | |
| parent | Docs index page (diff) | |
| download | atuin-fe5f728aa6f060a9f2c4cbbb22c5e10ea2ffbff9.zip | |
Release v13 (#727)
* Write release blog post
* Bump versions
* Update contributors
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/blog/2023/02-26-release-v13/index.md | 173 | ||||
| -rw-r--r-- | docs/blog/2023/02-26-release-v13/stats.png | bin | 0 -> 16672 bytes | |||
| -rw-r--r-- | docs/docs/commands/list.md | 17 | ||||
| -rw-r--r-- | docs/docs/config/config.md | 15 |
4 files changed, 203 insertions, 2 deletions
diff --git a/docs/blog/2023/02-26-release-v13/index.md b/docs/blog/2023/02-26-release-v13/index.md new file mode 100644 index 00000000..24936345 --- /dev/null +++ b/docs/blog/2023/02-26-release-v13/index.md @@ -0,0 +1,173 @@ +--- +title: Announcing Atuin v13 +description: Release notes for Atuin v13 +slug: release-v13 +authors: [ellie] +tags: [release] +--- + +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](https://github.com/ellie/atuin/releases). + +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](https://github.com/ellie/atuin/pull/331) 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](https://github.com/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 + +<center> + +  + +</center> + +While procrastinating writing [his talk](https://www.youtube.com/watch?v=7pU3gOVAeVQ), Conrad [added](https://github.com/ellie/atuin/pull/707) 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](https://twitter.com/atuinsh) or [Discord](https://discord.gg/Fq8bJSKPHh)! + +### 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](/docs/commands/list)! + +### 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](https://github.com/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](https://github.com/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](https://github.com/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](https://github.com/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](https://github.com/yolo2h) +* docs: Fix typo in zh-CN/README.md in https://github.com/ellie/atuin/pull/666 + +### [@s1ck](https://github.com/s1ck) +* Fix CI build badge in https://github.com/ellie/atuin/pull/683 + +### [@conradludgate](https://github.com/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](https://github.com/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](https://github.com/eripa) +* docs(README): add static activity graph example by @eripa in https://github.com/ellie/atuin/pull/680 + +### [@trygveaa](https://github.com/trygveaa) +* Allow using existing key file on login by @trygveaa in https://github.com/ellie/atuin/pull/688 + +### [@frukto](https://github.com/frukto) +* Make the install script more robust by @frukto in https://github.com/ellie/atuin/pull/692 + +### [@jbaiter](https://github.com/jbaiter) +* Add `history_filter` setting to exclude commands from history by @jbaiter in https://github.com/ellie/atuin/pull/716 + +### [@hunger](https://github.com/hunger) +* fish: Fix `atuin init` for the fish shell by @hunger in https://github.com/ellie/atuin/pull/699 + +### [@ekroon](https://github.com/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](https://github.com/pdecat) made their first contribution in https://github.com/ellie/atuin/pull/634 +* [@BapRx](https://github.com/BapRx) made their first contribution in https://github.com/ellie/atuin/pull/659 +* [@yolo2h](https://github.com/yolo2h) made their first contribution in https://github.com/ellie/atuin/pull/666 +* [@s1ck](https://github.com/s1ck) made their first contribution in https://github.com/ellie/atuin/pull/683 +* [@evanpurkhiser](https://github.com/evanpurkhiser) made their first contribution in https://github.com/ellie/atuin/pull/697 +* [@eripa](https://github.com/eripa) made their first contribution in https://github.com/ellie/atuin/pull/680 +* [@trygveaa](https://github.com/trygveaa) made their first contribution in https://github.com/ellie/atuin/pull/688 +* [@frukto](https://github.com/frukto) made their first contribution in https://github.com/ellie/atuin/pull/692 +* [@jbaiter](https://github.com/jbaiter) made their first contribution in https://github.com/ellie/atuin/pull/716 +* [@hunger](https://github.com/hunger) made their first contribution in https://github.com/ellie/atuin/pull/699 +* [@ekroon](https://github.com/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](https://github.com/ellie/atuin/issues/592) 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 + +<iframe width="560" height="315" src="https://www.youtube.com/embed/uyRmV19qJ2o" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></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! + +### Twitter + +I also opened a Twitter account for Atuin - [@atuinsh](https://twitter.com/atuinsh) + +If you fancy chatting to us about anything here, or otherwise, please feel free to drop by the [Discord](https://discord.gg/Fq8bJSKPHh)! + +**Full Changelog**: https://github.com/ellie/atuin/compare/v12.0.0...v13.0.0 diff --git a/docs/blog/2023/02-26-release-v13/stats.png b/docs/blog/2023/02-26-release-v13/stats.png Binary files differnew file mode 100644 index 00000000..e68d0579 --- /dev/null +++ b/docs/blog/2023/02-26-release-v13/stats.png diff --git a/docs/docs/commands/list.md b/docs/docs/commands/list.md index de9689e6..0aff88c1 100644 --- a/docs/docs/commands/list.md +++ b/docs/docs/commands/list.md @@ -11,3 +11,20 @@ title: Listing History | `--session/-s` | Enable listing history for the current session only (default: false) | | `--human` | Use human-readable formatting for the timestamp and duration (default: false) | | `--cmd-only` | Show only the text of the command (default: false) | +| `--format` | Specify the formatting of a command (see below) | + +## Format + +Customize the output of `history list` + +Example + +``` +atuin history list --format "{time} - {duration} - {command}" +``` + +Supported variables + +``` +{command}, {directory}, {duration}, {user}, {host} and {time} +``` diff --git a/docs/docs/config/config.md b/docs/docs/config/config.md index e5ae4adb..dd840017 100644 --- a/docs/docs/config/config.md +++ b/docs/docs/config/config.md @@ -191,6 +191,17 @@ or `py`. ^core go$ | rb$ | py$ ``` -## Server config +### history_filter -`// TODO` +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! + +``` +## 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=.+" +] +``` |
