Home

Welcome to FishDots!

What is Fishdots?

A fish shell dotfile and plugin framework. Initially a simple system to load dotfiles; over time it has morphed into a well-structured system based around plugins allowing unlimited and easy extensibility. Follow the links below to see just how easy it is to use and extend.

What you get with the core framework is a structured way of loading config files and plugins. Find out more about the loader here.

Links and Guides

• Getting Started
• Using fishdots
• Handling dotfiles
• Installing and Managing Plugins
• Plugins
• Machine specific configurations
• How config files are loaded
• Creating your own plug in
• Creating commands
• Standard environment variables
• Standard utility functions

Installation

Installation is really easy. Just run this on the command line. Make sure you have fish shell installed first.

curl -skLq bit.ly/fishdots_install | fish

Here's what happens when you install FD and pull down your plugins.

What can I do with it?

As a loader framework, there's not much you can do with fishdots on its own, but FD is designed to be extended, see the section on the loader to see how you can extend it easily. There are a few standard plugins that might get you started:

checklist clipboard crm devdirs git

idea k8s kafka kops lob

nixos notes problem projects sparql

tech timekeeping tmux todo transcript

to see a list of plugin git URLs, so you can create your own bulk plugin loader spec, see the plugins page.

How do I make it my own?

I recommend that you start by:

2. Create a plugin loader spec to bring down all of your favourite plugins
3. Create a local config file
4. Create your own repo of symlinks and dotfiles, then hook them up to the local config file
5. Create a plugin to simplify your workflow, and use a command to make it nice to learn