cmd

package
v0.0.0-...-c5f7cd3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 16, 2026 License: AGPL-3.0 Imports: 91 Imported by: 0

Documentation

Overview

Package cmd implements the `clrk` CLI built on top of cobra.

Index

Constants

This section is empty.

Variables

View Source
var RootCmd = &cobra.Command{
	Use:               "clrk",
	Short:             "CLRK agent sandbox runtime CLI",
	SilenceUsage:      true,
	SilenceErrors:     true,
	DisableAutoGenTag: true,
	PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
		return configureLogging()
	},
}

RootCmd is the top-level `clrk` command.

Functions

func GenerateDocs

func GenerateDocs(outDir string) error

GenerateDocs walks the cobra command tree and writes a single Markdown reference (`clrk.mdx`) under the given directory. The output is shaped for the apoxy-cloud docs2 site: every command becomes a section, and internal cross-references collapse to in-page anchors.

Types

type ComponentState

type ComponentState struct {
	Name      string `json:"name"`
	Status    string `json:"status"`
	Ready     bool   `json:"ready"`
	Image     string `json:"image,omitempty"`
	StartedAt string `json:"started_at,omitempty"`
	Uptime    string `json:"uptime,omitempty"`
}

ComponentState is one row in `clrk dev status`. Source-of-truth varies per component: docker inspect for the k3d server, Pod phase + Ready condition for cm + workers.

type ExposedForward

type ExposedForward struct {
	Namespace   string `json:"namespace"`
	Name        string `json:"name"`
	HostPort    int    `json:"host_port"`
	ServicePort int32  `json:"service_port"`
}

ExposedForward is one auto-opened host-port forward managed by the `clrk dev` expose reconciler. Mirrored into dev.json on every change so `clrk dev status` can introspect without contacting the cluster.

Directories

Path Synopsis
Package devagents tracks the live state of TaskAgent and DaemonAgent objects in the dev cluster and rolls up per-agent telemetry from the in-process OTLP receiver.
Package devagents tracks the live state of TaskAgent and DaemonAgent objects in the dev cluster and rolls up per-agent telemetry from the in-process OTLP receiver.
Package devotel implements an in-process OTLP/HTTP receiver that `clrk dev` runs to capture egress ext_proc telemetry without having to bundle a real otel-collector container.
Package devotel implements an in-process OTLP/HTTP receiver that `clrk dev` runs to capture egress ext_proc telemetry without having to bundle a real otel-collector container.
Package devtui renders the live status of `clrk dev` (agents, k3s, controller-manager, workers) and their per-component logs in a Bubble Tea TUI.
Package devtui renders the live status of `clrk dev` (agents, k3s, controller-manager, workers) and their per-component logs in a Bubble Tea TUI.
Package spangraph renders OTLP spans as a lazygit-style hierarchy graph: each trace drawn as a tree by parent/child with colored lanes, a status-colored node per span, a compact metadata tail, and a detail block (attributes plus event bodies) the caller expands or collapses for the whole graph at once via a global expand level.
Package spangraph renders OTLP spans as a lazygit-style hierarchy graph: each trace drawn as a tree by parent/child with colored lanes, a status-colored node per span, a compact metadata tail, and a detail block (attributes plus event bodies) the caller expands or collapses for the whole graph at once via a global expand level.

Jump to

Keyboard shortcuts

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