extern/starship
1
0
Fork 0
mirror of https://github.com/starship/starship.git synced 2024-11-27 10:45:05 +01:00
Code Issues Packages Projects Releases Wiki Activity
☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!
342 Commits 9 Branches 144 Tags 172 MiB
Rust 95.6%
Shell 2.9%
PowerShell 1.1%
Lua 0.1%
42ce87ce8a
Go to file
Matan Kushner 42ce87ce8a Update Crowdin configuration file
2019-09-18 16:37:30 -04:00
.github ci: Update Actions events to include pull_request 2019-09-04 20:56:06 -04:00
ci ci: Fix rust cross installation 2019-09-05 00:36:27 -04:00
docs ​docs: Fix typo (confguring ➜ configuring) (#385) 2019-09-17 12:41:35 -04:00
media docs: Add new demo gif to README (#231) 2019-08-22 20:03:45 -04:00
src fix: Update Module::is_empty to check value of segments (#332) 2019-09-16 00:03:44 -05:00
tests feat: Add configuration for the git_status prefix and suffix (#367) 2019-09-15 16:44:53 -04:00
.all-contributorsrc docs: update bookun as a contributor (#381) 2019-09-16 12:33:41 -04:00
.dockerignore Add docker for integration tests (#37) 2019-04-28 13:34:46 -04:00
.gitignore feat: Add option to control git directory truncation (#165) 2019-08-16 20:29:22 -07:00
acceptance_test chore: Rename integration_test to acceptance_test (#356) 2019-09-12 18:01:13 -05:00
azure-pipelines.yml ci: Add a build target for musl 2019-09-08 00:20:21 -04:00
Cargo.lock chore(deps): Bump chrono from 0.4.6 to 0.4.9 (#340) 2019-09-15 10:28:01 -04:00
Cargo.toml chore(bump): v0.17.0 2019-09-12 14:12:02 -04:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#42) 2019-04-30 23:30:42 -04:00
CONTRIBUTING.md chore: Rename integration_test to acceptance_test (#356) 2019-09-12 18:01:13 -05:00
crowdin.yml Update Crowdin configuration file 2019-09-18 16:37:30 -04:00
LICENSE docs: Attribute copyright to Starship Contributors (#115) 2019-07-25 12:50:29 -04:00
README.ja.md docs(i18n): Reset translation of README (#390) 2019-09-18 11:43:59 -04:00
README.md docs: update bookun as a contributor (#381) 2019-09-16 12:33:41 -04:00

README.md


Starship – Cross-shell prompt

Crates.io version Azure Pipelines Build Status Packaging 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 you need while you're working, while staying sleek and out of the way.


Starship with iTerm2 and the Snazzy theme

🍬 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 Ruby version (💎)
  • Current Python version (🐍)
  • Current Go version (🐹)
  • Nix-shell environment detection
  • Current version of package in current directory (📦)
    • npm (Node.js)
    • cargo (Rust)
    • poetry (Python)
  • 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
  • Execution time of the last command if it exceeds the set threshold
  • Indicator for jobs in the background (✦)

🚀 Installation

Prerequisites

Getting Started

  1. Install the starship binary:

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

    Homebrew

    $ brew install starship

    Rust (v1.33 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

eval (starship init fish)

    Zsh

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

    # ~/.zshrc

eval "$(starship init zsh)"

🔧 Configuration

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

🤝 Contributing

We are always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a good first issue.

High Priority Needs

  • 👩‍💼 Product Manager
    • We have a GitHub Project and many unorganized/unprioritized features, as well as ideas that haven't yet been made into issues. Starship needs someone to own the product direction!
  • 👩‍🎨 Designer
    • Like making eye-catching websites? Excellent! We are looking to create a beautiful landing page showing off Starship in all its glory. Helping design for Starship's brand is a great opportunity to try out new ideas!
  • 👩‍💻 Rust Developer
    • There is a lot of low-hanging fruit when it comes to writing idiomatic Rust, designing effective Rust architecture, performance optimizations, cross-platform build optimizations, and more! I (@matchai) am a beginner to Rust. Come point us in the right direction!

If you are interested in helping contribute to starship, please take a look at our Contributing Guide. Also, feel free to drop into our Discord server and say hi. 👋

Contributors

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
🐛 💻 📖 ⚠️		 Andrew Dassonville
Andrew Dassonville
🐛 💻		 MaT1g3R
MaT1g3R
💻 📖 ⚠️		 André Zanellato
André Zanellato
💻 📖 ⚠️		 Saghm Rossi
Saghm Rossi
💻 📖 ⚠️		 Shu Kutsuzawa
Shu Kutsuzawa
💻 📖 ⚠️ 🌍		 Saurav Sharma
Saurav Sharma
💻 📖
Thomas O'Donnell
Thomas O'Donnell
💻 ⚠️		 Bruno Bigras
Bruno Bigras
💻 👀		 Neil Kistner
Neil Kistner
💻 ⚠️ 👀		 Quinn Strahl
Quinn Strahl
💻 ⚠️		 Titouan Vervack
Titouan Vervack
💻 ⚠️		 Francisco Lopes
Francisco Lopes
💻		 Andrew Houts
Andrew Houts
💻 📖 ⚠️
Nick Young
Nick Young
💻 📖 ⚠️ 👀		 Gabriel de Perthuis
Gabriel de Perthuis
💻		 Hofer-Julian
Hofer-Julian
📖		 Yuji Ueki
Yuji Ueki
🖋 🌍		 谢祯晖
谢祯晖
💻 📖 🌍 👀		 Kutsuzawa Ryo
Kutsuzawa Ryo
👀 💻 ⚠️ 🌍

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

💭 Inspired By

Please check out these previous works that helped inspire the creation of starship. 🙏


Starship rocket icon

📝 License

Copyright © 2019-present, Starship Contributors.
This project is ISC licensed.