cli

Documentation

Overview

Package cli is a reusable toolbox that turns any single CLI binary into a codefly tool. It runs the binary through a RunnerEnvironment — so the binary is provisioned and sandboxed by the environment (Nix pulls it from the workspace flake; Docker from an image; Native uses PATH) rather than being a hard system dependency — captures its output, and compresses it through the gortk filter catalog before returning it to the model.

This is the answer to "how does a CLI toolbox get its dependency": it doesn't bundle one; it asks the environment to provide it. One instance wraps one binary (e.g. terraform, kubectl, helm), matching how `gh`/`git`/etc. each get their own canonical owner.

Index

• type Toolbox
  • func New(env runners.RunnerEnvironment, bin, version string) *Toolbox
  • func (t *Toolbox) Tools() []*registry.ToolDefinition

Types

type Toolbox

type Toolbox struct {
	*registry.Base
	// contains filtered or unexported fields
}

Toolbox wraps one CLI binary, executed via the given RunnerEnvironment.

func New

func New(env runners.RunnerEnvironment, bin, version string) *Toolbox

New wraps `bin`, running it through env. The caller constructs and Init's the environment (Native/Nix/Docker), which decides how `bin` is provisioned.

func (*Toolbox) Tools

func (t *Toolbox) Tools() []*registry.ToolDefinition