starship/README.md at 8aec55b3ba7b4bd9a1a7e253645b5afd02cacb82

Llewellyn/starship

Fork 0

mirror of https://github.com/Llewellynvdm/starship.git synced 2024-11-05 04:47:58 +00:00

Matan Kushner 8aec55b3ba

docs: Make our README.md prettier (with a few added details) (#111 )

2019-07-24 12:34:37 -04:00

8.7 KiB

Raw Blame History

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

Rust v1.33 or higher
A Powerline font installed and enabled in your terminal (for example, try Fira Code).

Getting Started

Install the starship binary:
```
cargo install starship
```
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.

🤝 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} 💻 🎨 🤔 🚇 🚧 👀 ⚠️	_{John Letey} 💻 🤔 👀 ⚠️	_{Tim Mulqueen} 💻 🤔 👀 ⚠️	_{Tiffany Le-Nguyen} 🤔 🚧 👀 📖	_Snuggle 🎨 🤔 🚧 👀	_{Ryan Leckey} 👀	_{Youssef Habri} 💻
_{Kevin Song} 🐛 💻