Go to file
allcontributors[bot] f803d70021 docs: add chipbuster as a contributor (#107) 2019-07-20 13:47:07 -04:00
.github Clean up feature request template comment 2019-04-30 14:30:40 -04:00
ci ci: Use Python v3.6.9 in CI (#101) 2019-07-19 15:56:36 -04:00
docs docs: Add vuepress with initial docs (#99) 2019-07-19 16:18:52 -04:00
media docs: Add vuepress with initial docs (#99) 2019-07-19 16:18:52 -04:00
src fix: handle path to shell in starship init (#106) 2019-07-20 13:45:41 -04:00
tests docs: Add vuepress with initial docs (#99) 2019-07-19 16:18:52 -04:00
.all-contributorsrc docs: add chipbuster as a contributor (#107) 2019-07-20 13:47:07 -04:00
.dockerignore Add docker for integration tests (#37) 2019-04-28 13:34:46 -04:00
.gitignore docs: Add vuepress with initial docs (#99) 2019-07-19 16:18:52 -04:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#42) 2019-04-30 23:30:42 -04:00
CONTRIBUTING.md docs: Add CONTRIBUTNG.md (#79) 2019-06-15 11:23:29 +01:00
Cargo.lock v0.3.0 2019-07-19 22:08:43 -04:00
Cargo.toml chore: Exclude docs from published crate 2019-07-19 22:13:11 -04:00
LICENSE Add LICENSE 2019-04-13 00:47:49 -04:00
README.md docs: add chipbuster as a contributor (#107) 2019-07-20 13:47:07 -04:00
azure-pipelines.yml ci: Set releases to not be pre-releases 2019-07-15 00:04:53 -04:00
integration_test Add support for prompt configuration (#62) 2019-06-10 15:56:17 +01:00

README.md


Starship – Cross-shell prompt

Crates.io version Azure Pipelines Build Status All Contributors Chat on Discord


Website · Installation · Configuration

Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! The prompt shows information need while you're working, while staying sleek and out of the way.

Starship with Hyper and One Dark

Features

  • Prompt character turns red if the last command exits with non-zero code.
  • Current username if not the same as the logged-in user.
  • Current Node.js version().
  • Current Rust version (🦀).
  • Current Python version (🐍).
  • Current Go version (🐹).
  • Package version of package in current directory (📦).
  • Current battery level and status
  • Current Git branch and rich repo status:
    • = — conflicting changes
    • — ahead of remote branch
    • — behind of remote branch
    • — diverged changes
    • ? — untracked changes
    • $ — stashed changes
    • ! — modified files
    • + — added files
    • » — renamed files
    • — deleted files
  • PLANNED #80 Indicator for jobs in the background ().
  • PLANNED #104 Execution time of the last command if it exceeds the set threshold.

Installation

Prerequisites

Getting Started

  1. Install the starship binary:

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

    Bash / Zsh

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

    # ~/.bashrc or ~/.zshrc
    
    eval "$(starship init $0)"
    

    Fish

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

    # ~/.config/fish/config.fish
    
    eval (starship init fish)
    

Configuration

For details on how to configure Starship, check out our documentation.

Contribution

If you are interested in helping contribute to starship, please take a look at our Contributing Guide.

Thanks goes to these wonderful people (emoji key):

Matan Kushner
Matan Kushner

💻 🎨 🤔 🚇 🚧 👀 ⚠️
John Letey
John Letey

💻 🤔 👀 ⚠️
Tim Mulqueen
Tim Mulqueen

💻 🤔 👀 ⚠️
Tiffany Le-Nguyen
Tiffany Le-Nguyen

🤔 🚧 👀 📖
​Snuggle
Snuggle

🎨 🤔 🚧 👀
Ryan Leckey
Ryan Leckey

👀
Youssef Habri
Youssef Habri

💻
Kevin Song
Kevin Song

🐛 💻

This project follows the all-contributors specification. Contributions of any kind welcome!


Starship rocket icon

License

ISC Licensed

Copyright © 2019-present, Matan Kushner