Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent runs on the home host, dials cloudbox over the matrix tunnel, and exposes local apps (ycode, shell, desktop, plus user-defined LAN services).
|
Package agent runs on the home host, dials cloudbox over the matrix tunnel, and exposes local apps (ycode, shell, desktop, plus user-defined LAN services). |
|
admincore
Package admincore holds the protocol-agnostic configuration operations outpost exposes — pairing, app CRUD, outbound mounts, built-in toggles, cluster kubeconfig, restart.
|
Package admincore holds the protocol-agnostic configuration operations outpost exposes — pairing, app CRUD, outbound mounts, built-in toggles, cluster kubeconfig, restart. |
|
adminui
Package adminui serves the local-only configuration web UI for outpost.
|
Package adminui serves the local-only configuration web UI for outpost. |
|
appcatalog
Package appcatalog resolves operator-facing public app ids to a Helm chart manifest pair — apps/<id>/app.yaml plus an optional apps/<id>/values.yaml — in an open-source dhnt/appstore checkout.
|
Package appcatalog resolves operator-facing public app ids to a Helm chart manifest pair — apps/<id>/app.yaml plus an optional apps/<id>/values.yaml — in an open-source dhnt/appstore checkout. |
|
apphealth
Package apphealth provides per-app reachability measurement over outpost-owned TCP/HTTP paths (no ICMP/raw sockets).
|
Package apphealth provides per-app reachability measurement over outpost-owned TCP/HTTP paths (no ICMP/raw sockets). |
|
backup
Package backup is the outpost-side, app-opaque folder watcher that produces backup candidates on a cron schedule.
|
Package backup is the outpost-side, app-opaque folder watcher that produces backup candidates on a cron schedule. |
|
brain
Package brain is cloudbox/outpost/bashy's built-in decision-maker — the faculty that lets the platform DECIDE, not just execute, for any operation that needs judgment.
|
Package brain is cloudbox/outpost/bashy's built-in decision-maker — the faculty that lets the platform DECIDE, not just execute, for any operation that needs judgment. |
|
builtincatalog
Package builtincatalog resolves operator-facing built-in names to manifests in the open-source dhnt/appstore checkout.
|
Package builtincatalog resolves operator-facing built-in names to manifests in the open-source dhnt/appstore checkout. |
|
bundleapply
Package bundleapply installs an app/bundle manifest set against a kubeconfig-addressed Kubernetes control plane — specifically a PEER-HOSTED one, with no cloudbox dependency anywhere on the execution path.
|
Package bundleapply installs an app/bundle manifest set against a kubeconfig-addressed Kubernetes control plane — specifically a PEER-HOSTED one, with no cloudbox dependency anywhere on the execution path. |
|
bundleapply/cmd
command
Command bundleapply is the standalone runner behind script/dks-peer-bundle-apply.sh: it applies an app/bundle manifest set against a PEER-HOSTED control plane addressed purely by a kubeconfig path.
|
Command bundleapply is the standalone runner behind script/dks-peer-bundle-apply.sh: it applies an app/bundle manifest set against a PEER-HOSTED control plane addressed purely by a kubeconfig path. |
|
clusterconform
Package clusterconform is the single source of truth for the mixed-runtime coexistence contract on a peer-hosted DKS control plane — the set of node runtimes that may register against ONE apiserver at once (a real k3s agent plus one or more virtual-kubelet backends), the node-identity labels and taints each one carries, and the node-level API surface each one actually serves.
|
Package clusterconform is the single source of truth for the mixed-runtime coexistence contract on a peer-hosted DKS control plane — the set of node runtimes that may register against ONE apiserver at once (a real k3s agent plus one or more virtual-kubelet backends), the node-identity labels and taints each one carries, and the node-level API surface each one actually serves. |
|
clusterllm
Package clusterllm is outpost's passive integrator for an intra-home distributed-inference backend — a runtime that tensor/pipeline-splits a single model across several member machines so a home can serve a model too large for any one box.
|
Package clusterllm is outpost's passive integrator for an intra-home distributed-inference backend — a runtime that tensor/pipeline-splits a single model across several member machines so a home can serve a model too large for any one box. |
|
conf
Package conf holds the matrix-agent runtime configuration.
|
Package conf holds the matrix-agent runtime configuration. |
|
discovery
mDNS advertisement: register ourselves on `_outpost._tcp.local`.
|
mDNS advertisement: register ourselves on `_outpost._tcp.local`. |
|
fleetreg
Package fleetreg pushes this host's fleet inventory — the tools, agents, and skills it has installed — up to cloudbox.
|
Package fleetreg pushes this host's fleet inventory — the tools, agents, and skills it has installed — up to cloudbox. |
|
headlamp
Package headlamp deploys and audits a Headlamp operating UI on a peer-hosted DKS control plane.
|
Package headlamp deploys and audits a Headlamp operating UI on a peer-hosted DKS control plane. |
|
heartbeat
Package heartbeat owns the outpost → cloudbox active liveness push (Layer-5 defense).
|
Package heartbeat owns the outpost → cloudbox active liveness push (Layer-5 defense). |
|
hostauth
Package hostauth verifies the host OS's own credentials.
|
Package hostauth verifies the host OS's own credentials. |
|
localsock
Package localsock is the one place outpost decides how to reach a local daemon endpoint that is not a TCP port: a unix-domain socket or a Windows named pipe.
|
Package localsock is the one place outpost decides how to reach a local daemon endpoint that is not a TCP port: a unix-domain socket or a Windows named pipe. |
|
mcpapi
Package mcpapi exposes outpost's configuration surface to agent tools (Claude Code, Windsurf, the outpost CLI, ...) over the Model Context Protocol.
|
Package mcpapi exposes outpost's configuration surface to agent tools (Claude Code, Windsurf, the outpost CLI, ...) over the Model Context Protocol. |
|
mesh
Package mesh is the outpost's libp2p peer data plane — the node that carries authenticated, encrypted, NAT-traversing peer↔peer streams.
|
Package mesh is the outpost's libp2p peer data plane — the node that carries authenticated, encrypted, NAT-traversing peer↔peer streams. |
|
mirror
Package mirror supervises mobility-aware continuous directory mirrors.
|
Package mirror supervises mobility-aware continuous directory mirrors. |
|
nodeaddr
Package nodeaddr makes an apiserver able to reach kubelets that are only reachable through a tunnel.
|
Package nodeaddr makes an apiserver able to reach kubelets that are only reachable through a tunnel. |
|
nodecap
Package nodecap turns a runtime-probe DaemonSet into truthful scheduler state.
|
Package nodecap turns a runtime-probe DaemonSet into truthful scheduler state. |
|
nodegc
Package nodegc reclaims stale Kubernetes Node objects on a peer-hosted DKS control plane.
|
Package nodegc reclaims stale Kubernetes Node objects on a peer-hosted DKS control plane. |
|
ollama
Package ollama owns the outpost-side of the LLM pool: it watches the local Ollama daemon's model inventory, publishes the inventory to cloudbox so the pool scheduler can route by model presence, and tracks in-flight request counts so cloudbox can avoid over-scheduling a host with limited GPU capacity.
|
Package ollama owns the outpost-side of the LLM pool: it watches the local Ollama daemon's model inventory, publishes the inventory to cloudbox so the pool scheduler can route by model presence, and tracks in-flight request counts so cloudbox can avoid over-scheduling a host with limited GPU capacity. |
|
osversion
Package osversion returns a one-line human-readable OS version label for the running host, e.g.
|
Package osversion returns a one-line human-readable OS version label for the running host, e.g. |
|
otel
Package otel discovers the local `ycode serve` observability stack (Prometheus + Alertmanager + VictoriaLogs + Jaeger + Perses, all reverse-proxied under one bearer-authed HTTP server) and lets outpost expose each surface through the matrix tunnel as a built-in app.
|
Package otel discovers the local `ycode serve` observability stack (Prometheus + Alertmanager + VictoriaLogs + Jaeger + Perses, all reverse-proxied under one bearer-authed HTTP server) and lets outpost expose each surface through the matrix tunnel as a built-in app. |
|
overlaykey
Package overlaykey fetches a fresh single-use overlay (Tailscale/ Headscale) pre-auth key from cloudbox when this host's tailnet registration is no longer valid.
|
Package overlaykey fetches a fresh single-use overlay (Tailscale/ Headscale) pre-auth key from cloudbox when this host's tailnet registration is no longer valid. |
|
peerhosts
Package peerhosts caches the list of paired outpost hostnames as returned by cloudbox's /api/v1/ssh/hosts endpoint.
|
Package peerhosts caches the list of paired outpost hostnames as returned by cloudbox's /api/v1/ssh/hosts endpoint. |
|
peerimage
Package peerimage is the PEER half of the DKS "recipes, not blobs" image distribution model (docs/peer-dks-image-distribution.md).
|
Package peerimage is the PEER half of the DKS "recipes, not blobs" image distribution model (docs/peer-dks-image-distribution.md). |
|
peerplane
Package peerplane is the outpost side of the dhnt p2p resource fabric's peer data plane.
|
Package peerplane is the outpost side of the dhnt p2p resource fabric's peer data plane. |
|
peerstatus
Package peerstatus is a thin client for cloudbox's GET /api/v1/peers — the peer status board.
|
Package peerstatus is a thin client for cloudbox's GET /api/v1/peers — the peer status board. |
|
peerticket
Package peerticket verifies short-lived JWTs ("peer tickets") cloudbox issues at `POST /api/v1/ssh/peer-ticket`.
|
Package peerticket verifies short-lived JWTs ("peer tickets") cloudbox issues at `POST /api/v1/ssh/peer-ticket`. |
|
portal
Package portal speaks to the cloud portal's pairing endpoint (POST /api/register/exchange).
|
Package portal speaks to the cloud portal's pairing endpoint (POST /api/register/exchange). |
|
recipebuilder
Package recipebuilder is the per-node half of the DKS "recipes, not blobs" image-distribution model (dhnt/docs/dks-image-recipe-distribution-design.md).
|
Package recipebuilder is the per-node half of the DKS "recipes, not blobs" image-distribution model (dhnt/docs/dks-image-recipe-distribution-design.md). |
|
repair
Package repair provides the POST /admin/repair receiver — the cloudbox-driven trigger that starts a CI-failure self-fix on this host.
|
Package repair provides the POST /admin/repair receiver — the cloudbox-driven trigger that starts a CI-failure self-fix on this host. |
|
runtime
Package runtime supervises a podman container that hosts this outpost's k3s-agent kubelet.
|
Package runtime supervises a podman container that hosts this outpost's k3s-agent kubelet. |
|
runtime/image/cni
command
Command outpost-cni implements a minimal Container Network Interface (CNI) plugin for Phase 3 of the outpost overlay design.
|
Command outpost-cni implements a minimal Container Network Interface (CNI) plugin for Phase 3 of the outpost overlay design. |
|
runtime/image/cni/internal/plugin
Package plugin contains the load-bearing logic for the outpost-cni binary, factored out so the tiny main package stays under 100 lines.
|
Package plugin contains the load-bearing logic for the outpost-cni binary, factored out so the tiny main package stays under 100 lines. |
|
sandbox
Package sandbox implements outpost's safe-by-default container "sandbox" provider: a filtered libpod/docker API proxy that strips the escape-bearing knobs (privileged, host namespaces, host bind-mounts, added capabilities, devices) and injects per-request resource caps, so a remote caller who clears the cloudbox elevation gate can run containers without getting root-equivalent control of the host.
|
Package sandbox implements outpost's safe-by-default container "sandbox" provider: a filtered libpod/docker API proxy that strips the escape-bearing knobs (privileged, host namespaces, host bind-mounts, added capabilities, devices) and injects per-request resource caps, so a remote caller who clears the cloudbox elevation gate can run containers without getting root-equivalent control of the host. |
|
selfcheck
Package selfcheck owns the Layer-2 defense: detect partial outpost corruption and self-heal from durable inputs.
|
Package selfcheck owns the Layer-2 defense: detect partial outpost corruption and self-heal from durable inputs. |
|
shard
Package shard orchestrates a Prima.cpp pipelined-ring shard over the mesh forwarder: serving a model bigger than any single node by splitting its layers across paired mesh peers.
|
Package shard orchestrates a Prima.cpp pipelined-ring shard over the mesh forwarder: serving a model bigger than any single node by splitting its layers across paired mesh peers. |
|
shell
Embedded coreutils fallback for the in-process shell.
|
Embedded coreutils fallback for the in-process shell. |
|
sshclient
In-process SSH client over the cloudbox matrix tunnel.
|
In-process SSH client over the cloudbox matrix tunnel. |
|
supervisor
Package supervisor is a minimal process supervisor: it keeps a fixed set of child Programs alive — start them, restart on exit with capped backoff, and gracefully stop them on shutdown.
|
Package supervisor is a minimal process supervisor: it keeps a fixed set of child Programs alive — start them, restart on exit with capped backoff, and gracefully stop them on shutdown. |
|
sysinfo
Package sysinfo collects host capability information the outpost reports to cloudbox via the /apps poll loop.
|
Package sysinfo collects host capability information the outpost reports to cloudbox via the /apps poll loop. |
|
sysload
Package sysload is the outpost's considerate system-load profiler.
|
Package sysload is the outpost's considerate system-load profiler. |
|
upgrade
Package upgrade carries the self-upgrade machinery shared by the CLI (`outpost upgrade`, `outpost rollback`) and the cloudbox-pushed daemon route (POST /admin/upgrade).
|
Package upgrade carries the self-upgrade machinery shared by the CLI (`outpost upgrade`, `outpost rollback`) and the cloudbox-pushed daemon route (POST /admin/upgrade). |
|
userkube
Package userkube owns the workflow for materializing a kubectl- ready kubeconfig from cloudbox onto this host's disk.
|
Package userkube owns the workflow for materializing a kubectl- ready kubeconfig from cloudbox onto this host's disk. |
|
vkcred
Package vkcred mints and carries the peer-issued LEAST-PRIVILEGE virtual-kubelet credential for a peer-hosted (k3s) control plane.
|
Package vkcred mints and carries the peer-issued LEAST-PRIVILEGE virtual-kubelet credential for a peer-hosted (k3s) control plane. |
|
vknode
Package vknode is the per-outpost half of the cloudbox cluster: it joins a cloud-side Kubernetes API server as a virtual node and runs scheduled Pods as podman containers on the host.
|
Package vknode is the per-outpost half of the cloudbox cluster: it joins a cloud-side Kubernetes API server as a virtual node and runs scheduled Pods as podman containers on the host. |
|
warm
Package warm implements the outpost's adaptive, considerate, always-on warm-serving plane.
|
Package warm implements the outpost's adaptive, considerate, always-on warm-serving plane. |
|
ycode
Package ycode discovers and lifecycle-manages a `ycode serve` process running side-by-side with outpost on the same OS user account.
|
Package ycode discovers and lifecycle-manages a `ycode serve` process running side-by-side with outpost on the same OS user account. |
|
Package jitter provides randomized timing for retry/backoff loops so a fleet of hosts that fail or restart together does not retry in lockstep — a synchronized "thundering herd" that can overwhelm the shared cloudbox hub.
|
Package jitter provides randomized timing for retry/backoff loops so a fleet of hosts that fail or restart together does not retry in lockstep — a synchronized "thundering herd" that can overwhelm the shared cloudbox hub. |
|
Package scheduler is a thin wrapper around robfig/cron/v3 that adds a JSONL ledger so each fired job leaves a durable record alongside the upgrade ledger (internal/agent/upgrade/ledger.go is its sibling shape — same Append+Tail pattern, different vocabulary).
|
Package scheduler is a thin wrapper around robfig/cron/v3 that adds a JSONL ledger so each fired job leaves a durable record alongside the upgrade ledger (internal/agent/upgrade/ledger.go is its sibling shape — same Append+Tail pattern, different vocabulary). |
|
Package telemetry bootstraps the OTEL SDK for outpost and exposes the small set of helpers wire callers need (gin tracing middleware, reverse-proxy traceparent preservation, slog ↔ OTEL log bridge).
|
Package telemetry bootstraps the OTEL SDK for outpost and exposes the small set of helpers wire callers need (gin tracing middleware, reverse-proxy traceparent preservation, slog ↔ OTEL log bridge). |
Click to show internal directories.
Click to hide internal directories.