A collection of shell scripts to augment the boat-cli.
Here are all the programs/scripts you need to have in your $PATH to be able to make full use of the boat fleet scripts.
Core dependencies:
- boat: ⛵ The core activity tracking library
- fzf: 🌸 A command-line fuzzy finder
- jq: ✨ A command-line JSON processor
- gum: 🎀 A tool for glamorous shell scripts
Hyprland-specific dependencies:
Styling dependencies:
- cfonts: 🖋️ used for big ASCII art text headers
- figlet: ⬆️ used for big ASCII art text in the preview pane
- lolcat: 🌈 used for colorful output
Companion scripts:
- floating-neovide.sh: a custom script to launch a floating Neovide instance with a specific note file, used for activity notes
- fzf-rofi.sh: a custom wrapper around fzf to use it with rofi, used for all interactive selection in this script
- ntfy-toast.sh: a simple wrapper around
notify-send
| Action | Description |
|---|---|
quick |
Prompt for a name and immediately start a new activity |
new |
Create a new activity with full details (name, customer, Jira issue) |
get |
Display info about the current activity (name, ID, elapsed time, customer, Jira issue, tags) |
note |
Open or create notes for the current activity in Neovide |
jira |
Open the current activity's Jira issue in the browser (only shown if a jira:* tag is set) |
resume |
Pick and resume a past activity |
stop |
Pause/stop the current activity |
cancel |
Cancel the current activity |
meeting |
Start a meeting from a list of presets (daily, weekly, misc) |
edit |
Edit today's activity logs |
config |
Open the boat configuration file in Neovide |
fleet.sh also accepts a single flag instead of opening the interactive menu:
| Option | Description |
|---|---|
-w, --current-activity-workspace |
Print the notes dir path for the current activity |
-h, --help |
Show usage and exit |
Passing any other/unknown option prints usage to stderr and exits with a non-zero status.