Skip to content

Cli ​

sunbeam ​

Command Line Launcher

Synopsis ​

Sunbeam is a command line launcher for your terminal, inspired by fzf and raycast.

See https://pomdtr.github.io/sunbeam for more information.

sunbeam [flags]

Options ​

  -h, --help   help for sunbeam

sunbeam completion ​

Generate the autocompletion script for the specified shell

Synopsis ​

Generate the autocompletion script for sunbeam for the specified shell. See each sub-command's help for details on how to use the generated script.

Options ​

  -h, --help   help for completion

sunbeam completion bash ​

Generate the autocompletion script for bash

Synopsis ​

Generate the autocompletion script for the bash shell.

This script depends on the 'bash-completion' package. If it is not installed already, you can install it via your OS's package manager.

To load completions in your current shell session:

source <(sunbeam completion bash)

To load completions for every new session, execute once:

Linux: ​

sunbeam completion bash > /etc/bash_completion.d/sunbeam

macOS: ​

sunbeam completion bash > $(brew --prefix)/etc/bash_completion.d/sunbeam

You will need to start a new shell for this setup to take effect.

sunbeam completion bash

Options ​

  -h, --help              help for bash
      --no-descriptions   disable completion descriptions

sunbeam completion fish ​

Generate the autocompletion script for fish

Synopsis ​

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

sunbeam completion fish | source

To load completions for every new session, execute once:

sunbeam completion fish > ~/.config/fish/completions/sunbeam.fish

You will need to start a new shell for this setup to take effect.

sunbeam completion fish [flags]

Options ​

  -h, --help              help for fish
      --no-descriptions   disable completion descriptions

sunbeam completion help ​

Help about any command

Synopsis ​

Help provides help for any command in the application. Simply type completion help [path to command] for full details.

sunbeam completion help [command] [flags]

Options ​

  -h, --help   help for help

sunbeam completion powershell ​

Generate the autocompletion script for powershell

Synopsis ​

Generate the autocompletion script for powershell.

To load completions in your current shell session:

sunbeam completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command to your powershell profile.

sunbeam completion powershell [flags]

Options ​

  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions

sunbeam completion zsh ​

Generate the autocompletion script for zsh

Synopsis ​

Generate the autocompletion script for the zsh shell.

If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:

echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions in your current shell session:

source <(sunbeam completion zsh)

To load completions for every new session, execute once:

Linux: ​

sunbeam completion zsh > "${fpath[1]}/_sunbeam"

macOS: ​

sunbeam completion zsh > $(brew --prefix)/share/zsh/site-functions/_sunbeam

You will need to start a new shell for this setup to take effect.

sunbeam completion zsh [flags]

Options ​

  -h, --help              help for zsh
      --no-descriptions   disable completion descriptions

sunbeam copy ​

Copy text from stdin or paste text to stdout

sunbeam copy [flags]

Options ​

  -h, --help   help for copy

sunbeam edit ​

Open a file in your editor

sunbeam edit [file] [flags]

Options ​

  -c, --config             Edit the config file
  -e, --extension string   File extension to use for temporary file
  -h, --help               help for edit

sunbeam extension ​

Manage sunbeam extensions

Options ​

  -h, --help   help for extension

sunbeam extension configure ​

Configure extension preferences

sunbeam extension configure <alias> [flags]

Options ​

  -h, --help   help for configure

sunbeam extension create ​

Create a new sunbeam extension

sunbeam extension create <name> [flags]

Options ​

  -h, --help              help for create
  -l, --language string   language of extension

sunbeam extension help ​

Help about any command

Synopsis ​

Help provides help for any command in the application. Simply type extension help [path to command] for full details.

sunbeam extension help [command] [flags]

Options ​

  -h, --help   help for help

sunbeam extension install ​

Install sunbeam extensions

sunbeam extension install <origin> [flags]

Options ​

      --alias string   alias for extension
  -h, --help           help for install

sunbeam extension list ​

List sunbeam extensions

sunbeam extension list [flags]

Options ​

  -h, --help   help for list

sunbeam extension publish ​

Publish a script as a github gist

sunbeam extension publish <script> [flags]

Options ​

  -h, --help     help for publish
  -o, --open     open gist in browser
  -p, --public   make gist public

sunbeam extension remove ​

Remove sunbeam extensions

sunbeam extension remove <alias> [flags]

Options ​

  -h, --help   help for remove

sunbeam extension rename ​

Rename sunbeam extensions

sunbeam extension rename <alias> <new-alias> [flags]

Options ​

  -h, --help   help for rename

sunbeam extension upgrade ​

Upgrade sunbeam extensions

sunbeam extension upgrade [flags]

Options ​

      --all    upgrade all extensions
  -h, --help   help for upgrade

sunbeam help ​

Help about any command

Synopsis ​

Help provides help for any command in the application. Simply type sunbeam help [path to command] for full details.

sunbeam help [command] [flags]

Options ​

  -h, --help   help for help

sunbeam open ​

Open a file or url in your default application

sunbeam open [target] [flags]

Options ​

  -h, --help   help for open

sunbeam paste ​

Paste text from clipboard to stdout

sunbeam paste [flags]

Options ​

  -h, --help   help for paste

sunbeam query ​

Transform or generate JSON using a jq query

sunbeam query [query] [file] [flags]

Options ​

      --arg stringArray       add string variable in the form of name=value
      --argjson stringArray   add JSON variable in the form of name=value
  -c, --compact-output        output without pretty-printing
  -h, --help                  help for query
  -i, --in-place              read and write to the same file
  -n, --null-input            use null as input value
  -R, --raw-input             read input as raw strings
  -r, --raw-output            output raw strings, not JSON texts
  -s, --slurp                 read all inputs into an array
      --yaml-input            read input as YAML format
      --yaml-output           output as YAML

sunbeam validate ​

Validate a Sunbeam schema

Options ​

  -h, --help   help for validate

sunbeam validate config ​

Validate a config

sunbeam validate config [flags]

Options ​

  -h, --help   help for config

sunbeam validate detail ​

Validate a detail

sunbeam validate detail [flags]

Options ​

  -h, --help   help for detail

sunbeam validate help ​

Help about any command

Synopsis ​

Help provides help for any command in the application. Simply type validate help [path to command] for full details.

sunbeam validate help [command] [flags]

Options ​

  -h, --help   help for help

sunbeam validate list ​

Validate a list

sunbeam validate list [flags]

Options ​

  -h, --help   help for list

sunbeam validate manifest ​

Validate a manifest

sunbeam validate manifest [flags]

Options ​

  -h, --help   help for manifest

sunbeam version ​

Print the version number of sunbeam

sunbeam version [flags]

Options ​

  -h, --help   help for version