runner

package

Go to main page

Versions in this module

v0

v0.8.2

Jul 5, 2026

v0.8.1

Jul 5, 2026

v0.8.0

Jul 5, 2026

Changes in this version

+ const DefaultThinStoreVolume

+ const NixCoreImage

+ const ThinEntrypointSentinel

+ const UpstreamOwner

+ const UpstreamRepo

+ const UpstreamSubdir

+ var ErrDockerDaemonUnreachable = errors.New("Docker is not running. Please start Docker and retry")

+ var PerCellImage bool

+ var PollInterval = 25 * time.Millisecond

+ func BuildLabel(prefix, stack string, explicit bool) string

+ func CollectRunningContainers(ctx context.Context) ([]string, error)

+ func CollectVolumeMounts(ctx context.Context) map[string][]string

+ func ConsumeBootEvents(events <-chan BootEvent)

+ func DetectArch() string

+ func DockerDaemonReachable(ctx context.Context) error

+ func DockerHostPath(p string) string

+ func FormatMCPLoadedBanner(nixMCPs, userMCPs []string) string

+ func FormatTableWithVM(snap DFSnapshot, opts FormatOpts, vm VMDiskInfo, containers []string, ...) error

+ func ParseSentinelName(filename string) (component, state string, ok bool)

+ func PickImageTagThin() string

+ func RenderModulesOverlay(modules []string) string

+ func ResolveBuildTag(custom, derived string) string

+ func ThinBuildArgv(...) []string

+ func ThinBuildArgvFull(...) []string

+ func ThinStoreVolume() string

+ func TranslateError(err error) string

+ func UpstreamFlakeRef(ref string) string

+ func UpstreamFlakeRefNoVersion() string

+ func UserImageTagThin() string

+ func VolumeContains(ctx context.Context, volumeName, sentinelPath string) bool

+ func VolumeContainsArgv(volumeName, sentinelPath string) []string

+ func VolumeExists(ctx context.Context, name string) bool

+ func VolumeHydrated(volumeName, sentinelPath string, exists func(string) bool, ...) bool

+ func WarnThickDeprecation()

+ func WriteModulesOverlay(modules []string, outPath string) error

+ type BootDirWatcher struct

+ func (w *BootDirWatcher) Close() error

+ func (w *BootDirWatcher) Start(dir string) (<-chan BootEvent, error)

+ type BootEvent struct

+ Component string

+ State string

+ Title string

+ type Catalog map[string]ModuleMeta

+ func ParseCatalogJSON(raw []byte) (Catalog, error)

+ func ReadCatalogFromFlake(ctx context.Context, flakeRef string) (Catalog, error)

+ func (c Catalog) Names() []string

+ type ModuleMeta struct

+ Description string

+ MCPServers []string

+ SizeMB int

type PureBuildSpec

+ Thin bool

type RunSpec

+ BootDir string

+ ThinImage bool

+ type VMDiskInfo struct

+ AvailBytes int64

+ TotalBytes int64

+ UsedBytes int64

+ func CollectVMDisk(ctx context.Context) (VMDiskInfo, error)

v0.7.0

Jun 2, 2026

Changes in this version

+ const DefaultNixhomeGitRef

+ func AcquireImage(ctx context.Context, d AcquireDeps) error

+ func BuildImagePure(ctx context.Context, spec PureBuildSpec, tag string, verbose bool, ...) error

+ func BuildPrunePrompt(opts PruneOpts) string

+ func ConfirmDestructive(out io.Writer, in io.Reader, skipYes bool, isTTY bool, warning string) bool

+ func FormatImageVersionUserExport(m ImageMetadata) string

+ func FormatJSON(snap DFSnapshot, opts FormatOpts, w io.Writer) error

+ func FormatTable(snap DFSnapshot, opts FormatOpts, w io.Writer) error

+ func HumanBytes(n int64) string

+ func LocalImageIDFor(ctx context.Context, tag string) (string, error)

+ func LocalImageSize(ctx context.Context, tag string) int64

+ func NixSystemFor(goos, goarch string) string

+ func ParseSize(s string) (int64, error)

+ func PickImageTag(impure bool) string

+ func PickSkopeoBin(printOutPathsOutput string, exists func(string) bool) (string, error)

+ func PreflightNixBuilder(stack string) error

+ func PreflightNixBuilderFromProbe(probe LinuxBuilderProbe, stack string) error

+ func PullAndTagImpure(ctx context.Context, stack string, verbose bool) error

+ func PullAndTagPure(ctx context.Context, stack string, verbose bool) error

+ func PureBuildArgv(spec PureBuildSpec) []string

+ func RunDF(a RunDFArgs) error

+ func RunPrune(a RunPruneArgs) error

+ func StackImageTagDebian(stack string) string

+ func StackImageTagImpure(stack string) string

+ func StackImageTagPure(stack string) string

+ func UserImageTagPure() string

+ type AcquireDeps struct

+ BuildImpure func(context.Context) error

+ BuildPure func(context.Context) error

+ Inputs LaunchInputs

+ PullImpure func(context.Context) error

+ PullPure func(context.Context) error

+ type BuildDebugInfo struct

+ Created string

+ ID string

+ LayerCount int

+ SizeBytes int64

+ Tag string

+ func InspectImageDebug(ctx context.Context, tag string) (BuildDebugInfo, error)

+ type DFCache struct

+ CreatedSince string

+ Description string

+ ID string

+ InUse bool

+ Shared bool

+ SizeBytes int64

+ UsageCount int

+ type DFCollector interface

+ CollectSystemDF func(ctx context.Context) ([]byte, error)

+ type DFContainer struct

+ ID string

+ ImageRef string

+ Names string

+ SizeBytes int64

+ State string

+ type DFImage struct

+ Containers int

+ CreatedSince string

+ ID string

+ Repository string

+ SharedBytes int64

+ SizeBytes int64

+ Tag string

+ UniqueBytes int64

+ type DFOpts struct

+ JSON bool

+ Kinds []EntryKind

+ TopN int

+ type DFSnapshot struct

+ BuildCache []DFCache

+ Containers []DFContainer

+ Images []DFImage

+ Volumes []DFVolume

+ func ParseSystemDF(raw []byte) (DFSnapshot, error)

+ type DFVolume struct

+ Links int

+ Name string

+ SizeBytes int64

+ type EntryKind string

+ const EntryKindCache

+ const EntryKindContainer

+ const EntryKindImage

+ const EntryKindVolume

+ type EphemeralRegistry struct

+ Port int

+ func (r *EphemeralRegistry) Addr() string

+ func (r *EphemeralRegistry) Start(cacheDir string) error

+ func (r *EphemeralRegistry) Stop() error

+ type ExecCollector struct

+ func (ExecCollector) CollectSystemDF(ctx context.Context) ([]byte, error)

+ type FormatOpts struct

+ Kinds []EntryKind

+ TopN int

type ImageMetadata

+ func ImageMetadataFromInspectExport(created string, labels map[string]string, env []string) ImageMetadata

+ type LaunchAction int

+ const ActionBuildImpure

+ const ActionBuildPure

+ const ActionDryRun

+ const ActionPullImpure

+ const ActionPullPure

+ const ActionUseLocal

+ func DecideLaunchActionsPure(in LaunchInputs) []LaunchAction

+ type LaunchInputs struct

+ DryRun bool

+ ExplicitBuild bool

+ HasNix bool

+ LocalExists bool

+ type LayerCounter struct

+ func NewLayerCounter(w io.Writer) *LayerCounter

+ func (lc *LayerCounter) Stats() LayerStats

+ func (lc *LayerCounter) Write(p []byte) (int, error)

+ type LayerStats struct

+ Cached int

+ New int

+ type LinuxBuilderProbe struct

+ BuildersLine string

+ ConfigCmd string

+ ConfigErr string

+ ExtraPlatforms string

+ MachinesFile string

+ MachinesLines string

+ NixConfPath string

+ OK bool

+ Source string

+ func CheckNixLinuxBuilder() LinuxBuilderProbe

+ type PruneOpts struct

+ Force bool

+ GOOS string

+ HomeDir string

+ LinuxBuilderHost string

+ NixOS bool

+ Pure bool

+ Rootless bool

+ type PruneStep struct

+ Argv []string

+ DryRun bool

+ IgnoreError bool

+ func BuildDockerPruneSteps(opts PruneOpts) []PruneStep

+ func BuildNixPruneSteps(opts PruneOpts) []PruneStep

+ type PureBuildSpec struct

+ Arch string

+ FlakeRef string

+ NixhomePath string

+ OutLink string

+ StackName string

+ Verbose bool

+ type PureNixhomeInputs struct

+ BaseDir string

+ StatFunc func(path string) error

+ TomlNixhome string

+ Version string

+ type PureNixhomeRef struct

+ FlakeRef string

+ LocalPath string

+ Remote bool

+ func ResolvePureNixhomeRef(inputs PureNixhomeInputs) PureNixhomeRef

+ type RankedEntry struct

+ ID string

+ Kind EntryKind

+ Label string

+ PinCount int

+ ReclaimBytes int64

+ SizeBytes int64

+ func RankEntries(snap DFSnapshot, topN int) []RankedEntry

+ type RunDFArgs struct

+ Collector DFCollector

+ Ctx context.Context

+ Opts DFOpts

+ Out io.Writer

+ type RunPruneArgs struct

+ Exec func(step PruneStep) error

+ In io.Reader

+ IsTTY bool

+ Opts PruneOpts

+ Out io.Writer

+ SkipYes bool

type RunSpec

+ NixDaemon bool

v0.6.0

May 5, 2026

Changes in this version

+ var Modules []string

+ var PerSessionImage bool

+ var Stack = "base"

+ func AssembleSystemPrompt(c config.Config, cellCfg cfg.CellConfig, opts ResolveOpts) (string, error)

+ func ContainerContext(c config.Config, cellCfg cfg.CellConfig) string

+ func ResolveSystemPrompt(opts ResolveOpts) (string, error)

+ type ResolveOpts struct

+ CellCfg cfg.CellConfig

+ CfgBaseDir string

+ EnvFile string

+ EnvInline string

+ FlagFile string

+ FlagInline string

v0.5.0

Apr 21, 2026

Changes in this version

+ func BuildVagrantSSHArgv(spec VagrantSpec) []string

+ func ParseVagrantGlobalStatus(output string) map[string]string

+ func ParseVagrantPortOutput(output, guestPort string) (string, bool)

+ func VagrantBinaryExists(ctx context.Context, vagrantDir, binary string) bool

+ func VagrantEnsureGUI(ctx context.Context, vagrantDir string, dryRun bool) error

+ func VagrantEnsureUp(ctx context.Context, vagrantDir, provider string, dryRun bool) error

+ func VagrantIsRunning(vagrantDir string) bool

+ func VagrantMachineCreated(vagrantDir string) bool

+ func VagrantMachinePort(machineID, guestPort string) (string, bool)

+ func VagrantProvision(ctx context.Context, vagrantDir string, dryRun bool) error

+ func VagrantReadForwardedPort(vagrantDir, portID string) (string, bool)

+ func VagrantRunningCells() map[string]string

+ func VagrantStatusRunning(output string) bool

+ func VagrantUploadNixhome(ctx context.Context, vagrantDir, nixhomePath string, dryRun bool) error

+ type VagrantSpec struct

+ Binary string

+ CellCfg cfg.CellConfig

+ Config config.Config

+ DefaultFlags []string

+ EnvVars []string

+ ProjectDir string

+ Provider string

+ UserArgs []string

+ VagrantDir string

v0.4.2

Apr 6, 2026

v0.4.1

Apr 6, 2026

v0.4.0

Apr 6, 2026

Changes in this version

+ const DefaultRegistry

+ var Registry = DefaultRegistry

+ func ChangedBuildFiles(configDir string) ([]string, bool)

+ func DiffBuildFile(configDir, name string) string

+ func DiscoverStacks(ctx context.Context, configDir string, out io.Writer) ([]string, error)

+ func PullImage(ctx context.Context, tag string, verbose bool) error

+ func StackImageTag(stack string) string

+ type ImageMetadata struct

+ BaseImage string

+ BuildDate string

+ GitCommit string

+ Modules []string

+ Packages int

+ Stack string

+ func ImageMetadataFromContainer(ctx context.Context) ImageMetadata

+ func ParseImageMetadata(data []byte) ImageMetadata

v0.3.0

Mar 25, 2026

Changes in this version

+ func BuildSystemPrompt(c config.Config, cellCfg cfg.CellConfig) string

+ func ImageVersions(ctx context.Context) (base, user string)

+ func UpdateFlakeLock(ctx context.Context, configDir string, lockOnly bool, verbose bool, ...) error

type RunSpec

+ Getenv func(string) string

+ InheritEnv []string

v0.2.0

Mar 4, 2026

Changes in this version

type RunSpec

+ ExtraEnv map[string]string

v0.1.0

Mar 3, 2026

Changes in this version

+ func BaseImageTag() string

+ func BuildArgv(spec RunSpec, fs FS, lookPath func(string) (string, error)) []string

+ func BuildImage(ctx context.Context, configDir string, noCache bool, verbose bool, ...) error

+ func DockerfileChanged(configDir string) bool

+ func EnsureNetwork(ctx context.Context) error

+ func ImageExists(ctx context.Context, tag string) bool

+ func LocalImageID(ctx context.Context) (string, error)

+ func RemoveOrphanedContainer(ctx context.Context, name string) error

+ func UserImageTag() string

+ type FS interface

+ Stat func(path string) error

+ var OsFS FS = FSFunc(func(path string) error { ... })

+ type FSFunc func(string) error

+ func (f FSFunc) Stat(path string) error

+ type RunSpec struct

+ Binary string

+ CellCfg cfg.CellConfig

+ Config config.Config

+ Debug bool

+ DefaultFlags []string

+ Image string

+ UserArgs []string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL