mirror of
https://github.com/IlanCosman/tide.git
synced 2024-12-18 09:32:18 +03:00
🌊 The ultimate Fish prompt.
conf.d | ||
dev | ||
functions | ||
media | ||
tests | ||
tide_theme | ||
gif.fish | ||
install.fish | ||
LICENSE | ||
README.md |
Tide
Tide is a Fish theme inspired by Powerlevel10k. It aims to provide a powerful, flexible, and out-of-the-box experience.
Installation
Run the install script:
curl -s https://raw.githubusercontent.com/IlanCosman/tide/master/install.fish | source; and tide_install
Features
Multi-Line Right Prompt
Fish cant do that yet can it?
Configuration Wizard
Type tide configure
to open the the wizard in your terminal.
Extensible
If there isn't a prompt item that fits your needs, make your own!
Configuration
All tide variables, unless stated otherwise, begin with the string tide_
. Thus, variables in this section will be denoted as example_variable
but will actually be tide_example_variable
.
General Variables
Name | Description | Default |
---|---|---|
newline | add empty line before each prompt | true |
left_prompt_items | order of the left prompt items to display | 'pwd' 'git_prompt' 'newline' 'prompt_char' |
right_prompt_items | order of the right prompt items to display | 'status' 'cmd_duration' 'context' 'jobs' |
prompt connection
Variable | Description | Default |
---|---|---|
prompt_connection_color | color of prompt connection | 6C6C6C |
prompt_connection_icon | repeated symbol that spans gap between left and right sides of prompt | ' ' |
Prompt Items
Item | Description |
---|---|
cmd_duration | duration of the last run command |
context | user@hostname in ssh or root |
git_prompt | git repository status |
jobs | presence of background jobs |
prompt_char | prompt symbol;turns red on error |
pwd | current directory |
status | exit code of the last command |
time | current time |
cmd_duration
Variable | Description | Default |
---|---|---|
cmd_duration_color | color of cmd_duration output | 87875F |
cmd_duration_decimals | number of decimals to display after seconds place | 0 |
cmd_duration_threshold | number of milliseconds that duration must exceed to produce output | 3000 |
git_prompt
Tide's git capabilities are currently inherited from fish's built-in fish_git_prompt. Modify those variables to configure tide's git prompt.
pwd
Variable | Description | Default |
---|---|---|
pwd_shorten_margin | number of columns distance to maintain between pwd and edge of terminal | 5 |
pwd_unwritable_icon | symbol to display when the current directory is not writable by the user | '' #Lock icon |
status
Variable | Description | Default |
---|---|---|
status_success_icon | symbol to display when the last command in a pipeline succeeds | '✔' |
status_success_color | color of successful pipeline's status | 5FAF00 |
status_failure_icon | symbol to display when the last command in a pipeline fails | '✘' |
status_failure_color | color of failed pipeline's status | D70000 |