mirror of
https://github.com/jorgebucaran/fisher
synced 2024-11-05 12:00:17 +00:00
213 lines
4.1 KiB
Markdown
213 lines
4.1 KiB
Markdown
[slack-link]: https://fisherman-wharf.herokuapp.com
|
|
[slack-badge]: https://fisherman-wharf.herokuapp.com/badge.svg
|
|
[travis-link]: https://travis-ci.org/fisherman/fisherman
|
|
[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg
|
|
|
|
[organization]: https://github.com/fisherman
|
|
[fish-shell]: https://github.com/fish-shell/fish-shell
|
|
[fisherman]: http://fisherman.sh
|
|
[online]: http://fisherman.sh/#search
|
|
|
|
[日本語]: docs/jp-JA
|
|
[简体中文]: docs/zh-CN
|
|
[한국어]: docs/ko-KR
|
|
[Русский]: docs/ru-RU
|
|
[Català]: docs/ca-ES
|
|
[Português]: docs/pt-PT
|
|
[Español]: docs/es-ES
|
|
|
|
[![Build Status][travis-badge]][travis-link]
|
|
[![Slack][slack-badge]][slack-link]
|
|
|
|
# [fisherman] - fish plugin manager
|
|
|
|
fisherman is a concurrent plugin manager for [fish-shell].
|
|
|
|
Translations: [日本語], [简体中文], [한국어], [Русский], [Català], [Português], [Español].
|
|
|
|
## Features
|
|
|
|
* Zero configuration
|
|
|
|
* No external dependencies
|
|
|
|
* No impact on shell startup time
|
|
|
|
* Only the essentials, install, update, remove, list and help
|
|
|
|
## Install
|
|
|
|
With curl.
|
|
|
|
```sh
|
|
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
|
|
```
|
|
|
|
## Usage
|
|
|
|
Install a plugin.
|
|
|
|
```
|
|
fisher simple
|
|
```
|
|
|
|
Install from multiple sources.
|
|
|
|
```
|
|
fisher z fzf omf/{grc,thefuck}
|
|
```
|
|
|
|
Install from a URL.
|
|
|
|
```
|
|
fisher https://github.com/edc/bass
|
|
```
|
|
|
|
Install a gist.
|
|
|
|
```
|
|
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
|
|
```
|
|
|
|
Install a local directory.
|
|
|
|
```sh
|
|
fisher ~/my_aliases
|
|
```
|
|
|
|
Edit your [fishfile](#6-what-is-a-fishfile-and-how-do-i-use-it) and run `fisher` to satisfy changes.
|
|
|
|
```sh
|
|
$EDITOR fishfile # add plugins
|
|
fisher
|
|
```
|
|
|
|
See what's installed.
|
|
|
|
```ApacheConf
|
|
fisher ls
|
|
@ my_aliases # this is a local directory
|
|
* simple # this is the current prompt
|
|
bass
|
|
fzf
|
|
grc
|
|
thefuck
|
|
z
|
|
```
|
|
|
|
See everything available.
|
|
|
|
```
|
|
fisher ls-remote
|
|
```
|
|
|
|
Update everything.
|
|
|
|
```
|
|
fisher up
|
|
```
|
|
|
|
Update some plugins.
|
|
|
|
```
|
|
fisher up bass z fzf thefuck
|
|
```
|
|
|
|
Remove plugins.
|
|
|
|
```
|
|
fisher rm simple
|
|
```
|
|
|
|
Remove all the plugins.
|
|
|
|
```
|
|
fisher ls | fisher rm
|
|
```
|
|
|
|
Get help.
|
|
|
|
```
|
|
fisher help z
|
|
```
|
|
|
|
## FAQ
|
|
|
|
### 1. What is the required fish version?
|
|
|
|
\>=2.2.0.
|
|
|
|
For [snippet](#8-what-is-a-plugin) support, upgrade to 2.3.0 or append the following code to your *~/.config/fish/config.fish*.
|
|
|
|
```fish
|
|
for file in ~/.config/fish/conf.d/*.fish
|
|
source $file
|
|
end
|
|
```
|
|
|
|
### 2. How do I use fish as my default shell?
|
|
|
|
Add fish to the list of login shells in */etc/shells* and make it your default shell.
|
|
|
|
```sh
|
|
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
|
chsh -s /usr/local/bin/fish
|
|
```
|
|
|
|
### 3. How do I uninstall fisherman?
|
|
|
|
```fish
|
|
fisher self-uninstall
|
|
```
|
|
|
|
### 4. Is fisherman compatible with oh my fish themes and plugins?
|
|
|
|
Yes.
|
|
|
|
### 5. Where does fisherman put stuff?
|
|
|
|
fisherman is saved to *~/.config/fish/functions/fisher.fish*.
|
|
|
|
The cache and configuration is created in *~/.cache/fisherman* and *~/.config/fisherman* respectively.
|
|
|
|
The fishfile is saved to *~/.config/fish/fishfile*.
|
|
|
|
### 6. What is a fishfile and how do I use it?
|
|
|
|
The fishfile *~/.config/fish/fishfile* lists all the installed plugins.
|
|
|
|
You can let fisherman take care of this file for you automatically, or write in the plugins you want and run `fisher` to satisfy the changes.
|
|
|
|
```
|
|
fisherman/simple
|
|
fisherman/z
|
|
omf/thefuck
|
|
omf/grc
|
|
```
|
|
|
|
This mechanism only installs plugins and missing dependencies. To remove a plugin, use `fisher rm` instead.
|
|
|
|
### 7. Where can I find the list of fish plugins?
|
|
|
|
Browse the [organization] or use the [online] search to discover content.
|
|
|
|
### 8. What is a plugin?
|
|
|
|
A plugin is:
|
|
|
|
1. a directory or git repo with a function *.fish* file either at the root level of the project or inside a *functions* directory
|
|
|
|
2. a theme or prompt, i.e, a *fish_prompt.fish*, *fish_right_prompt.fish* or both files
|
|
|
|
3. a snippet, i.e, one or more *.fish* files inside a directory named *conf.d* that are evaluated by fish at the start of the shell
|
|
|
|
### 9. How can I list plugins as dependencies to my plugin?
|
|
|
|
Create a new *fishfile* file at the root level of your project and write in the plugin dependencies.
|
|
|
|
```fish
|
|
owner/repo
|
|
https://github.com/owner/repo
|
|
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
|
|
```
|