Skip to content

spatterIight/ansible-role-fish

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ansible-role-fish

What it is

Installs and configures a Garuda linux style Fish shell.

Supported distributions

This role has been tested as working on the following Linux distributions:

  • Ubuntu 25.10 (Questing Quokka)
  • Ubuntu 24.04 (Noble Numbat)

Features

  1. Configuration of skel, such that all users created in the future are pre-configured
  2. A Systemd service to automatically update completions
  3. The fish done plugin, which automatically sends you a desktop notification when long processes finish
  4. The intelligent McFly shell history search engine
  5. The Starship prompt
  6. The fish autopair plugin, which automatically completes (), [], {}, "", and ''
  7. Ability to set users default shell to fish
  8. Configure existing users with all of the above ^

Configuration

A basic configuration of this role might look something like this:

fish_setup_skel: true
fish_setup_update_completions_service: false
fish_setup_done: true
fish_setup_mcfly: false
fish_setup_starship: true
fish_setup_autopair: true
fish_setup_users_default_shell: true

fish_configure_users:
  - ubuntu

Running the role locally

To run the role locally, without much hassle, an playbook in the files directory can be used with the following command:

ansible-playbook -i "localhost," ./files/playbook.yml --ask-become-pass

Testing with Molecule

See molecule/README.md

About

Installs and configures a Garuda linux style Fish shell on Ubuntu 24

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published