You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
oh-my-fish/docs/Themes.md

1826 lines
55 KiB
Markdown

# Available themes
- [agnoster](#agnoster)
- [agnoster-mercurial](#agnoster-mercurial)
- [batman](#batman)
- [beloglazov](#beloglazov)
- [bira](#bira)
- [bobthefish](#bobthefish)
- [budspencer](#budspencer)
- [cbjohnson](#cbjohnson)
- [clearance](#clearance)
- [cmorrell](#cmorrell)
- [coffeeandcode](#coffeeandcode)
- [cor](#cor)
- [dangerous](#dangerous)
- [default](#default)
- [eclm](#eclm)
- [edan](#edan)
- [fishface](#fishface)
- [fishy-drupal](#fishy-drupal)
- [fisk](#fisk)
- [flash](#flash)
- [fox](#fox)
- [gianu](#gianu)
- [gitstatus](#gitstatus)
- [gnuykeaj](#gnuykeaj)
- [godfather](#godfather)
- [hogan](#hogan)
- [hulk](#hulk)
- [idan](#idan)
- [integral](#integral)
- [jacaetevha](#jacaetevha)
- [krisleech](#krisleech)
- [l](#l)
- [led](#led)
- [mtahmed](#mtahmed)
- [nai](#nai)
- [nelsonjchen](#nelsonjchen)
- [numist](#numist)
- [ocean](#ocean)
- [perryh](#perryh)
- [red-snapper](#red-snapper)
- [robbyrussell](#robbyrussell)
- [russell](#russell)
- [scorphish](#scorphish)
- [simplevi](#simplevi)
- [syl20bnr](#syl20bnr)
- [taktoa](#taktoa)
- [technopagan](#technopagan)
- [toaster](#toaster)
- [tomita](#tomita)
- [trout](#trout)
- [uggedal](#uggedal)
- [will](#will)
- [yimmy](#yimmy)
- [zish](#zish)
# agnoster
#### agnoster
A fish theme optimized for people who use:
* Solarized
* Git
* Unicode-compatible fonts and terminals (I use iTerm2 + Menlo)
For Mac users, I highly recommend iTerm 2 + Solarized Dark
![agnoster theme](https://f.cloud.github.com/assets/1765209/255379/452c668e-8c0b-11e2-8a8e-d1d13e57d15f.png)
###### Characteristics
* If the previous command failed (✘)
* User @ Hostname (if user is not DEFAULT_USER, which can then be set in your profile)
* Git status
* Branch () or detached head (➦)
* Current branch / SHA1 in detached head state
* Dirty working directory (±, color change)
* Working directory
* Elevated (root) privileges (⚡)
Ported from https://gist.github.com/agnoster/3712874.
# agnoster-mercurial
#### agnoster
A ZSH theme optimized for people who use:
* Solarized
* Git
* Mercurial
* Unicode-compatible fonts and terminals (I use iTerm2 + Menlo)
For Mac users, I highly recommend iTerm 2 + Solarized Dark
![agnoster theme](https://f.cloud.github.com/assets/1765209/255379/452c668e-8c0b-11e2-8a8e-d1d13e57d15f.png)
###### Characteristics
* If the previous command failed (✘)
* User @ Hostname (if user is not DEFAULT_USER, which can then be set in your profile)
* Git status
* Mercurial status
* Branch () or detached head (➦)
* Current branch / SHA1 in detached head state
* Dirty working directory (±, color change)
* Working directory
* Elevated (root) privileges (⚡)
Ported from https://gist.github.com/agnoster/3712874.
# batman
[![](https://img.shields.io/badge/Themes-Wahoo-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-707070.svg?style=flat-square)
### _Batman_ <img width="20px" src="https://cloud.githubusercontent.com/assets/8317250/7785620/0059f784-01d3-11e5-8a01-8edf6c4e2af7.png">
> Theme for [Fishshell](fishshell.com) inspired by Batman.
#### Features
_From left to right:_
+ `$HOME` directory abbreviated to `^^`
+ Path to current working directory is abbreviated.
+ Arrow symbol `>>>` becomes red if last `$status` was `!= 0`
+ Display exit status for non zero codes (Not shown in the picture)
+ `^` character denotes the current repository has [_stashed_](https://git-scm.com/book/no-nb/v1/Git-Tools-Stashing) changes.
+ `*` character denotes the current repository is dirty.
+ Display current branch.
+ Display number of commits in relation to the current branch.
+ Display current time.
+ _Batman_ inspired colors.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/7788702/8ae84014-0281-11e5-9082-f528002e45ed.png">
</p>
### License
> __Disclaimer:__ This work is not intended to infringe on any rights by and of the companies and/or individuals involved in the production of any series mentioned here. I don't own Batman.
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/batman/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# beloglazov
#### beloglazov
A theme based on the default robbyrussell theme. This theme adds time, the
number of non-pushed commits, and whether the previous command has failed.
![beloglazov-fish-theme](https://raw.github.com/beloglazov/oh-my-fish/master/themes/beloglazov/beloglazov-fish-theme.png)
###### Characteristics
* Displays git information in the command prompt when available
* Displays the number of non-pushed git commits
* Displays the current time
* Displays ✘ if the previous command failed
# bira
#### bira
Theme imported from Oh my ZSH: https://github.com/robbyrussell/oh-my-zsh/blob/master/themes/bira.zsh-theme
Contains traces of nuts and code from other Oh my fish themes.
Display username, hostname, current path, ruby version and git status. Display the latest error status in the right prompt.
![bira theme](https://cloud.githubusercontent.com/assets/1214238/5441541/8bd494dc-8491-11e4-9dbe-256b7e558eac.png)
TODO:
- display Python version
# bobthefish
### bobthefish
bobthefish is a Powerline-style, Git-aware fish theme optimized for awesome.
[![](https://img.shields.io/badge/Framework-Oh My Fish-blue.svg?style=flat)](https://github.com/oh-my-fish/oh-my-fish) ![](https://img.shields.io/cocoapods/l/AFNetworking.svg) [![Join the chat at https://gitter.im/oh-my-fish/oh-my-fish](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/oh-my-fish/oh-my-fish?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
![bobthefish][screenshot]
##### Installation
Add it to your `~/.config/fish/config.fish` file:
Theme bobthefish
Open a new terminal session and run `omf install`.
You will probably need a [Powerline-patched font][patching] for this to work.
[I recommend picking one of these][fonts].
This theme is based loosely on [agnoster][agnoster].
##### Features
* A helpful, but not too distracting, greeting.
* A subtle timestamp hanging out off to the right.
* Powerline-style visual hotness.
* More colors than you know what to do with.
* An abbreviated path which doesn't abbreviate the name of the current project.
* All the things you need to know about Git in a glance.
* Visual indication that you can't write to the current directory.
##### The Prompt
* Flags:
* Previous command failed (`!`)
* Background jobs (`%`)
* You currently have superpowers (`$`)
* `User@Host` (unless you're the default user)
* Current RVM or rbenv (Ruby) version
* Current virtualenv (Python) version
* _If you use virtualenv, you will probably need to disable the default virtualenv prompt, since it doesn't play nice with fish: `set -x VIRTUAL_ENV_DISABLE_PROMPT 1`_
* Abbreviated parent directory
* Current directory, or Git or Mercurial project name
* Current project's repo branch (<img width="16" alt="branch-glyph" src="https://cloud.githubusercontent.com/assets/53660/8768360/53ee9b58-2e32-11e5-9977-cee0063936fa.png"> master) or detached head (`➦` d0dfd9b)
* Git or Mercurial status, via colors and flags:
* Dirty working directory (`*`)
* Untracked files (`…`)
* Staged changes (`~`)
* Stashed changes (`$`)
* Unpulled commits (`-`)
* Unpushed commits (`+`)
* Unpulled _and_ unpushed commits (`±`)
* _Note that not all of these have been implemented for hg yet :)_
* Abbreviated project-relative path
##### Configuration
You can override some default options in your `config.fish`:
```fish
set -g theme_display_git no
set -g theme_display_git_untracked no
set -g theme_display_git_ahead_verbose yes
set -g theme_display_hg yes
set -g theme_display_virtualenv no
set -g theme_display_ruby no
set -g theme_display_user yes
set -g default_user your_normal_user
```
[screenshot]: http://i.0x7f.us/bobthefish.png
[patching]: https://powerline.readthedocs.org/en/latest/fontpatching.html
[fonts]: https://github.com/Lokaltog/powerline-fonts
[agnoster]: https://gist.github.com/agnoster/3712874
# budspencer
### Budspencer theme
A theme for the 70s, makes fish even more powerful. It's equipped with a hell
of a lot of nice functions and key bindings to speed up your workflow.
The philosophy behind budspencer theme:
* Delimit the prompt lines clearly to the output.
* Produce output only if it contains relevant information.
* Show useful notifications within the prompt.
* Equip the prompt with toggle commands in order to change its style
interactively.
* Store sessions in order to make frequently used commands quickly accessible.
* Make navigation within the directory tree as easy as possible using
bookmarks and a directory history without duplicates.
* Make histories quickly accessible with menus.
* Don't stress your eyes. Use different colors in dark and bright environments.
#### Demonstration video
[![video][screenshot]](http://vimeo.com/105546618)
#### Requirements
You need an up-to-date fish shell version from [github][fish-git] or a
[nightly build][fish-nightly].
Non standard tools:
* xsel
* wmctrl
* git
* [taskwarrior][taskwarrior] (optional)
* [remind][remind] (optional)
#### Configuration
##### General configuration
The theme behaves similar to vim's airline/powerline plugins. Thus, it needs a
[powerline font][font].
It's also crucial to have vi mode enabled. Thus, execute
```
set -U fish_key_bindings fish_vi_key_bindings
```
before enabling the theme.
##### Colors
Redefine `$budspencer_colors` with the `set` command in order to change the
colors of the prompt.
Example:
```
set budspencer_colors 000000 333333 666666 ffffff ffff00 ff6600 ff0000 ff0033 3300ff 0000ff 00ffff
00ff00
```
will result in a prompt like this:
![color replace example][colors]
Two color schemes for bright and dark environments are predefined. You can
enable them with `day` and `night`, respectively.
##### Command history
Commands that shouldn't appear in the command history are defined by a universal
list `$budspencer_nocmdhist`. Default:
```
set -U budspencer_nocmdhist c d ll ls m s
```
##### Disable/reenable greeting
Disable:
```
set -U budspencer_nogreeting
```
Reenable:
```
set -e budspencer_nogreeting
```
#### Outer prompt segments
- Vi mode is indicated by color of outer segments, cursor color also changes
if terminal supports it:
* blue: NORMAL mode
* yellow: INSERT mode
* magenta: VISUAL mode
#### Left prompt segments
- Prompt line number
- Git repository information
- Status symbols
* ✻: keep track of this shell session, can be toggled with `#` to show the number of
the session within the sessions list
* ⌘: present working directory is in bookmark list, can be toggled with `#` to
show the number of the bookmark
* V: vi is parent process
* R: [ranger][ranger] is parent process
* ⚙: there are background jobs, can be toggled with `#` to show the amount of
background jobs
* : no write permissions in present working directory
* ⚔: there are tasks scheduled for this week, can be toggled with `#` to
show the amount of weekly tasks
* ⚑: there are appointments for today, can be toggled with `#` to
show the amount of appointments
* ✔: last command succeeded, can be toggled with `#` to show the status value
* ✘: last command failed, can be toggled with `#` to show the status value
* ⚡: superuser indicator
- Present working directory
- Active Python [virtual environment](https://virtualenv.pypa.io/en/latest/). Requires [Virtual Fish](https://github.com/adambrenecki/virtualfish/)
#### Right prompt segments
- Last command's duration time
- Git status symbols:
* ↑: git repository is ahead origin
* ↓: git repository is behind origin
* +: changes have been added to git index
* : files have been deleted in work tree
* ✱: files have been modified in work tree
* →: files have been renamed in git index
* ═: there are unmerged commits
* ●: there are untracked (new) files
* ✭: there are stashed commits
#### Toggle prompt segments
The following shortcuts need vi-mode:
- Style of "present working directory"-segment can be toggled in NORMAL and in
VISUAL mode with space bar
* styles implemented:
- `short` (shows username, short hostname and truncated path; recommended in
most cases)
- `long` (shows username, full hostname and full path; useful for copy-paste
in ssh connections)
- `none` (shows nothing except small delimiter; useful for small terminals)
- If prompt is toggled with `#`, the IP address is shown instead of the
hostname.
* configurable by universal list `$budspencer_pwdstyle` (if not set, defaults to
`short long none`); note that changes to `$budspencer_pwdstyle` keep persistant as it's
a universal variable.
![pwd style][pwdstyle]
- Style of symbols can be toggled in NORMAL and in VISUAL mode with `#`
* styles implemented:
- `symbols` (shows status symbols)
- `numbers` (shows numbers instead of symbols in left prompt as well as amount of changes in
right git prompt)
Note, the format is _username@hostname:pathname_. Thus, you can cut
the whole string with your mouse and paste it into `ssh` commands.
#### Quickly navigate in history of working directories
The function `d` drops down a menu showing the history as enumerated list. Unlike
fish's builtin `dirh`, `d` does not show any duplicates. Enter a number to jump
to a directory within the list.
![dir menu][dirmenu]
The following shortcuts need vi-mode:
- Press `H` in NORMAL mode to change present working directory to previous
working directory in history.
- Press `L` in NORMAL mode to change present working directory to next working
directory in history.
#### Quickly navigate in command history
The function `c` drops down a menu showing the command history as enumerated list similarly to
the `d` function. Selections are also pasted into the X clipboard. It's possible
to load a command of a former prompt by giving the prompt line number as
argument.
#### Bookmarks
A bookmark can be created with `mark`. It can be removed with `unmark`.
Bookmarks are universal and thus persistant.
A new shell automatically changes working directory on startup to newest bookmark.
`m` is a function that drops down a menu showing the bookmarks as enumerated list
equivalently to `d`.
The following shortcuts need vi mode:
- Create a bookmark for present working directory with `m` in NORMAL mode.
- Remove a bookmark for present working directory with `M` in NORMAL mode.
#### Edit commandline with your favorite editor
The function `edit-commandline` let you edit the commandline with your editor.
It makes the commandline as powerful as your editor. If `$EDITOR` is not set,
vi is used.
The following shortcut needs vi mode:
- Type `.` in NORMAL mode to edit commandline in editor.
#### Sessions
Shell session can be stored with `s <session name>`. If a session with `session
name` already exists, the session with this name will be attached. If a session with
`session name` is already active within another terminal, this terminal will be
focussed.
A list of available sessions can be shown with `s`.
A session can be erased with `s -e <session name>`.
Type `s -d` to detach current session.
#### Set window title
Just type `wt <title>`.
#### TODO
- vi REPLACE mode, as soon as REPLACE mode is implemented within fish
#### Feedback
Give me feedback if you ...
* ... have ideas how I could improve budspencer.
* ... have problems with budspencer.
* ... have questions concerning budspencer.
[font]: https://github.com/Lokaltog/powerline-fonts
[ranger]: http://ranger.nongnu.org/
[taskwarrior]: http://taskwarrior.org/
[remind]: http://www.roaringpenguin.com/products/remind
[fish-git]: https://github.com/fish-shell/fish-shell.git
[fish-nightly]: https://github.com/fish-shell/fish-shell/wiki/Nightly-builds
[screenshot]: https://raw.githubusercontent.com/tannhuber/media/master/budspencer.jpg
[colors]: https://raw.githubusercontent.com/tannhuber/media/master/budspencer_replace_colors.jpg
[dirmenu]: https://raw.githubusercontent.com/tannhuber/media/master/budspencer_dir_menu.jpg
[pwdstyle]: https://raw.githubusercontent.com/tannhuber/media/master/budspencer_pwd_style.jpg
# cbjohnson
#### cbjohnson theme
A minimal theme forked from the [yimmy][yimmy-commit] theme (thanks [jhillyerd][yimmy-author]!)
![screenshot](https://cloud.githubusercontent.com/assets/4823640/5327427/6f9e61bc-7d02-11e4-9223-38ddbed176c8.png)
[yimmy-commit]: https://github.com/bpinto/oh-my-fish/tree/3a4b7de689cabf3522227f51177a489d915c8b4d/themes/yimmy
[yimmy-author]: https://github.com/jhillyerd
# clearance
### Fish Theme: clearance
A minimalist [fish shell](http://fishshell.com/) theme for people who use git
![clearance theme](https://raw.github.com/cseelus/clearance-fish/master/clearance-fish_preview.png)
#### Like it?
Check out other versions of this theme for OSX Terminal or VIM!
# cmorrell
### Chris Morrell's Fish Theme
This is a theme I designed for myself but have given to a few friends and decided to publish for others' enjoyment.
![Chris Morrell's Fish Theme](https://cloud.githubusercontent.com/assets/21592/4770904/8a58e026-5b89-11e4-927c-42a387b41df0.gif)
#### Features
- Minimal base prompt
- Shows compact git status w/ the number of changed files & current branch
- Gives a visual indication when you're logged in via SSH, or logged in as anyone
but the default user (set the `$default_user` variable to define your default user)
- Shows indicator if previous command failed
- Shows a bright red "!" if you're logged in as root
(Note: _This theme is designed for a light-on-dark theme like [Solarized](http://ethanschoonover.com/solarized) but should work in a dark-on-light terminal with a few terminal color tweaks_)
# coffeeandcode
### Fish Theme: coffeeandcode
Another theme choice for Oh-My-Fish! originally created by
[Jonathan Knapp](http://jonknapp.com).
![coffeeandcode](https://cloud.githubusercontent.com/assets/1272018/5966170/e846c75e-a7f9-11e4-8aeb-ebec4c974f5b.png)
##### Warning:
This theme will overwrite all of your Fish color and git settings. If you'd like
to customize them, you will have to make changes to the `fish_prompt.fish` file
in this theme. All of the settings are listed at the top of the file.
# cor
#### cor
The name says it all
![cor theme](https://f.cloud.github.com/assets/516068/692075/a30d9080-dbf6-11e2-8dd3-d07cce41259d.png)
For this theme you need a emoji supporting terminal and the emoji-clock plugin
* emoji-clock
* Git
* Unicode-compatible fonts and terminals (I use iTerm2 on OSX)
###### Characteristics
####### Left side prompt
* If the previous command failed (✘)
* User @ Hostname
* Abbriviated path
* Emoji-clock
####### Right side prompt
* Branch
* Git status clean dirty (*)
* Time of last command
# dangerous
### Dangerous theme
A theme for the 70s, makes fish even more powerful. It's equipped with a hell
of a lot of nice functions and key bindings to speed up your workflow.
The philosophy behind dangerous theme:
* Delimit the prompt lines clearly to the output.
* Produce output only if it contains relevant information.
* Show useful notifications within the prompt.
* Equip the prompt with toggle commands in order to change its style
interactively.
* Store sessions in order to make frequently used commands quickly accessible.
* Make navigation within the directory tree as easy as possible using
bookmarks and a directory history without duplicates.
* Make histories quickly accessible with menus.
* Don't stress your eyes. Use different colors in dark and bright environments.
#### Screenshot
![screenshot][screenshot]
#### Requirements
You need an up-to-date fish shell version from [github][fish-git] or a
[nightly build][fish-nightly].
Non standard tools:
* xsel
* wmctrl
* git
* [taskwarrior][taskwarrior] (optional)
* [remind][remind] (optional)
#### Configuration
##### General configuration
It's crucial to have vi mode enabled. Thus, execute
```
set -U fish_key_bindings fish_vi_key_bindings
```
before enabling the theme.
##### Colors
Redefine `$dangerous_colors` with the `set` command in order to change the
colors of the prompt.
Example:
```
set dangerous_colors 000000 333333 666666 ffffff ffff00 ff6600 ff0000 ff0033 3300ff 0000ff 00ffff
00ff00
```
Two color schemes for bright and dark environments are predefined. You can
enable them with `day` and `night`, respectively.
##### Command history
Commands that shouldn't appear in the command history are defined by a universal
list `$dangerous_nocmdhist`. Default:
```
set -U dangerous_nocmdhist c d ll ls m s
```
##### Disable/reenable greeting
Disable:
```
set -U dangerous_nogreeting
```
Reenable:
```
set -e dangerous_nogreeting
```
#### Outer prompt segments
- Vi mode is indicated by color of outer segments, cursor color also changes
if terminal supports it:
* blue: NORMAL mode
* yellow: INSERT mode
* magenta: VISUAL mode
#### Left prompt segments
- Prompt line number
- Git repository information
- Status symbols
* ✻: keep track of this shell session, can be toggled with `#` to show the number of
the session within the sessions list
* ⌘: present working directory is in bookmark list, can be toggled with `#` to
show the number of the bookmark
* V: vi is parent process
* R: [ranger][ranger] is parent process
* ⚙: there are background jobs, can be toggled with `#` to show the amount of
background jobs
* : no write permissions in present working directory
* ⚔: there are tasks scheduled for this week, can be toggled with `#` to
show the amount of weekly tasks
* ⚑: there are appointments for today, can be toggled with `#` to
show the amount of appointments
* ✔: last command succeeded, can be toggled with `#` to show the status value
* ✘: last command failed, can be toggled with `#` to show the status value
* ⚡: superuser indicator
- Present working directory
#### Right prompt segments
- Last command's duration time
- Git status symbols:
* ↑: git repository is ahead origin
* ↓: git repository is behind origin
* +: changes have been added to git index
* : files have been deleted in work tree
* ✱: files have been modified in work tree
* →: files have been renamed in git index
* ═: there are unmerged commits
* ●: there are untracked (new) files
* ✭: there are stashed commits
#### Toggle prompt segments
The following shortcuts need vi-mode:
- Style of segments can be toggled in NORMAL and in VISUAL mode with space bar
* styles implemented for present working directory segment:
- `short` (shows username, short hostname and truncated path; recommended in
most cases)
- `long` (shows username, full hostname and full path; useful for copy-paste
in ssh connections)
- `none` (shows nothing except small delimiter; useful for small terminals)
- If prompt is toggled with `#`, the IP address is shown instead of the
hostname.
* configurable by universal list `$dangerous_pwdstyle` (if not set, defaults to
`short long none`); note that changes to `$dangerous_pwdstyle` keep persistant as it's
a universal variable.
* The other segments are hidden in case `$pwd_style` is `none`.
- Style of symbols can be toggled in NORMAL and in VISUAL mode with `#`
* styles implemented:
- `symbols` (shows status symbols)
- `numbers` (shows numbers instead of symbols in left prompt as well as amount of changes in
right git prompt)
Note, the format is _username@hostname:pathname_. Thus, you can cut
the whole string with your mouse and paste it into `ssh` commands.
#### Quickly navigate in history of working directories
The function `d` drops down a menu showing the history as enumerated list. Unlike
fish's builtin `dirh`, `d` does not show any duplicates. Enter a number to jump
to a directory within the list.
The following shortcuts need vi-mode:
- Press `H` in NORMAL mode to change present working directory to previous
working directory in history.
- Press `L` in NORMAL mode to change present working directory to next working
directory in history.
#### Quickly navigate in command history
The function `c` drops down a menu showing the command history as enumerated list similarly to
the `d` function. Selections are also pasted into the X clipboard. It's possible
to load a command of a former prompt by giving the prompt line number as
argument.
#### Bookmarks
A bookmark can be created with `mark`. It can be removed with `unmark`.
Bookmarks are universal and thus persistant.
A new shell automatically changes working directory on startup to newest bookmark.
`m` is a function that drops down a menu showing the bookmarks as enumerated list
equivalently to `d`.
The following shortcuts need vi mode:
- Create a bookmark for present working directory with `m` in NORMAL mode.
- Remove a bookmark for present working directory with `M` in NORMAL mode.
#### Edit commandline with your favorite editor
The function `edit-commandline` lets you edit the commandline with your editor.
It makes the commandline as powerful as your editor. If `$EDITOR` is not set,
vi is used.
The following shortcut needs vi mode:
- Type `.` in NORMAL mode to edit commandline in editor.
#### Sessions
Shell session can be stored with `s <session name>`. If a session with `session
name` already exists, the session with this name will be attached. If a session with
`session name` is already active within another terminal, this terminal will be
focussed.
A list of available sessions can be shown with `s`.
A session can be erased with `s -e <session name>`.
Type `s -d` to detach current session.
#### Set window title
Just type `wt <title>`.
#### TODO
- vi REPLACE mode, as soon as REPLACE mode is implemented within fish
#### Feedback
Give me feedback if you ...
* ... have ideas how I could improve dangerous.
* ... have problems with dangerous.
* ... have questions concerning dangerous.
[ranger]: http://ranger.nongnu.org/
[taskwarrior]: http://taskwarrior.org/
[remind]: http://www.roaringpenguin.com/products/remind
[fish-git]: https://github.com/fish-shell/fish-shell.git
[fish-nightly]: https://github.com/fish-shell/fish-shell/wiki/Nightly-builds
[screenshot]: https://raw.githubusercontent.com/tannhuber/media/master/dangerous.gif
# default
<div align="center">
<a href="http://github.com/fish-shell/omf">
<img width=90px src="https://cloud.githubusercontent.com/assets/8317250/8510172/f006f0a4-230f-11e5-98b6-5c2e3c87088f.png">
</a>
</div>
<br>
> Default theme for [Oh My Fish][omf-link].
#### Install
```fish
$ omf theme default
```
#### Features
* All the things you need to know about Git in a glance.
* A subtle timestamp hanging out off to the right.
* Previous command status.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/526122/9604024/ac338638-50ac-11e5-874a-70fa9287db93.png">
</p>
#### Configuration
Only display the folder name:
```
set -g theme_short_path yes
```
### License
[MIT][mit] © [bpinto][author] et [al][contributors]
[mit]: http://opensource.org/licenses/MIT
[author]: http://github.com/bpinto
[contributors]: https://github.com/oh-my-fish/theme-default/graphs/contributors
[omf-link]: https://www.github.com/fish-shell/oh-my-fish
[license-badge]: https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square
[travis-badge]: http://img.shields.io/travis/oh-my-fish/theme-default.svg?style=flat-square
[travis-link]: https://travis-ci.org/oh-my-fish/theme-default
# eclm
#### eclm
Based on the robbyrussell theme.
![eclm theme](https://raw.githubusercontent.com/oh-my-fish/theme-eclm/master/screenshot.png)
###### Characteristics
* Displays git information in the command prompt when available.
* Indicates 'master' branch with a distinctive color, encouraging the use of feature-branches (useful when development is done using pull requests)
* If the last command was failed, the indicator would be red, otherwise it's green
# edan
#### Theme Edan
Inspired by idan, a functional, uncluttered fish theme with usability perks for git users and python developers.
![Screenshot of theme Edan](https://cloud.githubusercontent.com/assets/215282/6199938/f67e6a54-b49a-11e4-800b-587a638cfb86.png)
###### Characteristics
####### Left Prompt
* User & host (Shown in "remote" mode, hidden by default. Execute `edan-set-remote` or `edan-set-local` to switch.)
* Current python virtualenv (if applicable)
* Truncated CWD (just the current folder name)
* Git branch and dirty state (if applicable)
####### Right Prompt
* Full CWD path
* Last error code (if applicable)
###### Font
Check out [Anonymous Pro](http://www.marksimonson.com/fonts/view/anonymous-pro).
# fishface
#### FishFace
Shows an ASCII fish which is blue or green when in a git repo.
![fishface theme](https://f.cloud.github.com/assets/66143/1224622/ec9660d8-2750-11e3-9c96-cb7a5a69eada.png)
# fishy-drupal
#### fishy-drupal
![fishy-drupal](https://raw.github.com/greggles/fishy-drupal/master/drups-fish-theme.png)
###### Features
* Shows the present working directory, abbreviated (default fish style)
* Shows the active git branch, if any
* Shows the active drush site alias, if any
* Shows yellow ✗ if the current git directory is "dirty"
# fisk
### Fisk
![theme screenshot](https://cloud.githubusercontent.com/assets/20814/6209746/60949aa6-b5c9-11e4-8edc-5a8e370f4527.png)
A nice dark blue-green theme with support for:
- Last exit code
- Current git HEAD
- Current python virtualenv
By [joar](https://github.com/joar), thanks to
[adisbladis](https://github.com/adisbladis) for the starting point.
# flash
[![](https://img.shields.io/badge/Themes-Wahoo-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-707070.svg?style=flat-square)
### :zap: _Flash_
> Theme for [Fishshell](fishshell.com) inspired by the Flash.
#### Features
_From left to right:_
+ `$HOME` directory abbreviated to `( ⌁ )`
+ `/` root is diplayed as `( / )`
+ `$HOME` and `/` characters change color to dim gray if last `$status` was `!=` 0.
+ Path to current working directory is abbreviated.
+ Path and prompt separator is displayed as `)`.
+ `<` character next to `(branch)` denotes the repository has [_stashed_](https://git-scm.com/book/no-nb/v1/Git-Tools-Stashing) changes.
+ `*` next to the branch name denotes the current repository is dirty.
+ Display current branch.
+ Display current time.
+ Time separator `:` changes color to red if last `$status` was `!=` 0.
+ Display exit status for non zero codes after `≡` character.
+ _Flash_ inspired colors.
+ Display the number of seconds taken by the last command executed.
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/7787589/431f2efa-024f-11e5-9715-df3e1833e174.png">
</p>
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/7787558/fb091794-024d-11e5-815b-cf3b6b2e5217.png">
</p>
### License
> __Disclaimer:__ This work is not intended to infringe on any rights by and of the companies and/or individuals involved in the production of any series mentioned here. I don't own the Flash.
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/batman/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# fox
#### fox
cloned from oh-my-zsh.
![fox theme](http://i60.tinypic.com/2myaibn.jpg)
# gianu
#### Gianu
Original theme made by [gianu](https://github.com/gianu) for oh-my-zsh, converted to oh-my-fish by [JBarberU](https://github.com/JBarberU)
![gianu theme](https://cloud.githubusercontent.com/assets/1499062/5955321/114b64d2-a7a2-11e4-8732-e8cf06903314.png)
###### Characteristics
Displays:
* Username and hostname
* Working directory
* Git information when available.
# gitstatus
#### GitStatus
![GitStatus](https://github.com/godfat/fish_prompt-gitstatus/raw/master/gitstatus.png)
###### Characteristics
* Displays host information in the command prompt when connected via ssh.
* Displays git information in the command prompt when inside a git repository.
- Shows current branch name.
- Shows * if working copy is dirty.
- Shows # if everything is staged.
- Shows no indicators if the working copy is clean.
# gnuykeaj
### Fish Theme: gnuykeaj
Super minimal one line version of [clearance](https://github.com/bpinto/oh-my-fish/tree/master/themes/clearance) theme. Balance between need to know information and space. Has git branch and dirty state information based on the color of the branch name.
![gnuykjeatheme](https://raw.githubusercontent.com/andyklimczak/oh-my-fish/gnuykeaj-screenshot/themes/gnuykeaj/gnuykeaj-preview.png)
# godfather
#### godfather fish theme
Clean git theme with homey feel and git-centric features.
![screenshot](http://i.imgur.com/mh7a39d.png)
###### Prompt structure:
* Left-hand side:
* user@host:
* truncated cwd (just the current folder name)
* git branch with state info (if applicable)
* Right-hand side:
* last error code (if applicable)
* [timestamp]
###### Credits:
Colors and git functions taken from [amio](https://github.com/amio)'s
[edan](https://github.com/bpinto/oh-my-fish/tree/master/themes/edan) theme.
# hogan
[![](https://img.shields.io/badge/Wahoo-Theme-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-707070.svg?style=flat-square)
### :hurtrealbad: _Hogan_
> [Fishshell](fishshell.com) Theme.
#### Features
> Use the [powerline patched fonts](https://github.com/powerline/fonts) for best results.
+ Powerline displaying current path segments and git status.
+ `git` status segment becomes pink if the repository is touched / dirty.
+ Directory segments become red if `$status` is non-zero.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/8264402/9061d7f4-1720-11e5-8ba8-dd150a6f7c6f.png">
</p>
### License
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/batman/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# hulk
[![](https://img.shields.io/badge/Themes-Wahoo-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-33CC33.svg?style=flat-square)
### :anger: _Hulk_
> Theme for [Fishshell](fishshell.com) inspired by The Hulk
#### Features
_From left to right:_
+ Display current time.
+ `$HOME` directory abbreviated to an uppercase gamma symbol [``](http://en.wikipedia.org/wiki/Hulk_%28comics%29#Fictional_character_biography)
+ Colors change to _red_ to denote the last `$status` code was `!=` 0.
+ Path to current working directory is abbreviated.
+ Display current branch.
+ A _green_ colored branch name denotes the repository is dirty.
+ `/` root is diplayed as `≡`
+ Colors inspired by The Hulk.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/7789765/4638cea8-02a8-11e5-85da-5b8b13d59568.png">
</p>
### License
> __Disclaimer:__ This work is not intended to infringe on any rights by and of the companies and/or individuals involved in the production of any series mentioned here. I don't own the Hulk.
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/batman/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# idan
#### idan
A functional, uncluttered fish theme with usability perks for git users and python developers.
![Screenshot of idan theme](https://f.cloud.github.com/assets/22723/544512/14b7cd6e-c251-11e2-82c0-d5b4f41581c7.png)
###### Characteristics
####### Left Prompt
* Current python virtualenv (if applicable)
* Truncated CWD (just the current folder name)
* Git branch and dirty state (if applicable)
####### Right Prompt
* Full CWD path
* Last error code (if applicable)
# integral
#### integral
A simple git upstream theme.
###### Characteristics
* Current branch
* Dirty working directory
* Working directory
* Git upstream status
###### Screenshot
![Integral Screenshot](https://cloud.githubusercontent.com/assets/21774/2715353/70af1520-c50a-11e3-9db3-74933fbb8d91.png)
# jacaetevha
#### jacaetevha
A theme optimized for people who use:
* Git
* Unicode-compatible fonts and terminals (I use iTerm2 + Monaco)
For Mac users, I highly recommend iTerm 2.
![jacaetevha
theme](http://jacaetevha.github.io/oh-my-fish/screenshot.png)
###### Characteristics
* Left-hand prompt:
```
<user> at <host> in <abbreviated path> <total size of files in dir> (<current Git branch>)
```
* Right-hand prompt:
```
<current date>
```
# krisleech
#### krisleech
A very simple theme optimized for Git. Less is more.
![krisleech theme](https://f.cloud.github.com/assets/66143/930316/732ea576-0008-11e3-964c-98410709d00c.png)
![krisleech theme](https://f.cloud.github.com/assets/66143/930317/73446046-0008-11e3-8ecb-2abec0058b83.png)
##### Characteristics
* Current working directory
* Branch name
* Dirty working directory (✘)
# l
<div align="center">
<a href="http://github.com/fish-shell/omf">
<img width=90px src="https://cloud.githubusercontent.com/assets/8317250/8510172/f006f0a4-230f-11e5-98b6-5c2e3c87088f.png">
</a>
</div>
<br>
> A theme inspired by [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh/blob/master/themes/lambda.zsh-theme)'s [lambda](http://zshthem.es/screenshots/lambda.png) theme.
#### Install
```fish
$ omf theme l
```
#### Features
* Current branch
* Dirty working directory
* Working directory
#### Screenshot
<p align="center">
<img src="http://f.cl.ly/items/2J3M0f2X1j3u471y080I/2.png">
<img src="hhttp://f.cl.ly/items/2S25360U1p360E0D2u2g/3.png">
<img src="http://f.cl.ly/items/1w0s0Q3x3r2Z1F1l011k/4.png">
</p>
#### Configuration
Only if fish_theme_l_right_prompt variable is set true within config.fish:
```fish
set theme_display_rbenv 'yes'
set theme_display_rbenv_gemset 'yes'
### if you want to display rbenv ruby version only within directories that contain Gemfile
set theme_display_rbenv_with_gemfile_only 'yes'
```
* Rbenv Ruby Version
* Rbenv Ruby Gemset
<p align="center">
<img src="http://f.cl.ly/items/0f0k3o2L3y2q1L3g1R1X/5.png">
</p>
### License
[MIT][mit] © [bpinto][author] et [al][contributors]
[mit]: http://opensource.org/licenses/MIT
[author]: http://github.com/bpinto
[contributors]: https://github.com/oh-my-fish/theme-default/graphs/contributors
[omf-link]: https://www.github.com/fish-shell/oh-my-fish
[license-badge]: https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square
[travis-badge]: http://img.shields.io/travis/oh-my-fish/theme-default.svg?style=flat-square
[travis-link]: https://travis-ci.org/oh-my-fish/theme-default
# led
[![](https://img.shields.io/badge/Themes-Wahoo-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-33CC33.svg?style=flat-square)
### _led_
> Theme for [Fishshell](fishshell.com) inspired by [leds](https://en.wikipedia.org/wiki/Light-emitting_diode).
#### Features
+ Basic git info in command prompt.
+ Display `×` and `✓` next to git branch to indicate touched status.
+ Right prompt shows upstream info `^`, `v` or `^v` or ahead, behind and diverged respectively.
+ Prompt `⸧` arrow, path separator `/` and right prompt becomes red if the last command failed.
+ Battery Indicator if [battery](https://github.com/bucaran/wa-battery) plugin is installed.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/8145923/d324eb80-1257-11e5-98e6-48518b738941.png">
</p>
### License
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/wahoo/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# mtahmed
#### mtahmed
Minimal theme.
![mtahmed](https://cloud.githubusercontent.com/assets/1272018/5965709/13d07f68-a7f6-11e4-9872-7936516ba258.png)
###### Left prompt
- First 10 characters of hostname if `ssh`'ed
- Current directory name (not path)
- ─╼ (cute little unicode characters)
###### Right prompt
- Exit code of the previous command
# nai
#### nai
A minimalist fish theme which displays git branch and status information.
![nai](https://cloud.githubusercontent.com/assets/1272018/5961225/116d0a7a-a7d3-11e4-88a6-43da003ddc6c.png)
###### Characteristics
####### Left Prompt
* Truncated CWD (just the current folder name)
* Git branch and dirty state (if applicable)
# nelsonjchen
<div align="center">
<a href="http://github.com/oh-my-fish/oh-my-fish">
<img width=90px src="https://cloud.githubusercontent.com/assets/8317250/8510172/f006f0a4-230f-11e5-98b6-5c2e3c87088f.png">
</a>
</div>
<br>
> nelsonjchen theme for [Oh My Fish][omf-link]. Based on re5et in Oh-My-Zsh.
#### Install
```fish
$ omf u nelsonjchen
```
#### Features and Differences
* Pretty colors
* Two line prompt
* Git Prompt using off-the-shelf fish functions
* Note that the symbology, colors, and features are more than the `zsh` version and they don't match up 1-to-1. For example, checking out a tag will show the tag name in `fish` but the re5et version in `zsh` will simply show the commit ID. This was one such freebie amongst many I just left in while porting since the `fish` script was giving it to me for free anyway. It is still pretty close though.
* Red user prompt if `root`
* 12 hour clock
* re5et: 24 hour clock
* MM DD YY date format
* re5et: YY MM DD date format
#### Omissions from the re5et version
* Trimming down the working directory display only works on `~`. The original re5et prompt would also trim based on the current environment variables set. For example, if you had the environment variable `FOO` set to `/usr/local` and you did `cd /usr/local`, you would see `$FOO/` in the prompt as the current working directory. I'm not sure how I would get this working. `fish` does appear to have a condensation function but it goes beyond simple environment variable replacement and I can't figure out how to turn it off.
#### Screenshot
<p align="center">
<img src="nelsonjchen.png">
</p>
### License
[MIT][mit] © [Nelson Chen][author] et [al][contributors]
[mit]: http://opensource.org/licenses/MIT
[author]: http://github.com/nelsonjchen
[contributors]: https://github.com/nelsonjchen/omf-theme-nelsonjchen/graphs/contributors
[omf-link]: https://www.github.com/oh-my-fish/oh-my-fish
[license-badge]: https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square
[travis-badge]: http://img.shields.io/travis/nelsonjchen/omf-theme-nelsonjchen.svg?style=flat-square
# numist
See https://github.com/oh-my-fish/theme-numist for details
# ocean
#### ocean
A fish theme with ocean in mind.
![Preview](https://cloud.githubusercontent.com/assets/129920/3533761/4702cc78-07d9-11e4-826f-e9f797e4bfa8.png)
Unicode-compatible fonts and terminals is required.
I would recommend iTerm2 + Solarized Dark for Mac users.
This theme is based loosely on [agnoster](https://gist.github.com/agnoster/3712874)
###### Characteristics
* Show a radioactive symbol (☢) when gain the root privileges (It's dangerous!)
* Current python virtualenv (if applicable)
* The anchor (⚓) turns red if the previous command failed
* Full path of current working directory
* Show the Git branch and dirty state (if applicable)
* Show **User@Hostname** if user is not the default user. Set the following two lines in your config.fish to turn on this feature:
```fish
set -g theme display_user yes
set -g default_user your_default_username
```
###### Troubleshooting in iTerm
If you see a colored anchor icon instead of the white one, this is because your system font is lacking the anchor icon, and iTerm defaults to the Apple Emoji Font. To get the right icon, either add it to your current font, or chose a powerline font that has it (like Meslo for Powerline, available in https://github.com/powerline/fonts), and select it for your Non-ASCII font.
# perryh
#### perryh
This is similar to godfat's gitstatus theme, but mainly includes red, white, cyan, and yellow.
![perryh](http://perryhuang.com/stuff/perryh_fish.png)
# red-snapper
### RED SNAPPER
![Red Snapper](https://raw.githubusercontent.com/ZuraGuerra/theme-red-snapper/master/redsnapper.jpg)
####><}}*> F E A T U R E S
+ Directory path
+ Git branch name
+ Git status
+ YOUR OWN PET FISH!
####><}}*> GIT STATUS
##### Untracked changes
Your pet will detect if you added files, but didn't track them. He will open his mouth, hungry of yummy commits!
![fish shell untracked changes](https://raw.githubusercontent.com/ZuraGuerra/theme-red-snapper/master/hungry2.png)
After you commit, he will close his mouth, satiated.
![fish shell commited](https://raw.githubusercontent.com/ZuraGuerra/theme-red-snapper/master/fed.png)
##### Can't find .git
Something is fishy here! If you are not inside a Git working directory, your pet will go to sleep.
![fish shell not using git](https://raw.githubusercontent.com/ZuraGuerra/theme-red-snapper/master/fishy.png)
# robbyrussell
#### robbyrussell
The default theme cloned from oh-my-zsh.
![robbyrussell theme](https://bachue.github.io/oh-my-fish/images/robbyrussell-screenshot.png)
###### Characteristics
* Displays git information in the command prompt when available.
* If the last command was failed, the indicator would be red, otherwise it's green
# russell
[![](https://img.shields.io/badge/Themes-Wahoo-00b0ff.svg?style=flat-square)][Wahoo]
![](https://img.shields.io/badge/License-MIT-33CC33.svg?style=flat-square)
### _russel_
> Theme for [Fishshell](fishshell.com) based in the original [__bobbyrussel__](https://github.com/robbyrussell/oh-my-zsh/wiki/themes#robbyrussell).
#### Features
+ Show basic git info in command prompt.
+ Display a yellow `✗` if the repository is touched.
+ Prompt `➜` arrow becomes red if the last command failed.
#### Screenshot
<p align="center">
<img src="https://cloud.githubusercontent.com/assets/8317250/8118075/014a0036-10c8-11e5-90bb-db2226633489.png">
</p>
### License
[MIT](http://opensource.org/licenses/MIT) © [Jorge Bucaran][Author] et [al](https://github.com/bucaran/wahoo/graphs/contributors)
[Author]: http://about.bucaran.me
[Wahoo]: https://github.com/bucaran/wahoo
# scorphish
#### Scorphish
Compact. Sufficient.
![scorphish](https://cloud.githubusercontent.com/assets/2112697/7443483/01d3dd56-f124-11e4-91c3-72a93fbc0dda.png)
###### Left prompt
Abbreviated path, ruby version, virtualenv and git info
###### Right prompt
Last command's exit code and current time
###### Acknowledgments
This theme is based on Zish and Coffeandcode themes, many thanks to their authors!
Enjoy!
# simplevi
fish_prompt-simplevi
The stock prompt with the vi indicator appended.
It is meant to be used with the `vi-mode` plugin.
Screenshots:
![normal mode](https://raw.github.com/syl20bnr/fish_prompt-simplevi/master/prompt_fish-simplevi-n.png)
![insert mode](https://raw.github.com/syl20bnr/fish_prompt-simplevi/master/prompt_fish-simplevi-i.png)
# syl20bnr
### syl20bnr theme
A semi-compact oh-my-fish theme with [nice support for git](#git).
The theme has been tested on `Ubuntu 14.04 (Trusty)` and `Mac OS X 10.10 (Yosemite)`.
It is also compatible with [Cygwin with the appropriate packages](#cygwin-compatibility).
**Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)*
- [Segments](#segments)
- [pwd: Compact current working directory](#pwd-compact-current-working-directory)
- [Examples](#examples)
- [git](#git)
- [Examples](#examples-1)
- [vi-mode](#vi-mode)
- [end](#end)
- [where](#where)
- [Functions](#functions)
- [Mac compatibility](#mac-compatibility)
- [Cygwin compatibility](#cygwin-compatibility)
#### Segments
##### pwd: Compact current working directory
The `pwd` segment format is `X:P(N)` where:
- `X` is either `home` or `/`
- `P` is the current working path base name (name of the current directory)
- `N` is the depth of the path starting from `X`
If the `pwd` is `home` or `/` then the prompt format is simplified to `home`
and `/` respectively without the current directory and depth.
###### Examples
In home directory:
![home](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-home2.png)
Inside a directory in home:
![inside_home](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-inside-home.png)
Outside the home directory:
![outside_home](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-outside-home.png)
##### git
If the current directory is a [git][git] repository then the `pwd` segment is
replaced by the `git` segment (I should know where I am).
The `git` segment format is `X:YI@Z:P(N)` where:
- `X` is `git`
- `Y` is the current branch name
- `I` is some information about the current repository state
- `Z` is the name of the repository
- `P` is the current working path basename (name of the current directory)
If `P` = `Z` then `P(N)` is not displayed
- `N` is the depth of the path starting from base directory of the repository
The displayed information `I` is:
- Unpushed commits are indicated with an up arrow like this `[↑1]`
- Unmerged fetched commits are indicated with a down arrow like this `[↓1]`
**Note:** The dirtiness of the current branch is indicated by its color:
- red: it is dirty
- green: it is up to date
**Note:** The unmerged commits count appears only if the changes in the
upstream branch as been fetched.
###### Examples
Dirty (changes not committed):
![dirty](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-git-dirty2.png)
Unpushed commits:
![unpushed_commits](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-git-unpushed.png)
Unmerged commits:
![unmerged_commits](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-git-unmerged.png)
Both unpushed and unmerged commits:
![unmerged_commits](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-git-unpushed_unmerged.png)
In a sub-directory of the repository:
![repo_subdir](https://raw.githubusercontent.com/syl20bnr/oh-my-fish-theme-syl20bnr/master/screenshots/prompt_fish-syl20bnr-git-subdir2.png)
##### vi-mode
This segment display the current `vi-mode` if the fish native vi mode or
the oh-my-fish vi-mode plugin is used.
See the `[n]` in the previous screenshots.
##### end
The color of the end of the prompt depends on the `$status` value of the
last executed command. It is `green` or `red` depending on the success or
failure of the last command.
Since I often use [ranger][ranger] and its `shift+s` key binding to bring
a new child shell session, there is a discreet indicator when the parent
process of the current shell is a `ranger` process: the end of the prompt
is written twice (ie: `>>` instead of just `>`).
With this indicator I quickly see if I can `ctrl+d` to end the current shell
process and go back to the parent `ranger` process.
##### where
The `where` segment format is `X@Y` where:
- `X` is the user name
- `Y` is the host name
This segment is displayed in the right prompt.
#### Functions
Some functions come with the theme:
- `toggle_right_prompt` will... toggle the right prompt! (alias: `trp`)
#### Mac compatibility
In order to make this theme work correctly with all the features make sure to
install the following packages via MacPorts or Homebrew:
-`pstree` (used in ranger detection)
#### Cygwin compatibility
In order to make this theme work on [Cygwin][cygwin], make sure to install the following
packages:
- `bc` for `math` fish function
- `psmisc` for `pstree` (used in ranger detection)
- `git` if you want to use the `git` segment.
[git]: http://git-scm.com/
[ranger]: http://ranger.nongnu.org/
[cygwin]: http://cygwin.com/
# taktoa
#### taktoa
A theme by taktoa
###### Characteristics
* Shows current git information
* Shows hostname if you are connected via ssh
* Show current terminal multiplexer status (screen/tmux pane name and number)
* Arrow is a lambda
![taktoa theme](http://taktoa.me/oh-my-fish/images/taktoa-screenshot.png)
# technopagan
#### technopagan
A minimalist fish theme forked from theme-nai ([@xorgy](https://github.com/xorgy)) but with added ([@rmillr](https://github.com/rmillr)) moonmoji support.
![technopagan](https://raw.githubusercontent.com/oh-my-fish/theme-technopagan/master/technopagan.png)
Display the following bits on the left:
* Current directory name
* Git branch and dirty state (if inside a git repo)
# toaster
### Toaster
A fish (shell) theme with a poptart cat and a rainbow that signifies git status.
![Toaster in action](https://github.com/steeeve/toaster/raw/master/screenshot.png)
# tomita
<p align="center">
<img src="https://github.com/daveyarwood/tomita/blob/master/img/tomita.jpg?raw=true" alt="source: http://www.isaotomita.net/images/photo/tomi01.jpg" title="isao tomita" />
</p>
### tomita
A minimal, aesthetically pleasing fish theme.
> Note: Make sure you're using a Unicode-enabled terminal and font.
#### Prompt
<abbreviated path> (<current git branch>) [<vi mode>] ⏛
* Working directory
* Current git branch
* vi mode, if the oh-my-fish `vi-mode` plugin is enabled
#### Screenshots
<center>
Without vi-mode:
<a href="https://github.com/daveyarwood/tomita/blob/master/img/1.png?raw=true">
<img src="https://github.com/daveyarwood/tomita/blob/master/img/1.png?raw=true" alt="without vi-mode" />
</a>
With vi-mode:
<a href="https://github.com/daveyarwood/tomita/blob/master/img/2.png?raw=true">
<img src="https://github.com/daveyarwood/tomita/blob/master/img/2.png?raw=true" alt="with vi-mode" />
</a>
In a git repo:
<a href="https://github.com/daveyarwood/tomita/blob/master/img/3.png?raw=true">
<img src="https://github.com/daveyarwood/tomita/blob/master/img/3.png?raw=true" alt="git branch" />
</a>
</center>
# trout
A simple, but informative, prompt
![example](https://raw.githubusercontent.com/phaedryx/trout/master/prompt.png)
# uggedal
#### uggedal
Minimal theme.
![uggedal theme](https://f.cloud.github.com/assets/71/485623/c84ea45a-b8f7-11e2-8f7c-35a836aa7dbe.png)
###### Characteristics
* Only displays the `$CWD`.
* Displays hostname if you're connected through `ssh(1)`.
* Right prompt displays the last command's exit code if it was non-zero.
# will
#### Will
Minimalist theme.
![Screenshot](https://cloud.githubusercontent.com/assets/143746/6462675/60d171fe-c1ab-11e4-9434-8718a2139c79.png)
###### Characteristics
* The current working directory is displayed on the right-side
* Hostnames are displayed if and only if we're on an SSH connection
* Uses logical entailment as the prompt character
# yimmy
#### yimmy theme
A simple two-line theme best displayed on a terminal configured with Solarized
Dark colors.
user@host ~/c/w/dir (branch *)
>
![Screenshot](https://cloud.githubusercontent.com/assets/2502736/3245408/32c42cde-f172-11e3-8ba3-912191222a11.png)
Characteristics:
- Standard fish prompt characters: > for user, # for root
- Uses the fish `prompt_pwd`, so paths will be abbreviated
- Uses built-in `__fish_git_prompt` functionality
- Indicates Git work-in-progress (gwip/gunwip) if detected
- Prompt character is colored red if previous command had a non-zero exit
status
- Includes completmentary `LS_COLORS`
# zish
#### Zish
Zhishen Wen's simple fun theme =)
![zish](https://raw.githubusercontent.com/oh-my-fish/theme-zish/master/./zish_preview.png)
###### Left prompt
User, host, abbreviated path, and git branch info
######Right prompt
Time and exit code
Enjoy!