Release Atuin v14 (#836)v14.0.0

* Bump versions

* Write release notes

* add link

14 files changed, 257 insertions, 53 deletions

diff --git a/Cargo.lock b/Cargo.lock
index 7fa24a1f..64d77c53 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -70,7 +70,7 @@ dependencies = [
 
 [[package]]
 name = "atuin"
-version = "13.0.1"
+version = "14.0.0"
 dependencies = [
  "async-trait",
  "atuin-client",
@@ -110,7 +110,7 @@ dependencies = [
 
 [[package]]
 name = "atuin-client"
-version = "13.0.1"
+version = "14.0.0"
 dependencies = [
  "async-trait",
  "atuin-common",
@@ -149,7 +149,7 @@ dependencies = [
 
 [[package]]
 name = "atuin-common"
-version = "13.0.1"
+version = "14.0.0"
 dependencies = [
  "chrono",
  "serde",
@@ -158,7 +158,7 @@ dependencies = [
 
 [[package]]
 name = "atuin-server"
-version = "13.0.1"
+version = "14.0.0"
 dependencies = [
  "async-trait",
  "atuin-common",
diff --git a/Cargo.toml b/Cargo.toml
index 9272dc68..b517a41a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "atuin"
-version = "13.0.1"
+version = "14.0.0"
 authors = ["Ellie Huxtable <ellie@elliehuxtable.com>"]
 edition = "2021"
 rust-version = "1.59"
@@ -44,9 +44,9 @@ sync = ["atuin-client/sync"]
 server = ["atuin-server", "tracing-subscriber"]
 
 [dependencies]
-atuin-server = { path = "atuin-server", version = "13.0.1", optional = true }
-atuin-client = { path = "atuin-client", version = "13.0.1", optional = true, default-features = false }
-atuin-common = { path = "atuin-common", version = "13.0.1" }
+atuin-server = { path = "atuin-server", version = "14.0.0", optional = true }
+atuin-client = { path = "atuin-client", version = "14.0.0", optional = true, default-features = false }
+atuin-common = { path = "atuin-common", version = "14.0.0" }
 
 log = "0.4"
 env_logger = "0.10.0"
diff --git a/README.md b/README.md
index 6471b5a4..030bad9e 100644
--- a/README.md
+++ b/README.md
@@ -289,11 +289,3 @@ Add to `config.nu`:
 ```
 source ~/.local/share/atuin/init.nu
 ```
-
-## ...what's with the name?
-
-Atuin is named after "The Great A'Tuin", a giant turtle from Terry Pratchett's
-Discworld series of books.
-
-[English]: ./README.md
-[简体中文]: ./docs/zh-CN/README.md
diff --git a/atuin-client/Cargo.toml b/atuin-client/Cargo.toml
index 1fc5baf1..1eda2c29 100644
--- a/atuin-client/Cargo.toml
+++ b/atuin-client/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "atuin-client"
-version = "13.0.1"
+version = "14.0.0"
 authors = ["Ellie Huxtable <ellie@elliehuxtable.com>"]
 edition = "2018"
 license = "MIT"
@@ -23,7 +23,7 @@ sync = [
 ]
 
 [dependencies]
-atuin-common = { path = "../atuin-common", version = "13.0.1" }
+atuin-common = { path = "../atuin-common", version = "14.0.0" }
 
 log = "0.4"
 chrono = { version = "0.4", features = ["serde"] }
diff --git a/atuin-common/Cargo.toml b/atuin-common/Cargo.toml
index 7c407503..16592381 100644
--- a/atuin-common/Cargo.toml
+++ b/atuin-common/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "atuin-common"
-version = "13.0.1"
+version = "14.0.0"
 authors = ["Ellie Huxtable <ellie@elliehuxtable.com>"]
 edition = "2018"
 license = "MIT"
diff --git a/atuin-server/Cargo.toml b/atuin-server/Cargo.toml
index 59afa0ac..9b4df477 100644
--- a/atuin-server/Cargo.toml
+++ b/atuin-server/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "atuin-server"
-version = "13.0.1"
+version = "14.0.0"
 authors = ["Ellie Huxtable <ellie@elliehuxtable.com>"]
 edition = "2018"
 license = "MIT"
@@ -9,7 +9,7 @@ homepage = "https://atuin.sh"
 repository = "https://github.com/ellie/atuin"
 
 [dependencies]
-atuin-common = { path = "../atuin-common", version = "13.0.1" }
+atuin-common = { path = "../atuin-common", version = "14.0.0" }
 
 tracing = "0.1"
 chrono = { version = "0.4", features = ["serde"] }
diff --git a/docs/blog/2023/04-01-release-v14/dau.png b/docs/blog/2023/04-01-release-v14/dau.png
new file mode 100644
index 00000000..a1794421
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/dau.png
diff --git a/docs/blog/2023/04-01-release-v14/index.md b/docs/blog/2023/04-01-release-v14/index.md
new file mode 100644
index 00000000..dbdf1317
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/index.md
@@ -0,0 +1,198 @@
+---
+title: Atuin v14 - Deletions, NuShell, Windows and more!
+description: Release notes for Atuin v14! 
+slug: release-v14
+authors: [ellie]
+tags: [release]
+---
+
+Announcing a new release of Atuin! v14 is out now. Atuin allows you to easily search and sync your shell history across many machines. Get started [here](https://atuin.sh/docs/)
+
+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).
+
+This release introduces some breaking changes, so please ensure all Atuin clients and servers are updated or sync may not complete.
+
+We had a lot of changes in this release - I'll call out a few, but this is not exhaustive. Read the changelog below for the full list!
+
+### Community
+
+- [Discord](https://discord.gg/Fq8bJSKPHh)
+- [Mastodon](https://hachyderm.io/@atuin)
+- [Twitter](https://twitter.com/atuinsh)
+
+## New Features
+
+### Deletions
+
+You can now delete history! This has been our longest-standing issue, and one we are frequently asked about. So it's great to get it out! It took us a while due to the nature of sync, and we wanted to try several different approaches. There is still no way to delete history from the UI, however you can now pass the `--delete` flag to any `atuin search` command to delete all history matching the query. I suggest you run the search _without_ the delete flag first, just to check what you are removing
+
+For example, to delete all commands that start with `psql`:
+
+```
+atuin search --delete --search-mode prefix psql
+```
+
+### NuShell
+
+We now support NuShell! This was a huge effort by [@stevenxxiu](https://github.com/stevenxxiu), and involved work on both Atuin and NuShell itself. The effort was greatly appreciated, thank you so much 💖
+
+Run in *Nushell*:
+
+```
+mkdir ~/.local/share/atuin/
+atuin init nu | save ~/.local/share/atuin/init.nu
+```
+
+Add to `config.nu`:
+
+```
+source ~/.local/share/atuin/init.nu
+```
+
+PRs:
+- https://github.com/nushell/nushell/pull/8560
+- https://github.com/nushell/nushell/pull/8207
+- https://github.com/ellie/atuin/pull/788
+
+### Inline history UI
+
+![inline history](inline.png)
+
+Another of our biggest asks - the UI can now be configured so that it does not take the entire screen. Thank you to [@pdecat](https://github.com/pdecat)
+
+Simply add 
+
+```
+# Choose a height for the inline history search
+inline_height = 40
+```
+
+to your Atuin config file, and you're good to go!
+
+We didn't sort it in time for v14, but in v15 you will also be able to configure the UI more deeply - for instance, change the position of the search bar.
+
+### Skim fuzzy search
+
+We have also added an alternative new search mode! This uses [skim](https://github.com/lotabout/skim) behind the scenes. Check it out with `search_mode = "skim"`. Thank you [@conradludgate](https://github.com/conradludgate)
+
+### Windows
+
+Atuin now _provisionally_ supports Windows! We cannot provide full support + releases won't be tested to the same level on Windows, however a few contributors have now been building + running on the platform without issues. Thank you so much to [@YummyOreo](https://github.com/YummyOreo) for this one!
+
+### Command preview
+
+![preview](preview.png)
+
+Previously, longer commands would be cut off in the UI. Thanks to [@pdecat](https://github.com/pdecat), we now have a preview window! Enable it with a `show_preview = true`
+
+## Improvements
+
+- Bash import improved
+- Prefer PWD env variable over cwd to better handle symlinks
+- Ignore common prefixes and subcommands in stats calculations
+- Add musl build
+- Add `atuin status` command to check sync status
+
+## Stickers
+
+Since the last release, we have printed some stickers!
+
+If you'd like one, please fill out one of the following:
+
+- [Contributor form](https://notionforms.io/forms/contributors-stickers)
+- [User form](https://notionforms.io/forms/user-stickers)
+
+
+## New contributors
+A special thank you to everyone who contributed for the first time in this release!
+
+* [@0x4A6F](https://github.com/0x4A6F) made their first contribution in https://github.com/ellie/atuin/pull/743
+* [@notjedi](https://github.com/notjedi) made their first contribution in https://github.com/ellie/atuin/pull/753
+* [@stevenxxiu](https://github.com/stevenxxiu) made their first contribution in https://github.com/ellie/atuin/pull/719
+* [@YummyOreo](https://github.com/YummyOreo) made their first contribution in https://github.com/ellie/atuin/pull/754
+* [@lukekarrys](https://github.com/lukekarrys) made their first contribution in https://github.com/ellie/atuin/pull/757
+* [@onkelT2](https://github.com/onkelT2) made their first contribution in https://github.com/ellie/atuin/pull/767
+* [@aschey](https://github.com/aschey) made their first contribution in https://github.com/ellie/atuin/pull/776
+* [@nicoandmee](https://github.com/nicoandmee) made their first contribution in https://github.com/ellie/atuin/pull/789
+* [@hhamud](https://github.com/hhamud) made their first contribution in https://github.com/ellie/atuin/pull/793
+* [@iamkroot](https://github.com/iamkroot) made their first contribution in https://github.com/ellie/atuin/pull/586
+* [@InCogNiTo124](https://github.com/InCogNiTo124) made their first contribution in https://github.com/ellie/atuin/pull/809
+* [@takac](https://github.com/takac) made their first contribution in https://github.com/ellie/atuin/pull/824
+* [@sftblw](https://github.com/sftblw) made their first contribution in https://github.com/ellie/atuin/pull/827
+
+## Sync server stats
+I've ran a public sync server since the very beginning, and thought I'd share some stats from it! Bear in mind all data is encrypted, so the data we can see is only very high level.
+
+In March, we saw:
+
+- 2,031,355 history lines synced up, with a total of 13,077,001
+- 137 new users, with a total of 1136 (we passed 1000!)
+
+We also cleared 500 monthly active users for the first time! See the charts below for DAU/WAU/MAU
+
+![](dau.png)
+![](wau.png)
+![](mau.png)
+
+## Full changelog
+
+* Add Hachyderm links by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/742
+* Update flake.lock to Rust 1.67 by [@patricksjackson](https://github.com/patricksjackson) in https://github.com/ellie/atuin/pull/749
+* nix: add flake-compat by [@0x4A6F](https://github.com/0x4A6F) in https://github.com/ellie/atuin/pull/743
+* Fix race condition in directory tests by [@cyqsimon](https://github.com/cyqsimon) in https://github.com/ellie/atuin/pull/748
+* Rework Bash import by [@cyqsimon](https://github.com/cyqsimon) in https://github.com/ellie/atuin/pull/747
+* docs(README): fix activity graph link by [@notjedi](https://github.com/notjedi) in https://github.com/ellie/atuin/pull/753
+* Show preview of selected command by [@pdecat](https://github.com/pdecat) in https://github.com/ellie/atuin/pull/643
+* Up arrow filter_mode setting default to global filter mode by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/758
+* feat: add common default keybindings by [@stevenxxiu](https://github.com/stevenxxiu) in https://github.com/ellie/atuin/pull/719
+* Bump debian from bullseye-20230208-slim to bullseye-20230227-slim by @dependabot in https://github.com/ellie/atuin/pull/744
+* Windows support by [@YummyOreo](https://github.com/YummyOreo) in https://github.com/ellie/atuin/pull/754
+* fix(client): always read session_path from settings by [@lukekarrys](https://github.com/lukekarrys) in https://github.com/ellie/atuin/pull/757
+* Add register notification webhook by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/764
+* Install CA certificates in docker image by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/765
+* Docker isn't interactive ofc by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/766
+* Minor documentation updates by [@onkelT2](https://github.com/onkelT2) in https://github.com/ellie/atuin/pull/767
+* Fix before/after combined with limit by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/770
+* Allow specifying fulltext as well as full-text by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/771
+* fix new stats unique count by [@conradludgate](https://github.com/conradludgate) in https://github.com/ellie/atuin/pull/772
+* add common prefixes and subcommands to stats by [@conradludgate](https://github.com/conradludgate) in https://github.com/ellie/atuin/pull/773
+* fix(installer): use case-insensitive comparisons by @aschey in https://github.com/ellie/atuin/pull/776
+* Fixes a bug on windows by [@YummyOreo](https://github.com/YummyOreo) in https://github.com/ellie/atuin/pull/780
+* Prefer PWD environment variable over cwd if available to better support symbolic links by [@pdecat](https://github.com/pdecat) in https://github.com/ellie/atuin/pull/783
+* fix: many links were broken :memo: by [@nicoandmee](https://github.com/nicoandmee) in https://github.com/ellie/atuin/pull/789
+* skim-demo by [@conradludgate](https://github.com/conradludgate) in https://github.com/ellie/atuin/pull/695
+* Add history deletion by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/791
+* fix: paste into terminal after switching modes by [@hhamud](https://github.com/hhamud) in https://github.com/ellie/atuin/pull/793
+* Support old msgpack by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/794
+* Fix skim search by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/795
+* Allow changing search_mode during interactive search by [@iamkroot](https://github.com/iamkroot) in https://github.com/ellie/atuin/pull/586
+* chore: remove tui vendoring by [@conradludgate](https://github.com/conradludgate) in https://github.com/ellie/atuin/pull/804
+* Bump debian from bullseye-20230227-slim to bullseye-20230320-slim by @dependabot in https://github.com/ellie/atuin/pull/802
+* Delete all instances of a command by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/797
+* Bump lukemathwalker/cargo-chef from latest-rust-1.67.1 to latest-rust-1.68.0 by @dependabot in https://github.com/ellie/atuin/pull/781
+* feat: respect exit_mode setting when exiting with arrow down keypress by [@pdecat](https://github.com/pdecat) in https://github.com/ellie/atuin/pull/807
+* feat: add an inline view mode by [@pdecat](https://github.com/pdecat) in https://github.com/ellie/atuin/pull/648
+* Add musl build by [@InCogNiTo124](https://github.com/InCogNiTo124) in https://github.com/ellie/atuin/pull/809
+* feat: add *Nushell* support by [@stevenxxiu](https://github.com/stevenxxiu) in https://github.com/ellie/atuin/pull/788
+* chore: use fork of skim by [@conradludgate](https://github.com/conradludgate) in https://github.com/ellie/atuin/pull/803
+* Bind keys in vi mode too by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/811
+* Account for user not yet having count cache by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/812
+* Fixes nushell recording empty commands by [@YummyOreo](https://github.com/YummyOreo) in https://github.com/ellie/atuin/pull/813
+* Update CONTRIBUTING.md by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/815
+* client filtering done in query by @jean-santos in https://github.com/ellie/atuin/pull/629
+* fix: record negative exit codes by [@stevenxxiu](https://github.com/stevenxxiu) in https://github.com/ellie/atuin/pull/821
+* Refactor/nu remove dep on sh by [@stevenxxiu](https://github.com/stevenxxiu) in https://github.com/ellie/atuin/pull/823
+* Update CI  by [@InCogNiTo124](https://github.com/InCogNiTo124) in https://github.com/ellie/atuin/pull/814
+* Add more fields to `atuin search --format` by [@takac](https://github.com/takac) in https://github.com/ellie/atuin/pull/824
+* install.sh - add endeavouros to archlinux detection by [@sftblw](https://github.com/sftblw) in https://github.com/ellie/atuin/pull/827
+* Add `--offset` flag to `atuin search` by [@takac](https://github.com/takac) in https://github.com/ellie/atuin/pull/825
+* Update `atuin search` docs by [@takac](https://github.com/takac) in https://github.com/ellie/atuin/pull/828
+* Add `atuin status` by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/830
+* fix: allow nix package to fetch dependencies from git by [@patricksjackson](https://github.com/patricksjackson) in https://github.com/ellie/atuin/pull/832
+* feat: add github action to test the nix builds by [@patricksjackson](https://github.com/patricksjackson) in https://github.com/ellie/atuin/pull/833
+* Vendor ratatui temporarily by [@ellie](https://github.com/ellie) in https://github.com/ellie/atuin/pull/835
+
+## Next release
+While this release was pretty big, we have a lot planned for the next one too! It should be out around the beginning of May.
+
+**GitHub**: https://github.com/ellie/atuin/compare/v13.0.1...v14.0.0
diff --git a/docs/blog/2023/04-01-release-v14/inline.png b/docs/blog/2023/04-01-release-v14/inline.png
new file mode 100644
index 00000000..5326ac45
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/inline.png
diff --git a/docs/blog/2023/04-01-release-v14/mau.png b/docs/blog/2023/04-01-release-v14/mau.png
new file mode 100644
index 00000000..4d84ccee
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/mau.png
diff --git a/docs/blog/2023/04-01-release-v14/preview.png b/docs/blog/2023/04-01-release-v14/preview.png
new file mode 100644
index 00000000..11db8009
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/preview.png
diff --git a/docs/blog/2023/04-01-release-v14/wau.png b/docs/blog/2023/04-01-release-v14/wau.png
new file mode 100644
index 00000000..568a26fd
--- /dev/null
+++ b/docs/blog/2023/04-01-release-v14/wau.png
diff --git a/docs/docs/commands/search.md b/docs/docs/commands/search.md
index 21074be9..eacb22e2 100644
--- a/docs/docs/commands/search.md
+++ b/docs/docs/commands/search.md
@@ -21,6 +21,7 @@ appended with a wildcard).
 | `--human`          | Use human-readable formatting for the timestamp and duration (default: false) |
 | `--limit`          | Limit the number of results (default: none)                                   |
 | `--offset`         | Offset from the start of the results (default: none)                          |
+| `--delete`         | Delete history matching this query                                            |
 
 ## Examples
 
@@ -40,6 +41,9 @@ atuin search --exclude-exit 0 --before 01/04/2021 --cwd .
 # Search for all commands, beginning with cargo, that exited successfully, and were ran after yesterday at 3pm
 atuin search --exit 0 --after "yesterday 3pm" cargo
 
+# Delete all commands, beginning with cargo, that exited successfully, and were ran after yesterday at 3pm
+atuin search --delete --exit 0 --after "yesterday 3pm" cargo
+
 # Search for a command beginning with cargo, return exactly one result.
 atuin search --limit 1 cargo
 
diff --git a/docs/docs/index.md b/docs/docs/index.md
index 599399d5..b79c169f 100644
--- a/docs/docs/index.md
+++ b/docs/docs/index.md
@@ -17,15 +17,18 @@ I wanted to. And I **really** don't want to.
 - zsh
 - bash
 - fish
-
+- nushell
+ 
 ## Community
 
-Atuin has a community Discord, available [here](https://discord.gg/Fq8bJSKPHh)! Please do come and say hi 😊
+Atuin has a community Discord, available [here](https://discord.gg/Fq8bJSKPHh)
 
 # Quickstart
-
+  
+## With the default sync server
+  
 This will sign you up for the default sync server, hosted by me. Everything is end-to-end encrypted, so your secrets are safe!
-
+  
 Read more below for offline-only usage, or for hosting your own server.
 
 ```
@@ -37,27 +40,27 @@ atuin sync
 ```
 
 Then restart your shell!
-
+  
 ### Opt-in to activity graph
 Alongside the hosted Atuin server, there is also a service which generates activity graphs for your shell history! These are inspired by the GitHub graph.
-
+  
 For example, here is mine:
-
+  
 ![Activity Graph Example](/img/activity-graph-example.png)
 
 If you wish to get your own, after signing up for the sync server, run this
-
+  
 ```
 curl https://api.atuin.sh/enable -d $(cat ~/.local/share/atuin/session)
 ```
-
-The response includes the URL to your graph. Feel free to share and/or embed this URL, the token is _not_ a secret, and simply prevents user enumeration.
-
+  
+The response includes the URL to your graph. Feel free to share and/or embed this URL, the token is _not_ a secret, and simply prevents user enumeration. 
+  
 ## Offline only (no sync)
-
+  
 ```
 bash <(curl https://raw.githubusercontent.com/ellie/atuin/main/install.sh)
-
+            
 atuin import auto
 ```
 
@@ -86,7 +89,7 @@ toolchain, then you can run:
 ```
 cargo install atuin
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
 
 ### Homebrew
@@ -94,17 +97,17 @@ And then follow [the shell setup](#shell-plugin)
 ```
 brew install atuin
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
-
+  
 ### MacPorts
 
-Atuin is also available in [MacPorts](https://ports.macports.org/port/atuin/)
-
+Atuin is also available in [MacPorts](https://ports.macports.org/port/atuin/)  
+  
 ```
 sudo port install atuin
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
 
 ### Nix
@@ -129,7 +132,7 @@ Atuin is available in the Arch Linux [community repository](https://archlinux.or
 ```
 pacman -S atuin
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
 
 ### Termux
@@ -139,7 +142,7 @@ Atuin is available in the Termux package repository:
 ```
 pkg install atuin
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
 
 ### From source
@@ -149,7 +152,7 @@ git clone https://github.com/ellie/atuin.git
 cd atuin
 cargo install --path .
 ```
-
+  
 And then follow [the shell setup](#shell-plugin)
 
 ## Shell plugin
@@ -169,9 +172,9 @@ echo 'eval "$(atuin init zsh)"' >> ~/.zshrc
 zinit load ellie/atuin
 ```
 
-#### Antigen
-
-```sh
+#### Antigen  
+  
+```sh  
 antigen bundle ellie/atuin@main
 ```
 
@@ -199,17 +202,24 @@ atuin init fish | source
 ```
 
 to your `is-interactive` block in your `~/.config/fish/config.fish` file
-
+  
 ### Fig
 
-Install `atuin` shell plugin in zsh, bash, or fish with [Fig](https://fig.io) in one click.
+Install `atuin` shell plugin in zsh, bash, or fish with [Fig](https://fig.io) in one click. 
 
 <a href="https://fig.io/plugins/other/atuin" target="_blank"><img src="https://fig.io/badges/install-with-fig.svg" /></a>
 
-## ...what's with the name?
+### Nushell
+
+Run in *Nushell*:
 
-Atuin is named after "The Great A'Tuin", a giant turtle from Terry Pratchett's
-Discworld series of books.
+```
+mkdir ~/.local/share/atuin/
+atuin init nu | save ~/.local/share/atuin/init.nu
+```
 
-[English]: ../README.md
-[简体中文]: ../../docs/zh-CN/README.md
+Add to `config.nu`:
+
+```
+source ~/.local/share/atuin/init.nu
+```