https://github.com/zimfw/asciiship

A heavily reduced, ASCII-only version of the Spaceship and Starship prompts.
https://github.com/zimfw/asciiship

ascii spaceship starship zim zimfw zsh zsh-plugin zsh-plugins zsh-prompt zsh-theme zsh-themes

Last synced: about 1 month ago
JSON representation

A heavily reduced, ASCII-only version of the Spaceship and Starship prompts.

• Host: GitHub
• URL: https://github.com/zimfw/asciiship
• Owner: zimfw
• License: mit
• Created: 2021-03-05T22:35:34.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2023-09-16T19:06:46.000Z (over 1 year ago)
• Last Synced: 2024-10-24T18:33:14.650Z (3 months ago)
• Topics: ascii, spaceship, starship, zim, zimfw, zsh, zsh-plugin, zsh-plugins, zsh-prompt, zsh-theme, zsh-themes
• Language: Shell
• Homepage:
• Size: 13.7 KB
• Stars: 19
• Watchers: 3
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
asciiship

=========

A heavily reduced, ASCII-only version of the [Spaceship] and [Starship] prompts.



What does it show?

------------------

  * On the top line:

    * Value of `SHLVL` when shell level is at least 2.

    * User name when root or in an SSH session.

    * Host name when in an SSH session.

    * Current directory.

    * Git information when you are in a git repo. This requires the [git-info]

      module, that can be customized with additional [settings][git-info settings].

      The following information is shown:

      * Current branch name, or commit short hash when in ['detached HEAD' state].

      * Git action, when there's an operation in progress.

      * `$` when there are stashed states.

      * `!` when there are modified files.

      * `+` when there are staged files.

      * `>` and/or `<` when there are commits ahead and/or behind of remote,

        respectively.

    * Python [venv] indicator.

    * How long the last command took to execute. This requires the [duration-info]

      module, that can also be customized with additional [settings][duration-info settings].

  * On the bottom line:

    * `*` when there are background jobs running.

    * Exit code of last command, when it's not zero.

    * `#` when root, `%` otherwise.

    * Keymap indicator.

Requirements

------------

Requires Zim's [git-info] module to show git information, and [duration-info]

module to show the last command duration.

[Spaceship]: https://spaceship-prompt.sh/

[Starship]: https://starship.rs/

[git-info]: https://github.com/zimfw/git-info

[git-info settings]: https://github.com/zimfw/git-info/blob/master/README.md#settings

['detached HEAD' state]: https://git-scm.com/docs/git-checkout#_detached_head

[venv]: https://docs.python.org/3/library/venv.html

[duration-info]: https://github.com/zimfw/duration-info

[duration-info settings]: https://github.com/zimfw/duration-info/blob/master/README.md#settings