starship/docs
Luca Greco 337f213753 feat: Add the hg_branch module (#569) 2019-12-02 17:37:18 -05:00
..
.vuepress docs: Add an FAQ page to website (#583) 2019-12-01 18:47:19 -05:00
advanced-config docs: Add extra newlines around custom containers 2019-09-28 20:20:18 +09:00
config feat: Add the hg_branch module (#569) 2019-12-02 17:37:18 -05:00
de-DE docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
faq docs: Fix typo in FAQ 2019-12-02 13:35:10 -05:00
fr-FR docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
guide docs: Add vuepress with initial docs (#99) 2019-07-19 16:18:52 -04:00
ja-JP docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
ru-RU docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
zh-CN docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
zh-TW docs(i18n): New Crowdin translations (#619) 2019-11-29 14:47:23 -05:00
README.md docs: Update installation instructions for fish-shell (#599) 2019-10-29 12:48:45 +09:00
package-lock.json docs: Add sitemap and robots.txt 2019-11-05 22:29:46 +09:00
package.json docs: Add sitemap and robots.txt 2019-11-05 22:29:46 +09:00

README.md

home heroImage actionText actionLink footer
true /logo.svg Get Started → /guide/ ISC Licensed | Copyright © 2019-present Starship Contributors

Compatibility First

Works on the most common shells on the most common operating systems. Use it everywhere!

Rust-Powered

Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible.

Customizable

Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be.

Quick Install

  1. Install the starship binary:

    Download archives of precompiled binaries if you don't use the platforms below.

    Homebrew

    $ brew install starship
    

    Rust (v1.38 or higher)

    $ cargo install starship
    

    Arch Linux (AUR)

    Starship is available on the AUR under the name starship. Install it with yay or your favorite AUR helper.

    $ yay -S starship
    

    Nix (unstable)

    $ nix-env --install starship
    

    Termux

    $ pkg install starship
    
  2. Add the init script to your shell's config file:

    Bash

    Add the following to the end of ~/.bashrc:

    # ~/.bashrc
    
    eval "$(starship init bash)"
    

    Fish

    Add the following to the end of ~/.config/fish/config.fish:

    # ~/.config/fish/config.fish
    
    starship init fish | source
    

    Zsh

    Add the following to the end of ~/.zshrc:

    # ~/.zshrc
    
    eval "$(starship init zsh)"
    

    Powershell

    Add the following to the end of ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 (or ~/.config/powershell/Microsoft.PowerShell_profile.ps1 on -Nix):

    # ~\Documents\PowerShell\Profile.ps1
    Invoke-Expression (&starship init powershell)