Community Channels (unix)

aerospace-windows

List and manage AeroSpace windows

tv running the aerospace-windows channel Requirements: aerospace, awk

Code: aerospace-windows.toml

[metadata]
name = "aerospace-windows"
description = "List and manage AeroSpace windows"
requirements = [ "aerospace", "awk",]

[source]
command = "aerospace list-windows --all --format '%{window-id}%{tab}%{workspace}%{tab}%{app-name}%{tab}%{window-title}' | awk -F'\\t' '$3 != \"AeroSpace\" {printf \"%s\\t[%s] %s | %s\\n\", $1, $2, $3, $4}'\n"
display = "{split:\\t:1}"
output = "{split:\\t:0}"

[keybindings]
enter = "actions:focus"
ctrl-x = [ "actions:close", "reload_source",]

[actions.focus]
description = "Focus the selected window"
command = "aerospace focus --window-id '{split:\\t:0}'"
mode = "execute"

[actions.close]
description = "Close the selected window"
command = "aerospace close --window-id '{split:\\t:0}'"
mode = "fork"

alias

A channel to select from shell aliases

Requirements: None

Code: alias.toml

[metadata]
name = "alias"
description = "A channel to select from shell aliases"

[source]
command = "$SHELL -ic 'alias'"
output = "{split:=:0}"

[preview]
command = "$SHELL -ic 'alias' | grep -E '^(alias )?{split:=:0}='"

[ui.preview_panel]
size = 30

apt-packages

List and manage installed apt packages

Requirements: dpkg, apt

Code: apt-packages.toml

[metadata]
name = "apt-packages"
description = "List and manage installed apt packages"
requirements = [ "dpkg", "apt",]

[source]
command = "dpkg-query -W -f='${Package}\t${Version}\t${Status}\n' 2>/dev/null | grep 'install ok installed' | awk -F'\t' '{print $1, $2}'"
output = "{split: :0}"

[preview]
command = "apt show '{split: :0}' 2>/dev/null"

[actions.remove]
description = "Remove the selected package"
command = "sudo apt remove '{split: :0}'"
mode = "execute"

[actions.reinstall]
description = "Reinstall the selected package"
command = "sudo apt install --reinstall '{split: :0}'"
mode = "execute"

aws-buckets

List and preview AWS S3 Buckets

tv running the aws-buckets channel Requirements: aws

Code: aws-buckets.toml

[metadata]
name = "aws-buckets"
description = "List and preview AWS S3 Buckets"
requirements = [ "aws",]

[source]
command = "aws s3 ls --output text"
output = "{split: :3|trim}"

[preview]
command = "aws s3 ls s3://{split: :3|trim} --human-readable --summarize"

[ui]
layout = "portrait"

[ui.preview_panel]
size = 60

[actions.list]
description = "List all objects in the selected bucket"
command = "aws s3 ls s3://{split: :3|trim} --recursive --human-readable | less"
mode = "execute"

aws-instances

List and preview AWS EC2 Instances

Requirements: aws

Code: aws-instances.toml

[metadata]
name = "aws-instances"
description = "List and preview AWS EC2 Instances"
requirements = [ "aws",]

[source]
command = "aws ec2 describe-instances --output text --query \"Reservations[*].Instances[*].[InstanceId,Tags[?Key=='Name']|[0].Value]\""

[preview]
command = "aws ec2 describe-instances --output json --instance-ids {split:\t:0} --query 'Reservations[*].Instances[0]'"

[ui]
layout = "portrait"

[ui.preview_panel]
size = 60

[actions.start]
description = "Start the selected EC2 instance"
command = "aws ec2 start-instances --instance-ids {split:\t:0}"
mode = "fork"

[actions.stop]
description = "Stop the selected EC2 instance"
command = "aws ec2 stop-instances --instance-ids {split:\t:0}"
mode = "fork"

[actions.ssm]
description = "Start an SSM session on the selected instance"
command = "aws ssm start-session --target {split:\t:0}"
mode = "execute"

aws-profiles

List and switch AWS CLI profiles

Requirements: aws, grep

Code: aws-profiles.toml

[metadata]
name = "aws-profiles"
description = "List and switch AWS CLI profiles"
requirements = [ "aws", "grep",]

[source]
command = "grep '\\[profile' ~/.aws/config 2>/dev/null | sed 's/\\[profile //' | sed 's/\\]//' || grep '\\[' ~/.aws/credentials 2>/dev/null | sed 's/\\[//' | sed 's/\\]//'"

[preview]
command = "aws configure list --profile '{}' 2>/dev/null"

[keybindings]
enter = "actions:export"

[ui.preview_panel]
size = 40

[actions.export]
description = "Export the selected profile (sets AWS_PROFILE)"
command = "export AWS_PROFILE='{}' && echo \"AWS_PROFILE set to '{}'\" && $SHELL"
mode = "execute"

bash-history

A channel to select from your bash history

Requirements: bash

Code: bash-history.toml

[metadata]
name = "bash-history"
description = "A channel to select from your bash history"
requirements = [ "bash",]

[source]
command = "sed '1!G;h;$!d' ${HISTFILE:-${HOME}/.bash_history} | awk '!seen[$0]++'"
no_sort = true
frecency = false

brew-packages

List and manage Homebrew packages

Requirements: brew

Code: brew-packages.toml

[metadata]
name = "brew-packages"
description = "List and manage Homebrew packages"
requirements = [ "brew",]

[source]
[[source.command]]
name = "Formulae"
run = "brew list --formula"

[[source.command]]
name = "Casks"
run = "brew list --cask"

[preview]
command = "brew info '{}'"

[ui]
layout = "portrait"

[keybindings]
ctrl-u = "actions:upgrade"
ctrl-d = "actions:uninstall"

[actions.upgrade]
description = "Upgrade the selected package"
command = "brew upgrade '{}'"
mode = "execute"

[actions.uninstall]
description = "Uninstall the selected package"
command = "brew uninstall '{}'"
mode = "execute"

cargo-commands

List available cargo commands and extensions

Requirements: cargo

Code: cargo-commands.toml

[metadata]
name = "cargo-commands"
description = "List available cargo commands and extensions"
requirements = [ "cargo",]

[source]
command = "cargo --list 2>/dev/null | tail -n +2 | awk '{print $1}'"

[preview]
command = "cargo {} --help 2>/dev/null | head -50"

[ui]
layout = "portrait"

[keybindings]
enter = "actions:run"

[ui.preview_panel]
size = 60

[actions.run]
description = "Run the selected cargo command"
command = "cargo '{}'"
mode = "execute"

cargo-crates

List installed cargo crates

Requirements: cargo

Code: cargo-crates.toml

[metadata]
name = "cargo-crates"
description = "List installed cargo crates"
requirements = [ "cargo",]

[source]
command = "cargo install --list 2>/dev/null | grep -v '^    ' | sed 's/:$//'"
display = "{split: :0} {split: :1}"
output = "{split: :0}"

[preview]
command = "cargo install --list 2>/dev/null | sed -n '/^{split: :0} /,/^[^ ]/p' | head -20"

[actions.uninstall]
description = "Uninstall the selected crate"
command = "cargo uninstall '{split: :0}'"
mode = "execute"

channels

Select a television channel

tv running the channels channel Requirements: tv, bat

Code: channels.toml

[metadata]
name = "channels"
description = "Select a television channel"
requirements = [ "tv", "bat",]

[source]
command = [ "tv list-channels",]

[preview]
command = "bat -pn --color always ${TELEVISION_CONFIG:-${XDG_CONFIG_HOME:-$HOME/.config}/television}/cable/{}.toml"
shell = "bash"

[keybindings]
enter = "actions:channel-enter"

[actions.channel-enter]
description = "Enter a television channel"
command = "tv {}"
mode = "execute"

crontab

List and manage crontab entries

Requirements: None

Code: crontab.toml

[metadata]
name = "crontab"
description = "List and manage crontab entries"

[source]
command = "crontab -l 2>/dev/null | grep -v '^#' | grep -v '^$'"
no_sort = true
frecency = false

[preview]
command = "echo 'Schedule: {split: :..5}' && echo '' && echo 'Command:' && echo '{split: :5..}' "

[ui]
layout = "portrait"

[ui.preview_panel]
size = 30

[actions.edit]
description = "Open crontab for editing"
command = "crontab -e"
mode = "execute"

dirs

A channel to select from directories

Requirements: fd

Code: dirs.toml

[metadata]
name = "dirs"
description = "A channel to select from directories"
requirements = [ "fd",]

[source]
[[source.command]]
name = "Default"
run = "fd -t d"

[[source.command]]
name = "Hidden"
run = "fd -t d --hidden"

[preview]
command = "ls -la --color=always '{}'"

[keybindings]
shortcut = "f2"

[actions.cd]
description = "Open a shell in the selected directory"
command = "cd '{}' && $SHELL"
mode = "execute"

[actions.goto_parent_dir]
description = "Re-opens tv in the parent directory"
command = "tv dirs .."
mode = "execute"

diskutil

List and manage mounted filesystems on macOS

tv running the diskutil channel Requirements: df, awk, diskutil

Code: diskutil.toml

[metadata]
name = "diskutil"
description = "List and manage mounted filesystems on macOS"
requirements = [ "df", "awk", "diskutil",]

[source]
command = "df -h | tail -n +2 | awk '{print $NF\"\\t\"$1\"\\t\"$2\"\\t\"$5}'"
display = "{split:\t:0} ({split:\t:1}, {split:\t:3})"
output = "{split:\t:0}"

[preview]
command = "df -h '{split:\t:0}' && echo && ls -la '{split:\t:0}' 2>/dev/null | head -20"

[keybindings]
enter = "actions:cd"
ctrl-o = "actions:open"
ctrl-i = "actions:info"
ctrl-d = "actions:eject"
ctrl-v = "actions:verify"

[actions.cd]
description = "Open a shell in the selected mount point"
command = "cd '{split:\t:0}' && $SHELL"
shell = "bash"
mode = "execute"

[actions.open]
description = "Open the selected mount point in Finder"
command = "open '{split:\t:0}'"
mode = "fork"

[actions.info]
description = "Show full disk info for the selected mount point in a pager"
command = "diskutil info '{split:\t:0}' | less"
mode = "execute"

[actions.eject]
description = "Eject the selected volume"
command = "diskutil eject '{split:\t:0}'"
mode = "execute"

[actions.verify]
description = "Verify the filesystem on the selected volume"
command = "diskutil verifyVolume '{split:\t:0}'"
mode = "execute"

distrobox-list

A channel to select a container from distrobox

tv running the distrobox-list channel Requirements: distrobox, bat

Code: distrobox-list.toml

[metadata]
name = "distrobox-list"
description = "A channel to select a container from distrobox"
requirements = [ "distrobox", "bat",]

[source]
command = [ "distrobox list | awk -F '|' '{ gsub(/ /, \"\", $2); print $2}' | tail --lines=+2",]

[preview]
command = "(distrobox list | column -t -s '|' | awk -v selected_name={} 'NR==1 || $0 ~ selected_name') && echo && distrobox enter -d {} | bat --plain --color=always -lbash"

[keybindings]
ctrl-e = "actions:distrobox-enter"
ctrl-l = "actions:distrobox-list"
ctrl-r = "actions:distrobox-rm"
ctrl-s = "actions:distrobox-stop"
ctrl-u = "actions:distrobox-upgrade"

[actions.distrobox-enter]
description = "Enter a distrobox"
command = "distrobox enter {}"
mode = "execute"

[actions.distrobox-list]
description = "List a distrobox"
command = "distrobox list | column -t -s '|' | awk -v selected_name={} 'NR==1 || $0 ~ selected_name'"
mode = "execute"

[actions.distrobox-rm]
description = "Remove a distrobox"
command = "distrobox rm {}"
mode = "execute"

[actions.distrobox-stop]
description = "Stop a distrobox"
command = "distrobox stop {}"
mode = "execute"

[actions.distrobox-upgrade]
description = "Upgrade a distrobox"
command = "distrobox upgrade {}"
mode = "execute"

dnf-packages

List and manage installed dnf packages

tv running the dnf-packages channel Requirements: rpm, dnf

Code: dnf-packages.toml

[metadata]
name = "dnf-packages"
description = "List and manage installed dnf packages"
requirements = [ "rpm", "dnf",]

[source]
command = "rpm -qa --queryformat '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' 2>/dev/null"

[preview]
command = "rpm -q --info '{}' 2>/dev/null"

[actions.remove]
description = "Remove the selected package"
command = "sudo dnf remove '{}'"
mode = "execute"

docker-compose

Manage Docker Compose services

Requirements: docker

Code: docker-compose.toml

[metadata]
name = "docker-compose"
description = "Manage Docker Compose services"
requirements = [ "docker",]

[source]
command = "docker compose ps --format '{{.Name}}\t{{.Service}}\t{{.Status}}'"
display = "{split:\t:1} ({split:\t:2})"
output = "{split:\t:1}"

[preview]
command = "docker compose logs --tail=30 --no-log-prefix '{split:\t:1}'"

[actions.up]
description = "Start the selected service"
command = "docker compose up -d '{split:\t:1}'"
mode = "fork"

[actions.down]
description = "Stop and remove the selected service"
command = "docker compose down '{split:\t:1}'"
mode = "fork"

[actions.restart]
description = "Restart the selected service"
command = "docker compose restart '{split:\t:1}'"
mode = "fork"

[actions.logs]
description = "Follow logs of the selected service"
command = "docker compose logs -f '{split:\t:1}'"
mode = "execute"

docker-containers

List and manage Docker containers

Requirements: docker, jq

Code: docker-containers.toml

[metadata]
name = "docker-containers"
description = "List and manage Docker containers"
requirements = [ "docker", "jq",]

[source]
display = "{split:\\t:0} ({split:\\t:2})"
output = "{split:\\t:0}"
[[source.command]]
name = "Running"
run = "docker ps --format '{{.Names}}\\t{{.Image}}\\t{{.Status}}'"

[[source.command]]
name = "All"
run = "docker ps -a --format '{{.Names}}\\t{{.Image}}\\t{{.Status}}'"

[preview]
command = "docker inspect '{split:\\t:0}' | jq -C '.[0] | {Name, State, Config: {Image: .Config.Image, Cmd: .Config.Cmd}, NetworkSettings: {IPAddress: .NetworkSettings.IPAddress}}'"

[ui]
layout = "portrait"

[keybindings]
ctrl-s = "actions:start"
f2 = "actions:stop"
ctrl-r = "actions:restart"
ctrl-l = "actions:logs"
ctrl-e = "actions:exec"
ctrl-d = "actions:remove"

[actions.start]
description = "Start the selected container"
command = "docker start '{split:\\t:0}'"
mode = "fork"

[actions.stop]
description = "Stop the selected container"
command = "docker stop '{split:\\t:0}'"
mode = "fork"

[actions.restart]
description = "Restart the selected container"
command = "docker restart '{split:\\t:0}'"
mode = "fork"

[actions.logs]
description = "Follow logs of the selected container"
command = "docker logs -f '{split:\\t:0}'"
mode = "execute"

[actions.exec]
description = "Execute shell in the selected container"
command = "docker exec -it '{split:\\t:0}' /bin/sh"
mode = "execute"

[actions.remove]
description = "Remove the selected container"
command = "docker rm '{split:\\t:0}'"
mode = "execute"

docker-images

A channel to select from Docker images

Requirements: docker, jq

Code: docker-images.toml

[metadata]
name = "docker-images"
description = "A channel to select from Docker images"
requirements = [ "docker", "jq",]

[source]
command = "docker images --format '{{.Repository}}:{{.Tag}} {{.ID}}'"
output = "{split: :-1}"

[preview]
command = "docker image inspect '{split: :-1}' | jq -C"

[ui]
layout = "portrait"

[keybindings]
ctrl-r = "actions:run"
ctrl-d = "actions:remove"
ctrl-s = "actions:shell"

[actions.run]
description = "Run a container from the selected image"
command = "docker run -it '{split: :-1}'"
mode = "execute"

[actions.shell]
description = "Run a shell in the selected image"
command = "docker run -it '{split: :-1}' /bin/sh"
mode = "execute"

[actions.remove]
description = "Remove the selected image"
command = "docker rmi '{split: :-1}'"
mode = "execute"

docker-networks

List and manage Docker networks

Requirements: docker, jq

Code: docker-networks.toml

[metadata]
name = "docker-networks"
description = "List and manage Docker networks"
requirements = [ "docker", "jq",]

[source]
command = "docker network ls --format '{{.Name}}\t{{.Driver}}\t{{.Scope}}'"
display = "{split:\t:0} ({split:\t:1}, {split:\t:2})"
output = "{split:\t:0}"

[preview]
command = "docker network inspect '{split:\t:0}' | jq -C '.[0] | {Name, Driver, Scope, IPAM, Containers: (.Containers // {} | to_entries | map({name: .value.Name, ipv4: .value.IPv4Address}))}'"

[ui]
layout = "portrait"

[actions.remove]
description = "Remove the selected network"
command = "docker network rm '{split:\t:0}'"
mode = "execute"

docker-volumes

List and manage Docker volumes

Requirements: docker, jq

Code: docker-volumes.toml

[metadata]
name = "docker-volumes"
description = "List and manage Docker volumes"
requirements = [ "docker", "jq",]

[source]
command = "docker volume ls --format '{{.Name}}\t{{.Driver}}'"
display = "{split:\t:0} ({split:\t:1})"
output = "{split:\t:0}"

[preview]
command = "docker volume inspect '{split:\t:0}' | jq -C '.[0]'"

[ui]
layout = "portrait"

[actions.remove]
description = "Remove the selected volume"
command = "docker volume rm '{split:\t:0}'"
mode = "execute"

[actions.inspect]
description = "Inspect the selected volume in a pager"
command = "docker volume inspect '{split:\t:0}' | jq -C '.[0]' | less -R"
mode = "execute"

dotfiles

A channel to select from your user's dotfiles

Requirements: fd, bat

Code: dotfiles.toml

[metadata]
name = "dotfiles"
description = "A channel to select from your user's dotfiles"
requirements = [ "fd", "bat",]

[source]
command = "fd -t f . $HOME/.config"

[preview]
command = "bat -n --color=always '{}'"

[keybindings]
enter = "actions:edit"

[actions.edit]
description = "Edit the selected dotfile"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

downloads

Browse recent files in Downloads folder

Requirements: fd, bat

Code: downloads.toml

[metadata]
name = "downloads"
description = "Browse recent files in Downloads folder"
requirements = [ "fd", "bat",]

[source]
command = "fd -t f . ~/Downloads 2>/dev/null | head -200"

[preview]
command = "bat -n --color=always '{}' 2>/dev/null || file '{}'"

[keybindings]
enter = "actions:open"
ctrl-d = "actions:delete"
ctrl-m = "actions:move"

[preview.env]
BAT_THEME = "ansi"

[actions.open]
description = "Open the selected file with default application"
command = "xdg-open '{}' 2>/dev/null || open '{}'"
mode = "fork"

[actions.delete]
description = "Delete the selected file"
command = "rm -i '{}'"
mode = "execute"

[actions.move]
description = "Move the selected file to current directory"
command = "mv '{}' ."
mode = "fork"

env

A channel to select from environment variables

Requirements: None

Code: env.toml

[metadata]
name = "env"
description = "A channel to select from environment variables"

[source]
command = "printenv"
output = "{split:=:1..}"

[preview]
command = "echo '{split:=:1..}'"

[ui]
layout = "portrait"

[keybindings]
shortcut = "f3"

[ui.preview_panel]
size = 20
header = "{split:=:0}"

[actions.name]
description = "Output the variable name instead of the value"
command = "echo '{split:=:0}'"
mode = "execute"

figlet-fonts

Browse and preview figlet fonts

tv running the figlet-fonts channel Requirements: figlet

Code: figlet-fonts.toml

[metadata]
name = "figlet-fonts"
description = "Browse and preview figlet fonts"
requirements = [ "figlet",]

[source]
command = "for i in \"$(figlet -I2)\"/*.flf; do basename \"$i\" .flf; done | sort"

[preview]
command = "figlet -f '{}' 'The quick brown fox jumps over the lazy dog.'"

files

A channel to select files and directories

Requirements: fd, bat

Code: files.toml

[metadata]
name = "files"
description = "A channel to select files and directories"
requirements = [ "fd", "bat",]

[source]
[[source.command]]
name = "Default"
run = "fd -t f"

[[source.command]]
name = "Hidden"
run = "fd -t f -H"

[preview]
command = "bat -n --color=always '{}'"

[keybindings]
shortcut = "f1"
f12 = "actions:edit"
ctrl-up = "actions:goto_parent_dir"

[preview.env]
BAT_THEME = "ansi"

[actions.edit]
description = "Opens the selected entries with the default editor (falls back to vim)"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

[actions.goto_parent_dir]
description = "Re-opens tv in the parent directory"
command = "tv files .."
mode = "execute"

fish-history

A channel to select from your fish history

Requirements: fish

Code: fish-history.toml

[metadata]
name = "fish-history"
description = "A channel to select from your fish history"
requirements = [ "fish",]

[source]
command = "fish -c 'history'"
no_sort = true
frecency = false

fj-issues

List Forgejo issues for the current repo

Requirements: fj, bat

Code: fj-issues.toml

[metadata]
name = "fj-issues"
description = "List Forgejo issues for the current repo"
requirements = [ "fj", "bat",]

[source]
command = "fj issue search --state open | awk -F ' [(]by ' '/^\n  number=$1; sub(/^                                    \n  title=$1; sub(/^                    \n  author=$2; sub(/\\)$/,\"\",author)\n  printf \"\\033[32m#%s\\033[39m\\t%s \\033[33m@%s\\033[39m\\n\", number, title, author\n}' "
ansi = true
output = "{strip_ansi|split:\t:0|replace:s/^#//}"

[ui]
layout = "portrait"

[preview]
command = "fj issue view {strip_ansi|split:\t:0|replace:s/^#//} | bat --language=md --style=plain --color=always"

[ui.preview_panel]
header = "{strip_ansi|split:\\t:1}"

[preview.env]
BAT_THEME = "ansi"

[actions.open]
description = "Open the issue in the browser"
command = "fj issue browse {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "fork"

[actions.close]
description = "Close the selected issue"
command = "fj issue close {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "fork"

[actions.comment]
description = "Add a comment to the selected issue"
command = "fj issue comment {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "execute"

fj-prs

List Forgejo PRs for the current repo

Requirements: fj, bat

Code: fj-prs.toml

[metadata]
name = "fj-prs"
description = "List Forgejo PRs for the current repo"
requirements = [ "fj", "bat",]

[source]
command = "fj pr search --state open | awk -F ' [(]by ' '/^\n  number=$1; sub(/^                                    \n  title=$1; sub(/^                    \n  author=$2; sub(/\\)$/,\"\",author)\n  printf \"\\033[32m#%s\\033[39m\\t%s \\033[33m@%s\\033[39m\\n\", number, title, author\n}' "
ansi = true
output = "{strip_ansi|split:\t:0|replace:s/^#//}"

[ui]
layout = "portrait"

[preview]
command = "fj pr view {strip_ansi|split:\t:0|replace:s/^#//} | bat --language=md --style=plain --color=always"

[ui.preview_panel]
header = "{strip_ansi|split:\\t:1}"

[preview.env]
BAT_THEME = "ansi"

[actions.open]
description = "Open the PR in the browser"
command = "fj pr browse {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "fork"

[actions.checkout]
description = "Checkout the PR branch locally"
command = "fj pr checkout {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "execute"

[actions.merge]
description = "Merge the selected PR"
command = "fj pr merge {strip_ansi|split:\t:0|replace:s/^#//}"
mode = "execute"

[actions.diff]
description = "View the PR diff"
command = "fj pr view {strip_ansi|split:\t:0|replace:s/^#//} diff | less"
mode = "execute"

flatpak

List and manage Flatpak applications

Requirements: flatpak

Code: flatpak.toml

[metadata]
name = "flatpak"
description = "List and manage Flatpak applications"
requirements = [ "flatpak",]

[source]
command = "flatpak list --app --columns=application,name,version 2>/dev/null"
display = "{split:\t:1} ({split:\t:2})"
output = "{split:\t:0}"

[preview]
command = "flatpak info '{split:\t:0}' 2>/dev/null"

[actions.run]
description = "Launch the selected application"
command = "flatpak run '{split:\t:0}'"
mode = "execute"

[actions.uninstall]
description = "Uninstall the selected application"
command = "flatpak uninstall '{split:\t:0}'"
mode = "execute"

[actions.update]
description = "Update the selected application"
command = "flatpak update '{split:\t:0}'"
mode = "execute"

fonts

List installed system fonts

Requirements: fc-list

Code: fonts.toml

[metadata]
name = "fonts"
description = "List installed system fonts"
requirements = [ "fc-list",]

[source]
command = "fc-list --format='%{family}\n' | sort -uf"

[preview]
command = "fc-list '{}' --format='%{file}\n%{style}\n%{family}\n' | head -20"

[ui.preview_panel]
size = 70

gh-issues

List GitHub issues for the current repo

tv running the gh-issues channel Requirements: gh, jq

Code: gh-issues.toml

[metadata]
name = "gh-issues"
description = "List GitHub issues for the current repo"
requirements = [ "gh", "jq",]

[source]
command = "gh issue list --state open --limit 100 --json number,title,createdAt,author,labels | jq -r 'sort_by(.createdAt) | reverse | .[] | \"  \\u001b[32m#\\(.number)\\u001b[39m   \\(.title) \\u001b[33m@\\(.author.login)\\u001b[39m\" + (if (.labels | length) > 0 then \" \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"] | join(\" \")) else \"\" end)'\n"
ansi = true
output = "{strip_ansi|split:#:1|split: :0}"

[ui]
layout = "portrait"

[preview]
command = "gh issue view '{strip_ansi|split:\n\"  \" + .title,\n\"  #\" + (.number | tostring),\n\"\",\n\"  \\u001b[36mStatus:\\u001b[39m \\u001b[32m\" + .state + \"\\u001b[39m\",\n\"  \\u001b[36mAuthor:\\u001b[39m \\u001b[33m\" + .author.login + \"\\u001b[39m\",\n\"  \\u001b[36mCreated:\\u001b[39m \" + (.createdAt | fromdateiso8601 | (now - .) | if . < 3600 then (./60|floor|tostring) + \" minutes ago\" elif . < 86400 then (./3600|floor|tostring) + \" hours ago\" else (./86400|floor|tostring) + \" days ago\" end),\n\"  \\u001b[36mUpdated:\\u001b[39m \" + (.updatedAt | fromdateiso8601 | (now - .) | if . < 3600 then (./60|floor|tostring) + \" minutes ago\" elif . < 86400 then (./3600|floor|tostring) + \" hours ago\" else (./86400|floor|tostring) + \" days ago\" end),\n(if (.labels | length) > 0 then \"  \\u001b[36mLabels:\\u001b[39m \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"] | join(\" \")) else \"\" end),\n(if (.assignees | length) > 0 then \"  \\u001b[36mAssignees:\\u001b[39m \" + ([.assignees[].login] | join(\", \")) else \"\" end),\n\"\",\n\"  \\u001b[90m────────────────────────────────────────────────────────────\\u001b[39m\",\n\"\",\n(.body // \"\")'\n"

[ui.preview_panel]
header = "{strip_ansi|split:#:1|split: :0}"

[actions.open]
description = "Open the issue in the browser"
command = "gh issue view {strip_ansi|split:#:1|split: :0} --web"
mode = "fork"

[actions.close]
description = "Close the selected issue"
command = "gh issue close {strip_ansi|split:#:1|split: :0}"
mode = "fork"

[actions.comment]
description = "Add a comment to the selected issue"
command = "gh issue comment {strip_ansi|split:#:1|split: :0}"
mode = "execute"

gh-prs

List GitHub PRs for the current repo

tv running the gh-prs channel Requirements: gh, jq

Code: gh-prs.toml

[metadata]
name = "gh-prs"
description = "List GitHub PRs for the current repo"
requirements = [ "gh", "jq",]

[source]
command = "gh pr list --state open --limit 100 --json number,title,createdAt,author,labels | jq -r 'sort_by(.createdAt) | reverse | .[] | \"  \\u001b[32m#\\(.number)\\u001b[39m   \\(.title) \\u001b[33m@\\(.author.login)\\u001b[39m\" + (if (.labels | length) > 0 then \" \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"] | join(\" \")) else \"\" end)'\n"
output = "{strip_ansi|split:#:1|split:   :0}"
ansi = true

[ui]
layout = "portrait"

[preview]
command = "gh pr view '{strip_ansi|split:\n\"  \" + .title,\n\"  #\" + (.number | tostring),\n\"\",\n\"  \\u001b[36mStatus:\\u001b[39m \\u001b[32m\" + .state + \"\\u001b[39m  \" + .baseRefName + \" ← \" + .headRefName,\n\"  \\u001b[36mRepo:\\u001b[39m \\u001b[34m\" + (.headRepositoryOwner.login) + \"/\" + (.headRepository.name) + \"\\u001b[39m\",\n\"  \\u001b[36mAuthor:\\u001b[39m \\u001b[33m\" + .author.login + \"\\u001b[39m\",\n\"  \\u001b[36mCreated:\\u001b[39m \" + (.createdAt | fromdateiso8601 | (now - .) | if . < 3600 then (./60|floor|tostring) + \" minutes ago\" elif . < 86400 then (./3600|floor|tostring) + \" hours ago\" else (./86400|floor|tostring) + \" days ago\" end),\n\"  \\u001b[36mUpdated:\\u001b[39m \" + (.updatedAt | fromdateiso8601 | (now - .) | if . < 3600 then (./60|floor|tostring) + \" minutes ago\" elif . < 86400 then (./3600|floor|tostring) + \" hours ago\" else (./86400|floor|tostring) + \" days ago\" end),\n(if (.labels | length) > 0 then \"  \\u001b[36mLabels:\\u001b[39m \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"] | join(\" \")) else \"\" end),\n\"  \\u001b[36mMerge Status:\\u001b[39m \" + (if .mergeable == \"MERGEABLE\" then \"\\u001b[32m✓ Clean\\u001b[39m\" elif .mergeable == \"CONFLICTING\" then \"\\u001b[31m✗ Dirty\\u001b[39m\" else \"\\u001b[33m? Unknown\\u001b[39m\" end),\n\"  \\u001b[36mChanges:\\u001b[39m \" + (.changedFiles | tostring) + \" files  \\u001b[32m+\" + (.additions | tostring) + \"\\u001b[39m \\u001b[31m-\" + (.deletions | tostring) + \"\\u001b[39m\",\n\"\",\n\"  \\u001b[90m────────────────────────────────────────────────────────────\\u001b[39m\",\n\"\",\n(.body // \"\")'\n"

[actions.open]
description = "Open the PR in the browser"
command = "gh pr view {strip_ansi|split:#:1|split:   :0} --web"
mode = "execute"

[actions.checkout]
description = "Checkout the PR branch locally"
command = "gh pr checkout {strip_ansi|split:#:1|split:   :0}"
mode = "execute"

[actions.merge]
description = "Merge the selected PR"
command = "gh pr merge {strip_ansi|split:#:1|split:   :0}"
mode = "execute"

[actions.diff]
description = "View the PR diff"
command = "gh pr diff {strip_ansi|split:#:1|split:   :0} | less"
mode = "execute"

git-branch

A channel to select from git branches

Requirements: git

Code: git-branch.toml

[metadata]
name = "git-branch"
description = "A channel to select from git branches"
requirements = [ "git",]

[source]
command = "git --no-pager branch --all --format=\"%(refname:short)\""
output = "{split: :0}"

[preview]
command = "git show -p --stat --pretty=fuller --color=always '{0}'"

[keybindings]
enter = "actions:checkout"
ctrl-d = "actions:delete"
ctrl-m = "actions:merge"
ctrl-r = "actions:rebase"

[actions.checkout]
description = "Checkout the selected branch"
command = "git checkout '{0}'"
mode = "execute"

[actions.delete]
description = "Delete the selected branch"
command = "git branch -d '{0}'"
mode = "execute"

[actions.merge]
description = "Merge the selected branch into current branch"
command = "git merge '{0}'"
mode = "execute"

[actions.rebase]
description = "Rebase current branch onto the selected branch"
command = "git rebase '{0}'"
mode = "execute"

git-deletions

A channel to list files which were deleted from the Git repository

tv running the git-deletions channel Requirements: git, rg, bat

Code: git-deletions.toml

[metadata]
name = "git-deletions"
description = "A channel to list files which were deleted from the Git repository"
requirements = [ "git", "rg", "bat",]

[source]
command = "git log --diff-filter=D --summary | rg 'delete mode \\d+' -r '' --trim"

[preview]
command = [ "git show \"$(git rev-list -n1 HEAD -- '{}')^:{}\" | bat -n --color always --file-name '{}'", "git show --summary \"$(git rev-list -n1 HEAD -- '{}')\"",]

[keybindings]
enter = "actions:print_commit"
ctrl-r = "actions:restore_file"

[actions.print_commit]
description = "Print the latest commit where file was deleted"
command = "echo \"$(git rev-list -n1 HEAD -- '{}')\""
mode = "execute"

[actions.restore_file]
description = "Restore the selected file"
command = "git checkout \"$(git rev-list -n1 HEAD -- '{}')^\" -- '{}'"

git-diff

A channel to select files from git diff commands

Requirements: git

Code: git-diff.toml

[metadata]
name = "git-diff"
description = "A channel to select files from git diff commands"
requirements = [ "git",]

[source]
command = "git diff --name-only HEAD"

[preview]
command = "git diff HEAD --color=always -- '{}'"

[ui]
layout = "portrait"

[keybindings]
ctrl-s = "actions:stage"
ctrl-r = "actions:restore"
ctrl-e = "actions:edit"

[actions.stage]
description = "Stage the selected file"
command = "git add '{}'"
mode = "fork"

[actions.restore]
description = "Discard changes in the selected file"
command = "git restore '{}'"
mode = "fork"

[actions.edit]
description = "Open the selected file in editor"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

git-files

A channel to list the files currently tracked in the Git repository

tv running the git-files channel Requirements: git, bat

Code: git-files.toml

[metadata]
name = "git-files"
description = "A channel to list the files currently tracked in the Git repository"
requirements = [ "git", "bat",]

[source]
command = "git ls-files $(git rev-parse --show-toplevel)"

[preview]
command = "bat -n --color=always '{}'"

[keybindings]
f12 = "actions:edit"

[preview.env]
BAT_THEME = "ansi"

[actions.edit]
description = "Opens the selected entries with the default editor (falls back to vim)"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

git-log

A channel to select from git log entries

Requirements: git

Code: git-log.toml

[metadata]
name = "git-log"
description = "A channel to select from git log entries"
requirements = [ "git",]

[source]
command = "git log --graph --pretty=format:'%C(yellow)%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --color=always"
output = "{strip_ansi|split: :1}"
ansi = true
no_sort = true
frecency = false

[preview]
command = "git show -p --stat --pretty=fuller --color=always '{strip_ansi|split: :1}' | head -n 1000"

[keybindings]
ctrl-y = "actions:cherry-pick"
ctrl-r = "actions:revert"
ctrl-o = "actions:checkout"

[actions.cherry-pick]
description = "Cherry-pick the selected commit"
command = "git cherry-pick '{strip_ansi|split: :1}'"
mode = "execute"

[actions.revert]
description = "Revert the selected commit"
command = "git revert '{strip_ansi|split: :1}'"
mode = "execute"

[actions.checkout]
description = "Checkout the selected commit"
command = "git checkout '{strip_ansi|split: :1}'"
mode = "execute"

git-reflog

A channel to select from git reflog entries

Requirements: git

Code: git-reflog.toml

[metadata]
name = "git-reflog"
description = "A channel to select from git reflog entries"
requirements = [ "git",]

[source]
command = "git reflog --decorate --color=always"
output = "{0|strip_ansi}"
ansi = true
no_sort = true
frecency = false

[preview]
command = "git show -p --stat --pretty=fuller --color=always '{0|strip_ansi}'"

[keybindings]
ctrl-o = "actions:checkout"
ctrl-r = "actions:reset"

[actions.checkout]
description = "Checkout the selected reflog entry"
command = "git checkout '{0|strip_ansi}'"
mode = "execute"

[actions.reset]
description = "Reset --hard to the selected reflog entry"
command = "git reset --hard '{0|strip_ansi}'"
mode = "execute"

git-remotes

List and manage git remotes

Requirements: git

Code: git-remotes.toml

[metadata]
name = "git-remotes"
description = "List and manage git remotes"
requirements = [ "git",]

[source]
command = "git remote"

[preview]
command = "git remote show '{}'"

[actions.fetch]
description = "Fetch from the selected remote"
command = "git fetch '{}'"
mode = "execute"

[actions.remove]
description = "Remove the selected remote"
command = "git remote remove '{}'"
mode = "execute"

git-repos

A channel to select from git repositories on your local machine.

This channel uses fd to find directories that contain a .git subdirectory, and then allows you to preview the git log of the selected repository.

Requirements: fd, git

Code: git-repos.toml

[metadata]
name = "git-repos"
requirements = [ "fd", "git",]
description = "A channel to select from git repositories on your local machine.\n\nThis channel uses `fd` to find directories that contain a `.git` subdirectory, and then allows you to preview the git log of the selected repository.\n"

[source]
command = "fd -g .git -HL -t d -d 10 --prune ~ -E 'Library' -E 'Application Support' --exec dirname '{}'"
display = "{split:/:-1}"

[preview]
command = "cd '{}'; git log -n 200 --pretty=medium --all --graph --color"

[keybindings]
enter = "actions:cd"
ctrl-e = "actions:edit"

[actions.cd]
description = "Open a new shell in the selected repository"
command = "cd '{}' && $SHELL"
mode = "execute"

[actions.edit]
description = "Open the repository in editor"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

git-stash

Browse and manage git stash entries

Requirements: git

Code: git-stash.toml

[metadata]
name = "git-stash"
description = "Browse and manage git stash entries"
requirements = [ "git",]

[source]
command = "git stash list --color=always"
ansi = true
output = "{strip_ansi|split:\\::0}"
no_sort = true
frecency = false

[preview]
command = "git stash show -p --color=always '{strip_ansi|split:\\::0}'"

[ui]
layout = "portrait"

[keybindings]
enter = "actions:apply"
ctrl-p = "actions:pop"
ctrl-d = "actions:drop"

[actions.apply]
description = "Apply the selected stash"
command = "git stash apply '{strip_ansi|split:\\::0}'"
mode = "execute"

[actions.pop]
description = "Pop the selected stash (apply and remove)"
command = "git stash pop '{strip_ansi|split:\\::0}'"
mode = "execute"

[actions.drop]
description = "Drop the selected stash"
command = "git stash drop '{strip_ansi|split:\\::0}'"
mode = "execute"

git-submodules

List and manage git submodules

Requirements: git

Code: git-submodules.toml

[metadata]
name = "git-submodules"
description = "List and manage git submodules"
requirements = [ "git",]

[source]
command = "git submodule status | awk '{print $2}'"

[preview]
command = "git -C '{}' log --oneline -10 --color=always"

[actions.update]
description = "Update the selected submodule"
command = "git submodule update --init --recursive '{}'"
mode = "execute"

[actions.sync]
description = "Sync the selected submodule URL"
command = "git submodule sync '{}'"
mode = "execute"

git-tags

Browse and checkout git tags

Requirements: git

Code: git-tags.toml

[metadata]
name = "git-tags"
description = "Browse and checkout git tags"
requirements = [ "git",]

[source]
command = "git tag --sort=-creatordate"
no_sort = true
frecency = false

[preview]
command = "git show --color=always '{}'"

[keybindings]
enter = "actions:checkout"
ctrl-d = "actions:delete"

[actions.checkout]
description = "Checkout the selected tag"
command = "git checkout '{}'"
mode = "execute"

[actions.delete]
description = "Delete the selected tag"
command = "git tag -d '{}'"
mode = "execute"

git-worktrees

List and switch between git worktrees

Requirements: git

Code: git-worktrees.toml

[metadata]
name = "git-worktrees"
description = "List and switch between git worktrees"
requirements = [ "git",]

[source]
command = "git worktree list --porcelain | grep '^worktree' | cut -d' ' -f2-"

[preview]
command = "cd '{}' && git log --oneline -10 --color=always && echo && git status --short"

[keybindings]
enter = "actions:cd"
ctrl-d = "actions:remove"

[actions.cd]
description = "Change to the selected worktree"
command = "cd '{}' && $SHELL"
mode = "execute"

[actions.remove]
description = "Remove the selected worktree"
command = "git worktree remove '{}'"
mode = "execute"

gradle-tasks

List and run Gradle tasks

Requirements: gradle

Code: gradle-tasks.toml

[metadata]
name = "gradle-tasks"
description = "List and run Gradle tasks"
requirements = [ "gradle",]

[source]
command = "gradle tasks --all -q 2>/dev/null | grep -E '^[a-zA-Z]' | awk '{print $1}' | grep -v '^-' | sort -u"

[preview]
command = "gradle help --task '{}' -q 2>/dev/null || echo 'Task: {}'"

[keybindings]
enter = "actions:run"

[actions.run]
description = "Run the selected Gradle task"
command = "gradle '{}'"
mode = "execute"

guix

A channel to search for and select Guix packages

tv running the guix channel Requirements: guix

Code: guix.toml

[metadata]
name = "guix"
description = "A channel to search for and select Guix packages"
requirements = [ "guix",]

[source]
command = [ "guix package --list-available=.*",]
display = "{trim|replace:s/\\s+/ /g|split: :0}"
output = "{trim|replace:s/\\s+/ /g|split: :0}"

[preview]
command = "guix package --show={trim|replace:s/\\s+/ /g|split: :0}"

[keybindings]
f12 = "actions:shell"

[actions.shell]
description = "Spawns a shell with the selected package"
command = "guix shell {trim|replace:s/\\s+/ /g|split: :0}"
mode = "execute"

images

Browse image files with preview

Requirements: fd, chafa

Code: images.toml

[metadata]
name = "images"
description = "Browse image files with preview"
requirements = [ "fd", "chafa",]

[source]
[[source.command]]
name = "Default"
run = "fd -t f -e png -e jpg -e jpeg -e gif -e webp -e bmp -e svg ."

[[source.command]]
name = "Hidden"
run = "fd -t f -e png -e jpg -e jpeg -e gif -e webp -e bmp -e svg -H ."

[preview]
command = "chafa -s 80x40 '{}' 2>/dev/null || file '{}'"

[keybindings]
enter = "actions:open"

[actions.open]
description = "Open the selected image with default viewer"
command = "xdg-open '{}' 2>/dev/null || open '{}'"
mode = "fork"

jj-bookmark

A channel to select from jujutsu (jj) bookmarks

Requirements: jj

Code: jj-bookmark.toml

[metadata]
name = "jj-bookmark"
description = "A channel to select from jujutsu (jj) bookmarks"
requirements = [ "jj",]

[source]
command = "jj bookmark list -T 'name ++ \"\\t\" ++ self.normal_target().change_id().shortest(8) ++ \"\\n\"'"
display = "{split:\t:0}"
output = "{split:\t:0}"

[preview]
command = "jj log --color=always --no-graph -r '{split:\t:0}'"

[keybindings]
enter = "actions:edit"
ctrl-d = "actions:delete"
ctrl-s = "actions:set"
ctrl-f = "actions:forget"
ctrl-g = "actions:track"

[actions.edit]
description = "Edit the change at the selected bookmark"
command = "jj edit '{split:\t:0}'"
mode = "execute"

[actions.delete]
description = "Delete the selected bookmark"
command = "jj bookmark delete '{split:\t:0}'"
mode = "execute"

[actions.set]
description = "Move the selected bookmark to the working copy"
command = "jj bookmark set '{split:\t:0}' -r @"
mode = "execute"

[actions.forget]
description = "Forget the selected bookmark (without deleting it on the remote)"
command = "jj bookmark forget '{split:\t:0}'"
mode = "execute"

[actions.track]
description = "Track the remote counterpart of the selected bookmark"
command = "jj bookmark track '{split:\t:0}@origin'"
mode = "execute"

jj-diff

A channel to select files changed in the jujutsu (jj) working copy

tv running the jj-diff channel Requirements: jj

Code: jj-diff.toml

[metadata]
name = "jj-diff"
description = "A channel to select files changed in the jujutsu (jj) working copy"
requirements = [ "jj",]

[source]
command = "jj diff --name-only"

[preview]
command = "jj diff --color always '{}'"

[keybindings]
ctrl-r = "actions:restore"
ctrl-e = "actions:edit"
ctrl-s = "actions:squash"
ctrl-a = "actions:absorb"

[actions.restore]
description = "Discard changes in the selected file"
command = "jj restore '{}'"
mode = "fork"

[actions.edit]
description = "Open the selected file in editor"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

[actions.squash]
description = "Squash changes to the selected file into the parent change"
command = "jj squash -- '{}'"
mode = "fork"

[actions.absorb]
description = "Absorb changes to the selected file into the appropriate ancestor"
command = "jj absorb -- '{}'"
mode = "fork"

jj-files

A channel to list the files tracked in the jujutsu (jj) working copy

tv running the jj-files channel Requirements: jj, bat

Code: jj-files.toml

[metadata]
name = "jj-files"
description = "A channel to list the files tracked in the jujutsu (jj) working copy"
requirements = [ "jj", "bat",]

[source]
command = "jj file list"

[preview]
command = "bat -n --color=always '{}'"

[keybindings]
ctrl-e = "actions:edit"
ctrl-r = "actions:restore"

[preview.env]
BAT_THEME = "ansi"

[actions.edit]
description = "Open the selected file in editor"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

[actions.restore]
description = "Discard changes to the selected file"
command = "jj restore '{}'"
mode = "fork"

jj-log

A channel to select from jujutsu (jj) log entries

tv running the jj-log channel Requirements: jj

Code: jj-log.toml

[metadata]
name = "jj-log"
description = "A channel to select from jujutsu (jj) log entries"
requirements = [ "jj",]

[source]
command = "jj log --color=always --no-graph -r 'all()' -T 'change_id.shortest(8) ++ \"\\t\" ++ author.name() ++ \"\\t\" ++ format_timestamp(author.timestamp()) ++ \"\\t\" ++ description.first_line() ++ \"\\n\"'"
display = "{strip_ansi|split:\t:0} {strip_ansi|split:\t:3}"
output = "{strip_ansi|split:\t:0}"
ansi = true
no_sort = true
frecency = false

[preview]
command = "jj show --color=always '{strip_ansi|split:\t:0}'"

[keybindings]
enter = "actions:edit"
ctrl-i = "actions:insert_before"
ctrl-a = "actions:insert_after"
ctrl-shift-d = "actions:diff"
ctrl-s = "actions:squash"
ctrl-d = "actions:abandon"
ctrl-e = "actions:describe"
ctrl-b = "actions:rebase"

[actions.edit]
description = "Edit the selected change (move working copy to it)"
command = "jj edit '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.insert_before]
description = "Insert a new change before the selected change"
command = "jj new --insert-before '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.insert_after]
description = "Insert a new change after the selected change"
command = "jj new --insert-after '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.diff]
description = "Show diff of the selected change"
command = "jj diff --color=always -r '{strip_ansi|split:\t:0}' | less -R"
shell = "bash"
mode = "execute"

[actions.squash]
description = "Squash the selected change into its parent"
command = "jj squash -r '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.abandon]
description = "Abandon the selected change"
command = "jj abandon '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.describe]
description = "Edit the description of the selected change"
command = "jj describe '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.rebase]
description = "Rebase the selected change onto the working copy"
command = "jj rebase -r '{strip_ansi|split:\t:0}' -d @"
mode = "execute"

jj-op-log

A channel to select from jujutsu (jj) operation log entries (equivalent to git reflog)

tv running the jj-op-log channel Requirements: jj

Code: jj-op-log.toml

[metadata]
name = "jj-op-log"
description = "A channel to select from jujutsu (jj) operation log entries (equivalent to git reflog)"
requirements = [ "jj",]

[source]
command = "jj op log --color=always --no-graph -T 'id.short(8) ++ \"\\t\" ++ format_timestamp(time.start()) ++ \"\\t\" ++ description ++ \"\\n\"'"
display = "{strip_ansi|split:\t:0} {strip_ansi|split:\t:2}"
output = "{strip_ansi|split:\t:0}"
ansi = true
no_sort = true
frecency = false

[preview]
command = "jj op show --color=always '{strip_ansi|split:\t:0}'"

[keybindings]
ctrl-r = "actions:restore"
ctrl-z = "actions:undo"

[actions.restore]
description = "Restore the repository to the state at the selected operation"
command = "jj op restore '{strip_ansi|split:\t:0}'"
mode = "execute"

[actions.undo]
description = "Undo the selected operation"
command = "jj op undo '{strip_ansi|split:\t:0}'"
mode = "execute"

jj-remotes

List and manage jujutsu (jj) git remotes

Requirements: jj

Code: jj-remotes.toml

[metadata]
name = "jj-remotes"
description = "List and manage jujutsu (jj) git remotes"
requirements = [ "jj",]

[source]
command = "jj git remote list"
output = "{split: :0}"

[preview]
command = "jj bookmark list --all-remotes | grep '@{split: :0}'"
shell = "bash"

[keybindings]
ctrl-f = "actions:fetch"
ctrl-d = "actions:remove"

[actions.fetch]
description = "Fetch from the selected remote"
command = "jj git fetch --remote '{split: :0}'"
mode = "execute"

[actions.remove]
description = "Remove the selected remote"
command = "jj git remote remove '{split: :0}'"
mode = "execute"

jj-workspaces

A channel to select from jujutsu (jj) workspaces

Requirements: jj

Code: jj-workspaces.toml

[metadata]
name = "jj-workspaces"
description = "A channel to select from jujutsu (jj) workspaces"
requirements = [ "jj",]

[source]
command = "jj workspace list --ignore-working-copy -T 'name ++ \"\\t\" ++ root ++ \"\\n\"'"
display = "{split:\t:0}"
output = "{split:\t:0}"

[preview]
command = "cd '{split:\t:1}' && jj log --color=always --no-graph -r '::@' --ignore-working-copy -T 'change_id.shortest(8) ++ \"\\t\" ++ description.first_line() ++ \"\\n\"'"

[keybindings]
enter = "actions:cd"
ctrl-d = "actions:forget"

[actions.cd]
description = "Change to the selected workspace directory"
command = "cd '{split:\t:1}' && $SHELL"
mode = "execute"

[actions.forget]
description = "Forget the selected workspace and remove its directory"
command = "jj workspace forget '{split:\t:0}' && rm -rf '{split:\t:1}'"
mode = "execute"

journal

Browse systemd journal log identifiers and their logs

Requirements: journalctl

Code: journal.toml

[metadata]
name = "journal"
description = "Browse systemd journal log identifiers and their logs"
requirements = [ "journalctl",]

[source]
command = "journalctl --field SYSLOG_IDENTIFIER 2>/dev/null | sort -f"

[preview]
command = "journalctl -b --no-pager -o short-iso -n 50 SYSLOG_IDENTIFIER='{}' 2>/dev/null"

[ui]
layout = "portrait"

[ui.preview_panel]
size = 70

[actions.logs]
description = "Follow live logs for the selected identifier"
command = "journalctl -f SYSLOG_IDENTIFIER='{}'"
mode = "execute"

[actions.full]
description = "View all logs for the selected identifier in a pager"
command = "journalctl -b --no-pager -o short-iso SYSLOG_IDENTIFIER='{}' | less"
mode = "fork"

just-recipes

A channel to select recipes from Justfiles

tv running the just-recipes channel Requirements: just

Code: just-recipes.toml

[metadata]
name = "just-recipes"
description = "A channel to select recipes from Justfiles"
requirements = [ "just",]

[source]
command = [ "just --summary | tr '[:blank:]' '\n'",]

[preview]
command = "just -s {}"

[keybindings]
f5 = "actions:execute-recipe"

[actions.execute-recipe]
description = "Execute a justfile recipe"
command = "just {}"
mode = "execute"

k8s-contexts

List and switch kubectl contexts

Requirements: kubectl

Code: k8s-contexts.toml

[metadata]
name = "k8s-contexts"
description = "List and switch kubectl contexts"
requirements = [ "kubectl",]

[source]
command = "kubectl config get-contexts -o name"

[preview]
command = "kubectl config view --minify --context='{}' -o yaml"

[ui]
layout = "portrait"

[keybindings]
enter = "actions:use"
ctrl-d = "actions:delete"

[actions.use]
description = "Switch to the selected context"
command = "kubectl config use-context '{}'"
mode = "execute"

[actions.delete]
description = "Delete the selected context"
command = "kubectl config delete-context '{}'"
mode = "execute"

k8s-deployments

List and preview Deployments in a Kubernetes Cluster.

The first source lists only from the current namespace, while the second lists from all.

Keybindings

Press ctrl-d to delete the selected Deployment.

tv running the k8s-deployments channel Requirements: kubectl

Code: k8s-deployments.toml

[metadata]
name = "k8s-deployments"
description = "List and preview Deployments in a Kubernetes Cluster.\n\nThe first source lists only from the current namespace, while the second lists from all.\n\nKeybindings\n\nPress `ctrl-d` to delete the selected Deployment.\n"
requirements = [ "kubectl",]

[source]
output = "{1}"
[[source.command]]
name = "Current ns"
run = "kubectl get deployments -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}'\n"

[[source.command]]
name = "All namespaces"
run = "kubectl get deployments -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}' --all-namespaces\n"

[preview]
command = "kubectl describe -n {0} deployments/{1}"

[ui]
layout = "portrait"

[keybindings]
ctrl-d = "actions:delete"

[ui.preview_panel]
size = 60

[actions.delete]
description = "Delete the selected Deployment"
command = "kubectl delete -n {0} deployments/{1}"
mode = "execute"

k8s-pods

List and preview Pods in a Kubernetes Cluster.

The first source lists only from the current namespace, while the second lists from all.

Keybindings

Press ctrl-e to execute shell inside the selected Pod. Press ctrl-d to delete the selected Pod. Press ctrl-l to print and follow the logs of the selected Pod.

tv running the k8s-pods channel Requirements: kubectl

Code: k8s-pods.toml

[metadata]
name = "k8s-pods"
description = "List and preview Pods in a Kubernetes Cluster.\n\nThe first source lists only from the current namespace, while the second lists from all.\n\nKeybindings\n\nPress `ctrl-e` to execute shell inside the selected Pod.\nPress `ctrl-d` to delete the selected Pod.\nPress `ctrl-l` to print and follow the logs of the selected Pod.\n"
requirements = [ "kubectl",]

[source]
output = "{1}"
[[source.command]]
name = "Current ns"
run = "kubectl get pods -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}'\n"

[[source.command]]
name = "All namespaces"
run = "kubectl get pods -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}' --all-namespaces\n"

[preview]
command = "kubectl describe -n {0} pods/{1}"

[ui]
layout = "portrait"

[keybindings]
ctrl-d = "actions:delete"
ctrl-e = "actions:exec"
ctrl-l = "actions:logs"

[ui.preview_panel]
size = 60

[actions.exec]
description = "Execute shell inside the selected Pod"
command = "kubectl exec -i -t -n {0} pods/{1} -- /bin/sh"
mode = "execute"

[actions.delete]
description = "Delete the selected Pod"
command = "kubectl delete -n {0} pods/{1}"
mode = "execute"

[actions.logs]
description = "Follow logs of the selected Pod"
command = "kubectl logs -f -n {0} pods/{1}"
mode = "execute"

k8s-services

List and preview Services in a Kubernetes Cluster.

The first source lists only from the current namespace, while the second lists from all.

keybindings

Press ctrl-d to delete the selected Service.

tv running the k8s-services channel Requirements: kubectl

Code: k8s-services.toml

[metadata]
name = "k8s-services"
description = "List and preview Services in a Kubernetes Cluster.\n\nThe first source lists only from the current namespace, while the second lists from all.\n\nkeybindings\n\nPress `ctrl-d` to delete the selected Service.\n"
requirements = [ "kubectl",]

[source]
output = "{1}"
[[source.command]]
name = "Current ns"
run = "kubectl get services -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}'\n"

[[source.command]]
name = "All namespaces"
run = "kubectl get services -o go-template --template '{{range .items}}{{.metadata.namespace}} {{.metadata.name}}{{\"\\n\"}}{{end}}' --all-namespaces\n"

[preview]
command = "kubectl describe -n {0} services/{1}"

[ui]
layout = "portrait"

[keybindings]
ctrl-d = "actions:delete"

[ui.preview_panel]
size = 60

[actions.delete]
description = "Delete the selected Service"
command = "kubectl delete -n {0} services/{1}"
mode = "execute"

launchd-services

List and manage launchd services on macOS (equivalent to systemd)

tv running the launchd-services channel Requirements: launchctl

Code: launchd-services.toml

[metadata]
name = "launchd-services"
description = "List and manage launchd services on macOS (equivalent to systemd)"
requirements = [ "launchctl",]

[source]
command = "launchctl list | tail -n +2 | awk '{print $3\"\\t\"$1\"\\t\"$2}'"
display = "{split:\t:0} ({split:\t:1})"

[preview]
command = "launchctl print gui/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl print user/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl print system/'{split:\t:0}' 2>/dev/null || echo 'Service not found'"

[ui]
layout = "portrait"

[keybindings]
ctrl-s = "actions:start"
ctrl-k = "actions:stop"
ctrl-r = "actions:restart"
ctrl-e = "actions:enable"
ctrl-d = "actions:disable"
ctrl-f = "actions:plist"
ctrl-l = "actions:log"

[actions.start]
description = "Start the selected service"
command = "launchctl start '{split:\t:0}'"
mode = "execute"

[actions.stop]
description = "Stop the selected service"
command = "launchctl stop '{split:\t:0}'"
mode = "execute"

[actions.restart]
description = "Kill and restart the selected service"
command = "launchctl kickstart -k gui/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl kickstart -k user/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl kickstart -k system/'{split:\t:0}'"
shell = "bash"
mode = "execute"

[actions.enable]
description = "Enable the selected service"
command = "launchctl enable gui/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl enable user/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl enable system/'{split:\t:0}'"
shell = "bash"
mode = "execute"

[actions.disable]
description = "Disable the selected service"
command = "launchctl disable gui/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl disable user/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl disable system/'{split:\t:0}'"
shell = "bash"
mode = "execute"

[actions.plist]
description = "View the plist file for the selected service"
command = "plist=$( (launchctl print gui/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl print user/$(id -u)/'{split:\t:0}' 2>/dev/null || launchctl print system/'{split:\t:0}' 2>/dev/null) | sed -n 's/^\\tpath = //p'); if [ -n \"$plist\" ]; then $EDITOR \"$plist\"; else echo 'Plist not found'; fi"
shell = "bash"
mode = "execute"

[actions.log]
description = "Show recent logs for the selected service"
command = "log show --predicate 'subsystem == \"{split:\\t:0}\" OR senderImagePath CONTAINS \"{split:\\t:0}\"' --last 1h --debug --info | less"
shell = "bash"
mode = "execute"

make-targets

List and run Makefile targets

Requirements: make, awk

Code: make-targets.toml

[metadata]
name = "make-targets"
description = "List and run Makefile targets"
requirements = [ "make", "awk",]

[source]
command = "make -pRrq 2>/dev/null | awk -F: '/^[a-zA-Z0-9][^$#\\/\\t=]*:([^=]|$)/ {split($1,a,\" \"); print a[1]}' | sort -u | grep -v '^Makefile$'"

[preview]
command = "awk '/^{}[[:space:]]*:/{found=1} found{print; if(/^[^\\t]/ && NR>1 && !/^{}[[:space:]]*:/) exit}' Makefile"

[keybindings]
enter = "actions:run"

[actions.run]
description = "Run the selected make target"
command = "make {}"
mode = "execute"

man-pages

Browse and preview system manual pages

tv running the man-pages channel Requirements: apropos, man

Code: man-pages.toml

[metadata]
name = "man-pages"
description = "Browse and preview system manual pages"
requirements = [ "apropos", "man",]

[source]
command = "apropos ."

[preview]
command = "man '{0}'"

[keybindings]
enter = "actions:open"

[ui]
layout = "portrait"

[preview.env]
MANWIDTH = "80"

[actions.open]
description = "Open the selected man page in the system pager"
command = "man '{0}'"
mode = "execute"

[ui.preview_panel]
header = "{0}"

mounts

List mounted filesystems

Requirements: df, awk

Code: mounts.toml

[metadata]
name = "mounts"
description = "List mounted filesystems"
requirements = [ "df", "awk",]

[source]
command = "df -h --output=target,fstype,size,used,avail,pcent 2>/dev/null | tail -n +2"
display = "{split: :0}"

[preview]
command = "df -h '{}' && echo && ls -la '{}' 2>/dev/null | head -20"

[keybindings]
enter = "actions:cd"

[actions.cd]
description = "Open a shell in the selected mount point"
command = "cd '{}' && $SHELL"
mode = "execute"

node-packages

Browse local node_modules dependencies

Requirements: node

Code: node-packages.toml

[metadata]
name = "node-packages"
description = "Browse local node_modules dependencies"
requirements = [ "node",]

[source]
command = "ls -d node_modules/*/ 2>/dev/null | sed 's|node_modules/||;s|/$||' | grep -v '^\\.'"
output = "{}"

[preview]
command = "cat 'node_modules/{}/package.json' 2>/dev/null | jq -C '{name, version, description, license, homepage, main}'"

[actions.readme]
description = "View the package README"
command = "cat node_modules/{}/README.md 2>/dev/null | less"
mode = "execute"

[actions.homepage]
description = "Open the package homepage"
command = "node -e \"const p=require('./node_modules/{}/package.json'); const u=p.homepage||'https://www.npmjs.com/package/'+p.name; require('child_process').exec('xdg-open '+u)\""
mode = "fork"

npm-packages

List globally installed npm packages

Requirements: npm

Code: npm-packages.toml

[metadata]
name = "npm-packages"
description = "List globally installed npm packages"
requirements = [ "npm",]

[source]
command = "npm list -g --depth=0 --parseable 2>/dev/null | tail -n +2 | xargs -I{} basename {}"

[preview]
command = "npm info '{}' 2>/dev/null | head -30"

[actions.uninstall]
description = "Uninstall the selected global package"
command = "npm uninstall -g '{}'"
mode = "execute"

[actions.update]
description = "Update the selected global package"
command = "npm update -g '{}'"
mode = "execute"

npm-scripts

List and run npm scripts from package.json

Requirements: jq

Code: npm-scripts.toml

[metadata]
name = "npm-scripts"
description = "List and run npm scripts from package.json"
requirements = [ "jq",]

[source]
command = "jq -r '.scripts | to_entries[] | \"\\(.key)\\t\\(.value)\"' package.json 2>/dev/null"
display = "{split:\\t:0}"

[preview]
command = "jq -r '.scripts[\"{split:\\t:0}\"]' package.json"

[keybindings]
enter = "actions:run"

[ui.preview_panel]
size = 30

[actions.run]
description = "Run the selected npm script"
command = "npm run '{split:\\t:0}'"
mode = "execute"

nu-history

A channel to select from your nu history

Requirements: None

Code: nu-history.toml

[metadata]
name = "nu-history"
description = "A channel to select from your nu history"

[source]
command = "nu -c 'open $nu.history-path | lines | uniq | reverse | to text'"
no_sort = true
frecency = false

opencode-sessions

Browse and resume OpenCode sessions

tv running the opencode-sessions channel Requirements: opencode, jq

Code: opencode-sessions.toml

[metadata]
name = "opencode-sessions"
description = "Browse and resume OpenCode sessions"
requirements = [ "opencode", "jq",]

[source]
command = "opencode session list --format json | jq -r '.[] | \"\\(.id)\\t\\(.title)\\t\\(.directory)\"' "
display = "{split:\t:1}  ({split:\t:2})"
output = "{split:\t:0}"

[preview]
command = "opencode session list --format json | jq -r '.[] | select(.id == \"{split:\\t:0}\") | \"TITLE:     \\(.title)\\nID:        \\(.id)\\nPROJECT:   \\(.projectId)\\nDIRECTORY: \\(.directory)\\nUPDATED:   \\((.updated / 1000) | strftime(\"%Y-%m-%d %H:%M:%S\"))\"' "

[ui]
layout = "landscape"

[keybindings]
shortcut = "f4"
enter = "actions:resume"
ctrl-d = "actions:delete"

[ui.preview_panel]
size = 60
header = "Session: {split:\t:1}"
border_type = "rounded"

[actions.resume]
description = "Resume session"
command = "opencode -s {split:\t:0}"
mode = "execute"

[actions.delete]
description = "Delete session"
command = "bash -c 'echo \"Delete {split:\\t:1}?\" && read -p \"[y/N]: \" conf && [[ $conf == \"y\" ]] && opencode session delete {split:\\t:0} ' "
mode = "execute"

pacman-packages

List and manage installed pacman packages

Requirements: pacman

Code: pacman-packages.toml

[metadata]
name = "pacman-packages"
description = "List and manage installed pacman packages"
requirements = [ "pacman",]

[source]
command = "pacman -Q"
output = "{split: :0}"

[preview]
command = "pacman -Qi '{split: :0}' 2>/dev/null"

[actions.remove]
description = "Remove the selected package"
command = "sudo pacman -R '{split: :0}'"
mode = "execute"

[actions.files]
description = "List files owned by the selected package"
command = "pacman -Ql '{split: :0}' | less"
mode = "execute"

path

Investigate PATH contents

Requirements: fd, bat

Code: path.toml

[metadata]
name = "path"
description = "Investigate PATH contents"
requirements = [ "fd", "bat",]

[source]
command = "printf '%s\n' \"$PATH\" | tr ':' '\n'"

[preview]
command = "fd -tx -d1 . \"{}\" -X printf \"%s\n\" \"{/}\" | sort -f | bat -n --color=always"

[actions.cd]
description = "Open a shell in the selected PATH directory"
command = "cd '{}' && $SHELL"
mode = "execute"

pdf-files

Browse PDF files

Requirements: fd, pdftotext

Code: pdf-files.toml

[metadata]
name = "pdf-files"
description = "Browse PDF files"
requirements = [ "fd", "pdftotext",]

[source]
[[source.command]]
name = "Default"
run = "fd -t f -e pdf ."

[[source.command]]
name = "Hidden"
run = "fd -t f -e pdf -H ."

[preview]
command = "pdftotext -l 2 -layout '{}' - 2>/dev/null | head -100 || file '{}'"

[ui]
layout = "portrait"

[keybindings]
enter = "actions:open"

[actions.open]
description = "Open the selected PDF with default viewer"
command = "xdg-open '{}' 2>/dev/null || open '{}'"
mode = "fork"

pip-packages

List installed Python packages

Requirements: pip

Code: pip-packages.toml

[metadata]
name = "pip-packages"
description = "List installed Python packages"
requirements = [ "pip",]

[source]
command = "pip list --format=freeze 2>/dev/null | cut -d= -f1"

[preview]
command = "pip show '{}'"

[ui]
layout = "portrait"

[keybindings]
ctrl-u = "actions:upgrade"
ctrl-d = "actions:uninstall"

[actions.upgrade]
description = "Upgrade the selected package"
command = "pip install --upgrade '{}'"
mode = "execute"

[actions.uninstall]
description = "Uninstall the selected package"
command = "pip uninstall '{}'"
mode = "execute"

podman-containers

List and manage Podman containers

Requirements: podman, jq

Code: podman-containers.toml

[metadata]
name = "podman-containers"
description = "List and manage Podman containers"
requirements = [ "podman", "jq",]

[source]
display = "{split:\t:0} ({split:\t:2})"
output = "{split:\t:0}"
[[source.command]]
name = "Running"
run = "podman ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'"

[[source.command]]
name = "All"
run = "podman ps -a --format '{{.Names}}\t{{.Image}}\t{{.Status}}'"

[preview]
command = "podman inspect '{split:\t:0}' | jq -C '.[0] | {Name, State, Config: {Image: .Config.Image, Cmd: .Config.Cmd}, NetworkSettings: {IPAddress: .NetworkSettings.IPAddress}}'"

[ui]
layout = "portrait"

[keybindings]
ctrl-s = "actions:start"
f2 = "actions:stop"
ctrl-r = "actions:restart"
ctrl-l = "actions:logs"
ctrl-e = "actions:exec"
ctrl-d = "actions:remove"

[actions.start]
description = "Start the selected container"
command = "podman start '{split:\t:0}'"
mode = "fork"

[actions.stop]
description = "Stop the selected container"
command = "podman stop '{split:\t:0}'"
mode = "fork"

[actions.restart]
description = "Restart the selected container"
command = "podman restart '{split:\t:0}'"
mode = "fork"

[actions.logs]
description = "Follow logs of the selected container"
command = "podman logs -f '{split:\t:0}'"
mode = "execute"

[actions.exec]
description = "Execute shell in the selected container"
command = "podman exec -it '{split:\t:0}' /bin/sh"
mode = "execute"

[actions.remove]
description = "Remove the selected container"
command = "podman rm '{split:\t:0}'"
mode = "execute"

podman-images

A channel to select from Podman images

Requirements: podman, jq

Code: podman-images.toml

[metadata]
name = "podman-images"
description = "A channel to select from Podman images"
requirements = [ "podman", "jq",]

[source]
command = "podman images --format '{{.Repository}}:{{.Tag}} {{.ID}}'"
output = "{split: :-1}"

[preview]
command = "podman image inspect '{split: :-1}' | jq -C"

[ui]
layout = "portrait"

[keybindings]
ctrl-r = "actions:run"
ctrl-d = "actions:remove"
ctrl-s = "actions:shell"

[actions.run]
description = "Run a container from the selected image"
command = "podman run -it '{split: :-1}'"
mode = "execute"

[actions.shell]
description = "Run a shell in the selected image"
command = "podman run -it '{split: :-1}' /bin/sh"
mode = "execute"

[actions.remove]
description = "Remove the selected image"
command = "podman rmi '{split: :-1}'"
mode = "execute"

podman-networks

List and manage Podman networks

Requirements: podman, jq

Code: podman-networks.toml

[metadata]
name = "podman-networks"
description = "List and manage Podman networks"
requirements = [ "podman", "jq",]

[source]
command = "podman network ls --format '{{.Name}}\t{{.Driver}}\t{{.Internal}}'"
display = "{split:\t:0} ({split:\t:1})"
output = "{split:\t:0}"

[preview]
command = "podman network inspect '{split:\t:0}' | jq -C '.[0] | {name, driver, subnets, dns_enabled, internal}'"

[ui]
layout = "portrait"

[actions.remove]
description = "Remove the selected network"
command = "podman network rm '{split:\t:0}'"
mode = "execute"

podman-volumes

List and manage Podman volumes

Requirements: podman, jq

Code: podman-volumes.toml

[metadata]
name = "podman-volumes"
description = "List and manage Podman volumes"
requirements = [ "podman", "jq",]

[source]
command = "podman volume ls --format '{{.Name}}\t{{.Driver}}'"
display = "{split:\t:0} ({split:\t:1})"
output = "{split:\t:0}"

[preview]
command = "podman volume inspect '{split:\t:0}' | jq -C '.[0]'"

[ui]
layout = "portrait"

[actions.remove]
description = "Remove the selected volume"
command = "podman volume rm '{split:\t:0}'"
mode = "execute"

[actions.inspect]
description = "Inspect the selected volume in a pager"
command = "podman volume inspect '{split:\t:0}' | jq -C '.[0]' | less -R"
mode = "execute"

ports

List listening ports and associated processes

Requirements: ss, awk

Code: ports.toml

[metadata]
name = "ports"
description = "List listening ports and associated processes"
requirements = [ "ss", "awk",]

[source]
command = "ss -tlnp 2>/dev/null | tail -n +2 | awk '{gsub(/.*:/,\"\",$4); print $4, $1, $6}' | sed 's/users:((\"//; s/\".*//'"
display = "{split: :0} ({split: :2})"

[preview]
command = "ss -tlnp 2>/dev/null | grep ':{split: :0} ' | head -20"

[ui.preview_panel]
size = 40

[actions.kill]
description = "Kill the process listening on the selected port"
command = "fuser -k {split: :0}/tcp"
mode = "execute"

procs

A channel to find and manage running processes

Requirements: ps, awk

Code: procs.toml

[metadata]
name = "procs"
description = "A channel to find and manage running processes"
requirements = [ "ps", "awk",]

[source]
command = "ps -e -o pid=,ucomm= | awk '{print $1, $2}'"
display = "{split: :1}"
output = "{split: :0}"

[preview]
command = "ps -p '{split: :0}' -o user,pid,ppid,state,%cpu,%mem,command | fold"

[keybindings]
ctrl-k = "actions:kill"
f2 = "actions:term"
ctrl-s = "actions:stop"
ctrl-c = "actions:cont"

[actions.kill]
description = "Kill the selected process (SIGKILL)"
command = "kill -9 {split: :0}"
mode = "execute"

[actions.term]
description = "Terminate the selected process (SIGTERM)"
command = "kill -15 {split: :0}"
mode = "execute"

[actions.stop]
description = "Stop/pause the selected process (SIGSTOP)"
command = "kill -STOP {split: :0}"
mode = "fork"

[actions.cont]
description = "Continue/resume the selected process (SIGCONT)"
command = "kill -CONT {split: :0}"
mode = "fork"

python-venvs

Find Python virtual environments

Requirements: find

Code: python-venvs.toml

[metadata]
name = "python-venvs"
description = "Find Python virtual environments"
requirements = [ "find",]

[source]
command = "find ~ -maxdepth 5 -type f -name 'pyvenv.cfg' 2>/dev/null | xargs -I{} dirname {}"

[preview]
command = "cat '{}/pyvenv.cfg' 2>/dev/null && echo '' && echo 'Packages:' && '{}/bin/pip' list --format=columns 2>/dev/null | head -20"

[actions.activate]
description = "Open a shell with the selected venv activated"
command = "source '{}/bin/activate' && $SHELL"
mode = "execute"

[actions.packages]
description = "List all packages in the selected venv"
command = "'{}/bin/pip' list | less"
mode = "execute"

recent-files

List recently modified files (via git or filesystem)

Requirements: git, bat

Code: recent-files.toml

[metadata]
name = "recent-files"
description = "List recently modified files (via git or filesystem)"
requirements = [ "git", "bat",]

[source]
[[source.command]]
name = "Recent"
run = "git diff --name-only HEAD~10 HEAD 2>/dev/null || find . -type f -mtime -7 -not -path '*/.*' 2>/dev/null | head -100"

[[source.command]]
name = "Last hour"
run = "find . -type f -mmin -60 -not -path '*/.*' 2>/dev/null | head -100"

[preview]
command = "bat -n --color=always '{}'"

[keybindings]
enter = "actions:edit"

[preview.env]
BAT_THEME = "ansi"

[actions.edit]
description = "Open the selected file in editor"
command = "${EDITOR:-vim} '{}'"
shell = "bash"
mode = "execute"

rustup

Manage Rust toolchains

Requirements: rustup

Code: rustup.toml

[metadata]
name = "rustup"
description = "Manage Rust toolchains"
requirements = [ "rustup",]

[source]
command = "rustup toolchain list"

[preview]
command = "rustup run '{split: :0}' rustc --version --verbose 2>/dev/null"

[actions.default]
description = "Set the selected toolchain as default"
command = "rustup default '{split: :0}'"
mode = "execute"

[actions.uninstall]
description = "Uninstall the selected toolchain"
command = "rustup toolchain uninstall '{split: :0}'"
mode = "execute"

sesh

Session manager integrating tmux sessions, zoxide directories, and config paths

tv running the sesh channel Requirements: sesh, fd

Code: sesh.toml

[metadata]
name = "sesh"
description = "Session manager integrating tmux sessions, zoxide directories, and config paths"
requirements = [ "sesh", "fd",]

[source]
ansi = true
frecency = false
no_sort = true
output = "{strip_ansi|split: :1..|join: }"
[[source.command]]
name = "All"
run = "sesh list --icons"

[[source.command]]
name = "Tmux"
run = "sesh list -t --icons"

[[source.command]]
name = "Configs"
run = "sesh list -c --icons"

[[source.command]]
name = "Zoxide"
run = "sesh list -z --icons"

[[source.command]]
name = "Directories"
run = "fd -H -d 2 -t d -E .Trash . ~"

[preview]
command = "sesh preview '{strip_ansi|split: :1..|join: }'"

[keybindings]
enter = "actions:connect"
ctrl-d = [ "actions:kill_session", "reload_source",]

[actions.connect]
description = "Connect to selected session"
command = "sesh connect '{strip_ansi|split: :1..|join: }'"
mode = "execute"

[actions.kill_session]
description = "Kill selected tmux session (press Ctrl+r to reload)"
command = "tmux kill-session -t '{strip_ansi|split: :1..|join: }'"
mode = "fork"

ssh-hosts

A channel to select hosts from your SSH config

tv running the ssh-hosts channel Requirements: grep, tr, cut, awk

Code: ssh-hosts.toml

[metadata]
name = "ssh-hosts"
description = "A channel to select hosts from your SSH config"
requirements = [ "grep", "tr", "cut", "awk",]

[source]
command = "grep -E '^Host(name)? ' $HOME/.ssh/config | tr -s ' ' | cut -d' ' -f2- | tr ' ' '\n' | grep -v '^$'"

[preview]
command = "awk '/^Host / { found=0 } /^Host (.*[[:space:]])?'{}'([[:space:]].*)?$/ { found=1 } found' $HOME/.ssh/config"

[keybindings]
enter = "actions:connect"

[actions.connect]
description = "SSH into the selected host"
command = "ssh '{}'"
mode = "execute"

systemd-units

List and manage systemd services

Requirements: systemctl

Code: systemd-units.toml

[metadata]
name = "systemd-units"
description = "List and manage systemd services"
requirements = [ "systemctl",]

[source]
display = "{split: :0}"
[[source.command]]
name = "Active"
run = "systemctl list-units --type=service --no-pager --no-legend --plain"

[[source.command]]
name = "All"
run = "systemctl list-units --type=service --all --no-pager --no-legend --plain"

[preview]
command = "systemctl status '{split: :0}' --no-pager"

[ui]
layout = "portrait"

[keybindings]
ctrl-s = "actions:start"
f2 = "actions:stop"
ctrl-r = "actions:restart"
ctrl-e = "actions:enable"
ctrl-d = "actions:disable"

[actions.start]
description = "Start the selected service"
command = "sudo systemctl start '{split: :0}'"
mode = "execute"

[actions.stop]
description = "Stop the selected service"
command = "sudo systemctl stop '{split: :0}'"
mode = "execute"

[actions.restart]
description = "Restart the selected service"
command = "sudo systemctl restart '{split: :0}'"
mode = "execute"

[actions.enable]
description = "Enable the selected service"
command = "sudo systemctl enable '{split: :0}'"
mode = "execute"

[actions.disable]
description = "Disable the selected service"
command = "sudo systemctl disable '{split: :0}'"
mode = "execute"

tailscale-exit-node

A channel to select a tailscale exit node

Requirements: tailscale, awk

Code: tailscale-exit-node.toml

[metadata]
name = "tailscale-exit-node"
description = "A channel to select a tailscale exit node"
requirements = [ "tailscale", "awk",]

[source]
command = "tailscale exit-node list | awk '/^[[:space:]]*[0-9]+\\./ {gsub(/^[[:space:]]+/, \"\"); print $1}'"

[preview]
command = "tailscale whois {}"

[keybindings]
enter = "actions:connect"

[actions.connect]
description = "Set selected host as exit node"
command = "tailscale set --exit-node='{}'"
mode = "execute"

tea-issues

List Gitea issues for the current repo

Requirements: tea, jq

Code: tea-issues.toml

[metadata]
name = "tea-issues"
description = "List Gitea issues for the current repo"
requirements = [ "tea", "jq",]

[source]
command = "tea issues list --output json --state open </dev/null | jq -r '.[] | \"\\u001b[32m#\\(.index)\\u001b[39m\" + \"\\t\\(.title) \\u001b[33m@\\(.author)\\u001b[39m\" + (if .labels != \"\" then \" \\u001b[35m\" + .labels + \"\\u001b[39m\" else \"\" end)'\n"
ansi = true
output = "{strip_ansi|split:#:1|split:\t:0}"

[ui]
layout = "portrait"

[preview]
command = "tea issues --output json {strip_ansi|split:#:1|split:\\t:0} </dev/null | jq -r '\n.title,\n\"#\" + (.index | tostring),\n\"\",\n\"\\u001b[36mStatus:\\u001b[39m    \\u001b[32m\" + .state + \"\\u001b[39m\",\n\"\\u001b[36mAuthor:\\u001b[39m    \\u001b[33m\" + .user + \"\\u001b[39m\",\n\"\\u001b[36mCreated:\\u001b[39m   \" + .created[:10],\n(if (.labels | length) > 0 then \"\\u001b[36mLabels:\\u001b[39m    \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"]\n| join(\" \")) else empty end),\n\"\",\n\"\\u001b[90m────────────────────────────────────────────────────────────\\u001b[39m\",\n\"\",\n(.body // \"\")\n'\n"

[ui.preview_panel]
header = "{strip_ansi|split:\\t:1}"

[actions.close]
description = "Close the selected issue"
command = "tea issues close {strip_ansi|split:#:1|split:\t:0}"
mode = "fork"

tea-prs

List Gitea PRs for the current repo

Requirements: tea, jq

Code: tea-prs.toml

[metadata]
name = "tea-prs"
description = "List Gitea PRs for the current repo"
requirements = [ "tea", "jq",]

[source]
command = "tea pulls list --output json --state open </dev/null | jq -r '.[] | \"\\u001b[32m#\\(.index)\\u001b[39m\" + \"\\t\\(.title) \\u001b[33m@\\(.author)\\u001b[39m\" + (if .labels != \"\" then \" \\u001b[35m\" + .labels + \"\\u001b[39m\" else \"\" end)'\n"
ansi = true
output = "{strip_ansi|split:#:1|split:\t:0}"

[ui]
layout = "portrait"

[preview]
command = "tea pulls --output json {strip_ansi|split:#:1|split:\\t:0} </dev/null | jq -r '\n.title,\n\"#\" + (.index | tostring),\n\"\",\n\"\\u001b[36mStatus:\\u001b[39m     \\u001b[32m\" + .state + \"\\u001b[39m  \" + .base + \" ← \" + .head,\n\"\\u001b[36mAuthor:\\u001b[39m     \\u001b[33m\" + .user + \"\\u001b[39m\",\n\"\\u001b[36mCreated:\\u001b[39m    \" + .created[:10],\n\"\\u001b[36mUpdated:\\u001b[39m    \" + .updated[:10],\n(if (.labels | length) > 0 then \"\\u001b[36mLabels:\\u001b[39m     \" + ([.labels[] | \"\\u001b[35m\" + .name + \"\\u001b[39m\"] | join(\" \")) else empty end),\n\"\\u001b[36mMergeable:\\u001b[39m  \" + (if .mergeable then \"\\u001b[32m✓ Clean\\u001b[39m\" else \"\\u001b[31m✗ Dirty\\u001b[39m\" end),\n\"\",\n\"\\u001b[90m────────────────────────────────────────────────────────────\\u001b[39m\",\n\"\",\n(.body // \"\")\n'\n"

[ui.preview_panel]
header = "{strip_ansi|split:\\t:1}"

[actions.checkout]
description = "Checkout the PR branch locally"
command = "tea pulls checkout {strip_ansi|split:#:1|split:\t:0}"
mode = "execute"

[actions.merge]
description = "Merge the selected PR"
command = "tea pulls merge {strip_ansi|split:#:1|split:\t:0}"
mode = "execute"

text

A channel to find and select text from files

Requirements: rg, bat

Code: text.toml

[metadata]
name = "text"
description = "A channel to find and select text from files"
requirements = [ "rg", "bat",]

[source]
ansi = true
output = "{strip_ansi|split:\\::..2}"
[[source.command]]
name = "Default"
run = "rg . --no-heading --line-number --colors 'match:fg:white' --colors 'path:fg:blue' --color=always"

[[source.command]]
name = "Hidden"
run = "rg . --no-heading --line-number --hidden --colors 'match:fg:white' --colors 'path:fg:blue' --color=always"

[preview]
command = "bat -n --color=always '{strip_ansi|split:\\::0}'"
offset = "{strip_ansi|split:\\::1}"

[keybindings]
enter = "actions:edit"

[preview.env]
BAT_THEME = "ansi"

[ui.preview_panel]
header = "{strip_ansi|split:\\::..2}"

[actions.edit]
description = "Open file in editor at line"
command = "${EDITOR:-vim} '+{strip_ansi|split:\\::1}' '{strip_ansi|split:\\::0}'"
shell = "bash"
mode = "execute"

tldr

Browse and preview TLDR help pages for command-line tools

tv running the tldr channel Requirements: tldr

Code: tldr.toml

[metadata]
name = "tldr"
description = "Browse and preview TLDR help pages for command-line tools"
requirements = [ "tldr",]

[source]
command = "tldr --list"

[preview]
command = "tldr '{0}' --color always"

[ui]
layout = "portrait"

[keybindings]
ctrl-e = "actions:open"

[actions.open]
description = "Open the selected TLDR page"
command = "tldr '{0}'"
mode = "execute"

tmux-sessions

List and manage tmux sessions

Requirements: tmux

Code: tmux-sessions.toml

[metadata]
name = "tmux-sessions"
description = "List and manage tmux sessions"
requirements = [ "tmux",]

[source]
command = "tmux list-sessions -F '#{session_name}\t#{session_windows} windows\t#{session_created_string}'"
display = "{split:\t:0} ({split:\t:1})"
output = "{split:\t:0}"

[preview]
command = "tmux capture-pane -t '{split:\t:0}' -p 2>/dev/null || echo 'No preview available'"

[actions.attach]
description = "Attach to the selected session"
command = "tmux attach-session -t '{split:\t:0}'"
mode = "execute"

[actions.kill]
description = "Kill the selected session"
command = "tmux kill-session -t '{split:\t:0}'"
mode = "fork"

tmux-windows

List and switch between tmux windows

Requirements: tmux

Code: tmux-windows.toml

[metadata]
name = "tmux-windows"
description = "List and switch between tmux windows"
requirements = [ "tmux",]

[source]
command = "tmux list-windows -a -F '#{session_name}:#{window_index}\t#{window_name}\t#{pane_current_command}'"
display = "{split:\t:0} - {split:\t:1} ({split:\t:2})"
output = "{split:\t:0}"

[preview]
command = "tmux capture-pane -t '{split:\t:0}' -p 2>/dev/null || echo 'No preview available'"

[actions.select]
description = "Switch to the selected window"
command = "tmux select-window -t '{split:\t:0}'"
mode = "execute"

[actions.kill]
description = "Kill the selected window"
command = "tmux kill-window -t '{split:\t:0}'"
mode = "fork"

todo-comments

Find TODO, FIXME, HACK, and XXX comments in codebase

Requirements: rg, bat

Code: todo-comments.toml

[metadata]
name = "todo-comments"
description = "Find TODO, FIXME, HACK, and XXX comments in codebase"
requirements = [ "rg", "bat",]

[source]
command = "rg -n --color=always '(TODO|FIXME|HACK|XXX|BUG|WARN):?'"
ansi = true
output = "{strip_ansi|split:\\::..2}"

[preview]
command = "bat -n --color=always --highlight-line '{strip_ansi|split:\\::1}' '{strip_ansi|split:\\::0}'"
offset = "{strip_ansi|split:\\::1}"

[keybindings]
enter = "actions:edit"

[preview.env]
BAT_THEME = "ansi"

[ui.preview_panel]
header = "{strip_ansi|split:\\::..2}"

[actions.edit]
description = "Open file in editor at the comment"
command = "${EDITOR:-vim} '+{strip_ansi|split:\\::1}' '{strip_ansi|split:\\::0}'"
shell = "bash"
mode = "execute"

trash

Browse and restore trashed files

Requirements: trash-list, trash-restore

Code: trash.toml

[metadata]
name = "trash"
description = "Browse and restore trashed files"
requirements = [ "trash-list", "trash-restore",]

[source]
command = "trash-list 2>/dev/null"
no_sort = true
frecency = false

[preview]
command = "echo '{}'"

[ui]
layout = "portrait"

[ui.preview_panel]
size = 30

[actions.restore]
description = "Restore the selected trashed file"
command = "echo '{split: :1..}' | trash-restore"
mode = "execute"

[actions.empty]
description = "Empty the entire trash"
command = "trash-empty"
mode = "execute"

unicode

Search and insert unicode characters

The UnicodeData.txt file is included by many packages.

In addition to:

Alpine Linux: unicode-character-database Arch: unicode-character-database Debian/Ubuntu: unicode-data Fedora / RHEL / CentOS unicode-ucd Gentoo: app-i18n/unicode-data NixOS: unicode/unicode-data openSUSE: unicode-ucd

UnicodData.txt may also aleady be provided by:

Many java packages
Latex packages
Still others

It may in some cases be necessary to alter UNICODE_FILE below.

tv running the unicode channel Requirements: awk, perl

Code: unicode.toml

[metadata]
name = "unicode"
description = "Search and insert unicode characters\n\nThe UnicodeData.txt file is included by many packages.\n\nIn addition to:\n\nAlpine Linux: unicode-character-database\nArch: unicode-character-database\nDebian/Ubuntu: unicode-data\nFedora / RHEL / CentOS unicode-ucd\nGentoo: app-i18n/unicode-data\nNixOS: unicode/unicode-data\nopenSUSE: unicode-ucd\n\nUnicodData.txt may also aleady be provided by:\n\n1) Many java packages\n2) Latex packages\n3) Still others\n\nIt may in some cases be necessary to alter UNICODE_FILE below.\n\n"
requirements = [ "awk", "perl",]

[source]
command = "UNICODE_FILE=\"/usr/share/unicode/ucd/UnicodeData.txt\"\nawk -F';' '\n  $2 !~ /^</ { print $1 \"|\" $2 }\n' \"$UNICODE_FILE\" | perl -CS -F'\\|' -lane '\n    $code = $F[0];\n    $desc = $F[1];\n    $char = chr(hex($code));\n    print \"U+$code|$char|$desc\" if $char =~ /\\p{Print}/;\n'\n"
display = "{split:|:0}    {split:|:1}    {split:|:2}"
output = "{split:|:1}"

wifi

Scan and connect to WiFi networks

Requirements: nmcli

Code: wifi.toml

[metadata]
name = "wifi"
description = "Scan and connect to WiFi networks"
requirements = [ "nmcli",]

[source]
command = "nmcli -t -f SSID,SIGNAL,SECURITY device wifi list 2>/dev/null | grep -v '^:' | sort -t: -k2 -rn"
display = "{split:\\::0} ({split:\\::1}% {split:\\::2})"
output = "{split:\\::0}"

[preview]
command = "nmcli -t -f SSID,BSSID,MODE,FREQ,SIGNAL,SECURITY,ACTIVE device wifi list 2>/dev/null | grep '^{split:\\::0}:'"

[actions.connect]
description = "Connect to the selected network"
command = "nmcli device wifi connect '{split:\\::0}'"
mode = "execute"

zoxide

Browse zoxide directory history

Requirements: zoxide

Code: zoxide.toml

[metadata]
name = "zoxide"
description = "Browse zoxide directory history"
requirements = [ "zoxide",]

[source]
command = "zoxide query -l"
no_sort = true
frecency = false

[preview]
command = "ls -la --color=always '{}'"

[keybindings]
enter = "actions:cd"
ctrl-d = "actions:remove"

[actions.cd]
description = "Change to the selected directory"
command = "cd '{}' && $SHELL"
mode = "execute"

[actions.remove]
description = "Remove the selected directory from zoxide"
command = "zoxide remove '{}'"
mode = "fork"

zsh-history

A channel to select from your zsh history

Requirements: zsh

Code: zsh-history.toml

[metadata]
name = "zsh-history"
description = "A channel to select from your zsh history"
requirements = [ "zsh",]

[source]
command = "sed '1!G;h;$!d' ${HISTFILE:-${HOME}/.zsh_history}"
display = "{split:;:1..}"
output = "{split:;:1..}"
no_sort = true
frecency = false

[actions.execute]
description = "Execute the selected command"
command = "zsh -c '{split:;:1..}'"
mode = "execute"

aerospace-windows​

alias​

apt-packages​

aws-buckets​

aws-instances​

aws-profiles​

bash-history​

brew-packages​

cargo-commands​

cargo-crates​

channels​

crontab​

dirs​

diskutil​

distrobox-list​

dnf-packages​

docker-compose​

docker-containers​

docker-images​

docker-networks​

docker-volumes​

dotfiles​

downloads​

env​

figlet-fonts​

files​

fish-history​

fj-issues​

fj-prs​

flatpak​

fonts​

gh-issues​

gh-prs​

git-branch​

git-deletions​

git-diff​

git-files​

git-log​

git-reflog​

git-remotes​

git-repos​

git-stash​

git-submodules​

git-tags​

git-worktrees​

gradle-tasks​

guix​

images​

jj-bookmark​

jj-diff​

jj-files​

jj-log​

jj-op-log​

jj-remotes​

jj-workspaces​

journal​

just-recipes​

k8s-contexts​

k8s-deployments​

k8s-pods​

k8s-services​

launchd-services​

make-targets​

man-pages​

mounts​

node-packages​

npm-packages​

npm-scripts​

nu-history​

opencode-sessions​

pacman-packages​

path​

pdf-files​

pip-packages​

podman-containers​

podman-images​

podman-networks​

podman-volumes​

ports​

procs​

aerospace-windows

alias

apt-packages

aws-buckets

aws-instances

aws-profiles

bash-history

brew-packages

cargo-commands

cargo-crates

channels

crontab

dirs

diskutil

distrobox-list

dnf-packages

docker-compose

docker-containers

docker-images

docker-networks

docker-volumes

dotfiles

downloads

env

figlet-fonts

files

fish-history

fj-issues

fj-prs

flatpak

fonts

gh-issues

gh-prs

git-branch

git-deletions

git-diff

git-files

git-log

git-reflog

git-remotes

git-repos

git-stash

git-submodules

git-tags

git-worktrees

gradle-tasks

guix

images

jj-bookmark

jj-diff

jj-files

jj-log

jj-op-log

jj-remotes

jj-workspaces

journal

just-recipes

k8s-contexts

k8s-deployments

k8s-pods

k8s-services

launchd-services

make-targets

man-pages

mounts

node-packages

npm-packages

npm-scripts

nu-history

opencode-sessions

pacman-packages

path

pdf-files

pip-packages

podman-containers

podman-images

podman-networks

podman-volumes

ports

procs