Skip to main content

Bring your ZSH history to Fish shell.

Project description

PyPI version PyPI pyversions PyPI status

Bring your ZSH history to Fish shell

This is a simple tool to ease the migration from ZSH to Fish shell, without losing your hard-earned history commands.

As I was migrating myself, I've found out there's no tool to do this automatically, so I've made one for my own use. For that, I had to search for the specifications of both history files, and ended up involved in multiple threads with the right devs to try to understand and make it work. In the process, I've stumbled upon several people interested in a such a tool.

Well, it has worked! So I've wrapped it in a python package to make it easy to use, and now I'm sharing with anyone who may need it! It's released on PyPI.

Get it

Just do in your zsh shell:

❯ pip install zsh-history-to-fish

How to use

❯ zsh-history-to-fish --help
Usage: zsh-history-to-fish [OPTIONS] [INPUT_FILE]

  Bring your ZSH history to Fish shell.

  --version               Show the version and exit.
  -o, --output_file PATH  Optional output, will append to fish history by default
  -d, --dry-run           Do not write anything to filesystem
  -n, --no-convert        Do not naively convert commands
  --help                  Show this message and exit.

A successful run looks like:

❯ zsh-history-to-fish -dn
ZSH history to Fish
input : /Users/rogerio/.zsh_history (naive-convert=False)
output: dry run mode
Processed 6515 commands.
No file has been written.

Changelog highlights:

  • 0.3.0: fix for empty history lines, and general command output improvements
  • 0.2.0: use actual zsh process to import history, since it does not use utf-8
  • 0.1.0: initial version


This software is licensed under the MIT License. See the LICENSE file in the top distribution directory for the full license text.

Did you like it?

Thank you for your interest!

I've put much ❤️ and effort into this.
If you appreciate my work you can sponsor me, buy me a coffee! The button is on the top right of the page (the big orange one, it's hard to miss 😊)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for zsh-history-to-fish, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size zsh_history_to_fish-0.3.0-py3-none-any.whl (5.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size zsh-history-to-fish-0.3.0.tar.gz (4.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page