runner

package

Go to main page

Versions in this module

v1

v1.0.0

Aug 28, 2026

v0

v0.9.0

Aug 28, 2026

Changes in this version

+ const BasePromptFile

+ const ContainerGenerationLink

+ const ContainerProfileLink

+ const DefaultBuildCPUs

+ const NixDFReportScript

+ const NixGCRootReportScript

+ const NixHealthProbeScript

+ const OverlayPromptFile

+ const ProfilePath

+ const SafeNixGCScript

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

+ func BuildCleanupPrompt(closures []LiveClosure) string

+ func BuildCleanupScript(closures []LiveClosure) string

+ func BuildExecArgv(spec ExecSpec) []string

+ func ClosureAliveArgv(volume, image string) []string

+ func ClosureDeadWarning(alive bool) (warning string, dead bool)

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

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

+ func DebugArgv(argv []string) string

+ func DockerBindProbeArgv(image, volume, source, marker string) []string

+ func DockerPlatform(arch string) string

+ func DockerResolveContainerLink(ctx context.Context, container, link string) (string, error)

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

+ func DockerVolumeDebug(ctx context.Context, volume string) string

+ func FlakeNixImage() string

+ func FormatNixStoreSection(r NixStoreReport, w io.Writer)

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

+ func LookPathNix() (string, error)

+ func NixDFReportArgv(volume string) []string

+ func NixHealthProbeArgv(volume string) []string

+ func ParseClosureAliveResult(stdout string, err error) (resolvedPath string, alive bool)

+ func PreflightPlatformCheck(ctx context.Context, nixhomeFlakeRef, targetSystem string) error

+ func PreflightPlatformCheckWithLookPath(ctx context.Context, nixhomeFlakeRef, targetSystem string, ...) error

+ func PrepareWireguard(cellHome string, cellCfg cfg.CellConfig) error

+ func ProbeDockerBind(ctx context.Context, image, volume, source, marker string) (string, error)

+ func ProjectNixpkgsRev(baseDir string) (string, error)

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

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

+ func ResolveNixhomeRef(ver string) string

+ func RunCleanup(a RunCleanupArgs) error

+ func StaleCellWarning(projectRev string, h NixStoreHealth) (string, bool)

+ func StampRootsScript(closures []LiveClosure) string

+ func WriteBasePrompt(c config.Config, opts ResolveOpts) (string, error)

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

+ func WritePromptFile(c config.Config, name, content string) (string, error)

+ func WriteThinBuildContext(w io.Writer, buildDir string) error

+ type BuildLimits struct

+ CPUs string

+ Cores int

+ MaxJobs int

+ Memory string

+ func ResolveBuildLimits() BuildLimits

+ type DockerCapacity struct

+ MemBytes int64

+ NCPU int

+ type DockerDebugInfo struct

+ Architecture string

+ CPUs int

+ Context string

+ DockerHostEnv string

+ Endpoint string

+ MemoryBytes int64

+ Name string

+ OperatingOS string

+ RootDir string

+ Runtime string

+ ServerVersion string

+ Socket string

+ SocketTarget string

+ func CollectDockerDebugInfo(ctx context.Context) (DockerDebugInfo, error)

+ type ExecSpec struct

+ Args []string

+ Binary string

+ ContainerName string

+ TTY bool

+ type LiveClosure struct

+ Container string

+ GenerationPath string

+ ProfilePath string

+ func CollectLiveClosures(ps func() ([]string, error), ...) ([]LiveClosure, error)

+ type NixRootEntry struct

+ Name string

+ Stale bool

+ type NixRootMeta struct

+ Hash string

+ Nixpkgs string

+ Project string

+ Stack string

+ type NixStoreHealth struct

+ DistinctRevs int

+ Generations int

+ NewestProjects int

+ NewestRev string

+ OrphanedGenerations int

+ ProfileHashes int

+ StaleRoots int

+ TotalRoots int

+ func ParseNixStoreHealth(out string) (NixStoreHealth, error)

+ func (h NixStoreHealth) Summary() (string, bool)

+ type NixStoreReport struct

+ Health NixStoreHealth

+ Metas []NixRootMeta

+ Roots []NixRootEntry

+ Volume string

+ func CollectNixStore(ctx context.Context) (NixStoreReport, bool)

+ func ParseNixStoreReport(volume, out string) (NixStoreReport, error)

type PruneOpts

+ LiveClosures []LiveClosure

type PruneStep

+ func BuildCleanupSteps(closures []LiveClosure) []PruneStep

type ResolveOpts

+ AppendEnvFile string

+ AppendEnvInline string

+ AppendFlagFile string

+ AppendFlagInline string

+ type RunCleanupArgs struct

+ Closures []LiveClosure

+ Exec func(step PruneStep) error

+ In io.Reader

+ IsTTY bool

+ Out io.Writer

+ SkipYes bool

type RunSpec

+ Detach bool

+ SkipFlake bool

+ TTY bool

+ TrustFlake bool

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