Skip to content

Commit

Permalink
Create fish.md
Browse files Browse the repository at this point in the history
  • Loading branch information
alllex authored Dec 30, 2024
1 parent dab8419 commit 06700c9
Showing 1 changed file with 89 additions and 0 deletions.
89 changes: 89 additions & 0 deletions src/content/docs/shells/fish.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
title: Fish Shell
description: Installation and minimal configuration for Fish shell
---

https://github.com/fish-shell/fish-shell

## Installation

macOS:

```sh
brew install fish
```

It's immediately runnable after installation:

```sh
fish
```

### Making it a default

See where Fish is installed (it might be different between macOS versions)

```sh
which fish
/opt/homebrew/bin/fish
```

```sh
echo /opt/homebrew/bin/fish | sudo tee -a /etc/shells
chsh -s /opt/homebrew/bin/fish
```

## Customization

Fish is a shell that is much better equipped by default compared to other shells.

:::tip[Start with an awesome list]
jorgebucaran/awsm.fish: A curation of prompts, plugins & other Fish treasures 🐚💎
https://github.com/jorgebucaran/awsm.fish
:::

### Greeting

Add to `~/.config/config.fish`:

```
# Disable the fish greeting message
set fish_greeting
```

### Plugin management with `Fisher`

[Fisher](https://github.com/jorgebucaran/fisher) seems to be the most popular plugin manager for Fish

```sh
brew install fisher
```

### Prompt customization

[Tide](https://github.com/IlanCosman/tide) is an extensive prompt customization plugin.

It expects a couple of dependencies to be installed first:

- [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts) -- `brew install font-hack-nerd-font`

```sh
fisher install IlanCosman/tide@v6
```

### Plugins

`fzf` integration

```sh
fisher install patrickf1/fzf.fish
```

`z` utility

```sh
fisher install jethrokuan/z
```



0 comments on commit 06700c9

Please sign in to comment.