cmd

README

cmd

This package holds the urfave/cli sub-commands that back the bucky CLI binary defined in ../main.go.

Command	File	Purpose
bucky install	install.go	Download whisper.cpp prebuilt libraries to a local lib/ directory
bucky system	system.go	Show host + whisper.cpp system info (FFI hookups land in PR #2)
bucky info	info.go	Print the bucky banner / tagline

The CLI structure mirrors hybridgroup/yzma/cmd so the two projects feel familiar side-by-side.

Documentation

Overview

Package cmd implements the bucky CLI subcommands (install, system, model, whisper, info) wired into urfave/cli.

Index

• Variables
• func ShowInfo(c *cli.Context) error

Variables

var InstallCmd = &cli.Command{
	Name:  "install",
	Usage: "Install whisper.cpp libraries used by bucky",
	Flags: []cli.Flag{
		&cli.StringFlag{
			Name:    "version",
			Aliases: []string{"v"},
			Usage:   "version of whisper.cpp to install (e.g. v1.8.4; default is the bucky-pinned version, pass \"latest\" to query the GitHub releases API)",
			Value:   "",
		},
		&cli.StringFlag{
			Name:    "lib",
			Aliases: []string{"l"},
			Usage:   "path to whisper.cpp compiled library files",
			EnvVars: []string{"BUCKY_LIB"},
		},
		&cli.StringFlag{
			Name:    "processor",
			Aliases: []string{"p"},
			Usage:   "processor to use (cpu, cuda, metal, vulkan)",
			Value:   "",
		},
		&cli.StringFlag{
			Name:  "os",
			Usage: "operating system to use (linux, windows, darwin)",
			Value: runtime.GOOS,
		},
		&cli.BoolFlag{
			Name:    "upgrade",
			Aliases: []string{"u"},
			Usage:   "upgrade existing installation",
			Value:   false,
		},
		&cli.BoolFlag{
			Name:    "quiet",
			Aliases: []string{"q"},
			Usage:   "suppress output during installation",
			Value:   false,
		},
	},
	Action: func(c *cli.Context) error {
		return runInstall(c)
	},
}

InstallCmd installs whisper.cpp shared libraries into a local directory.

var ModelCmd = &cli.Command{
	Name:  "model",
	Usage: "Manage whisper models",
	Subcommands: []*cli.Command{
		modelGetCmd,
		modelInfoCmd,
		modelListCmd,
	},
}

ModelCmd manages whisper model files (download / inspect).

var SystemCmd = &cli.Command{
	Name:  "system",
	Usage: "Show whisper.cpp / system information",
	Flags: []cli.Flag{
		&cli.StringFlag{
			Name:    "lib",
			Aliases: []string{"l"},
			Usage:   "path to whisper.cpp compiled library files",
			EnvVars: []string{"BUCKY_LIB"},
		},
	},
	Action: func(c *cli.Context) error {
		return runSystemInfo(c)
	},
}

SystemCmd shows information about the host environment and the loaded whisper.cpp library.

var WhisperCmd = &cli.Command{
	Name:  "whisper",
	Usage: "Run whisper.cpp commands (transcribe, translate, segments)",
	Subcommands: []*cli.Command{
		whisperTranscribeCmd,
	},
}

WhisperCmd groups whisper subcommands under "bucky whisper".

Functions

func ShowInfo

func ShowInfo(c *cli.Context) error

ShowInfo prints the bucky banner and a short tagline.