Skip to content

Various improvements to the atuin import page #111

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
waldyrious wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Various improvements to the atuin import page #111

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
376532c
Fix name of two import subcommands
waldyrious Nov 26, 2025
302a728
Document the replxx and powershell history import subcommands
waldyrious Nov 28, 2025
ff7a1ff
Fix sorting of sections in the import page
waldyrious Nov 28, 2025
973f619
Normalize whitespace handling in import page
waldyrious Nov 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 28 additions & 12 deletions src/content/docs/reference/import.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,21 +43,37 @@ will be `{session}_history` in `$XDG_DATA_HOME/fish/` (or `$HOME/.local/share/fi
Not all of the data in the fish history is preserved, some data about filenames used
for each command are not used by Atuin, so it is discarded.

## nu

This importer reads from Nushell's text history format, which is stored in
`$XDG_CONFIG_HOME/nushell/history.txt` or `$HOME/.config/nushell/history.txt`.
There is no way to set the filename otherwise.

## nu-hist-db

This importer reads from Nushell's SQLite history database, which is stored in
This importer reads from Nushell's SQLite history database, which is stored in
`$XDG_CONFIG_HOME/nushell/history.sqlite3` or `$HOME/.config/nushell/history.sqlite3`.
There is no way to set the filename otherwise.

## nu
## powershell

This importer reads from Nushell's text history format, which is stored in
`$XDG_CONFIG_HOME/nushell/history.txt` or `$HOME/.config/nushell/history.txt`.
There is no way to set the filename otherwise.
This importer reads from
[PowerShell's history file](https://learn.microsoft.com/en-us/powershell/module/psreadline/about/about_psreadline#command-history).
On Windows, the file is located at
`$APPDATA\Microsoft\Windows\PowerShell\PSReadLine\ConsoleHost_history.txt`.
On other systems, it is located at
`$XDG_DATA_HOME/powershell/PSReadLine/ConsoleHost_history.txt`
or `$HOME/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`.

## replxx

The [replxx](https://github.com/AmokHuginnsson/replxx) importer will read from
`$HISTFILE` or `$HOME/.histfile`.

## resh

The [RESH](https://github.com/curusarn/resh) importer will read from `$HISTFILE` or `$HOME/.resh_history.json`.
The [RESH](https://github.com/curusarn/resh) importer will read from `$HISTFILE`
or `$HOME/.resh_history.json`.

## xonsh

Expand All @@ -74,7 +90,7 @@ environment variables present when each session was initiated, but this data is
discarded by Atuin. Xonsh optionally stores the output of each command; if present
this data is also ignored by Atuin.

## xonsh_sqlite
## xonsh-sqlite

The Xonsh SQLite importer will read from the Xonsh SQLite history file. The history
file's location is determined by the same process as the regular Xonsh importer,
Expand All @@ -84,12 +100,12 @@ The Xonsh SQLite backend does not store environment variables, but like the JSON
backend it can optionally store the output of each command. As with the JSON backend,
if present this data will be ignored by Atuin.

## zsh_histdb

This will read the Zsh histdb SQLite file from `$HISTDB_FILE` or
`$HOME/.histdb/zsh-history.db`.

## zsh

This will read the Zsh history from `$HISTFILE` or `$HOME/.zhistory`
or `$HOME/.zsh_history` in either the simple or extended format.

## zsh-hist-db

This will read the Zsh histdb SQLite file from `$HISTDB_FILE` or
`$HOME/.histdb/zsh-history.db`.