pkg/

Package acp is a small, bashy-owned adapter for the Agent Client Protocol (ACP).

Package agentctl is the control contract for driving a third-party agent CLI unattended: how to make it run headless, how to get past its trust prompt, and how to steer it once it is running.

Package agentpty runs an agent CLI attached to a pseudo-terminal, with the watchdogs, the control channel, and the interactive-gate handling that a headless fleet needs.

Package ask reaches the HUMAN OPERATOR for an ad-hoc value from inside an agent session.

Package assetring is the ring catalog shared by every declarative asset bashy carries: skills, tools, models, agents.

Package atlas is the Command Atlas: the curated multi-axis catalog of the bashy/coreutils command surface.

Package autofix adapts a plausible-but-wrong command into one that runs HERE, and reports what it did — instead of returning an error the agent must spend a round-trip diagnosing.

Package autoretry recognizes transient command failures and provides the policy for re-running them, so an agent doesn't burn a round trip re-issuing a call that failed on a passing network/resource blip — and doesn't retry something the shell already retried.

Package binmgr is the shared managed-external-binary mechanism for the dhnt ecosystem: resolve a (name, version, platform) tool spec → download from its own release → sha256-verify → cache → return the executable path.

Package board implements bashy's read-only steward/conductor projection.

Package bre matches POSIX Basic Regular Expressions (plus the common GNU extensions), shared by the pure-Go tools that default to BRE (grep, sed).

Package browser provides the per-session Client surface used by the browser_* tool shims.

Package bus is the agent notification bus: the PUSH half of how agents on a host coordinate, where `bashy kb` is the durable PULL half.

Package capability is the living capability matrix behind capability-routed delegation (see dhnt/docs/capability-routed-delegation.md).

Package codegraph wraps gfy's knowledge graph pipeline for ycode.

Package coopauth is the ONE shared implementation of the cloudbox/outpost cooperative-web-app identity + privilege model.

Package craft is the living skill graph: what a host has LEARNED from running skills, as opposed to which skills it has.

Package ctty reaches the HUMAN OPERATOR from a process whose stdio does not belong to them.

Package dag is an agent-first task runner: a Makefile replacement whose targets are defined as headings in a markdown file (DAG.md) and executed as a real dependency DAG.

Package fleet is the declarative registry of the things an agentic host runs with: tools, models, and agents.

Package gate answers the one question every stage transition depends on:

Package handoff implements portable, cross-tool, cross-machine session handoff: pause a live agent session mid-work, capture everything a successor needs, and pass it on — to a different agentic tool, to a scheduler, or to tomorrow.

Package herald reaches agents that are not on this host.

Package ignore is the opt-in "agentic" path filter shared by grep and find: under the --agentic flag they skip well-known noise directories and paths matched by the repo's .gitignore, so a recursive search over a codebase does not drag an agent through node_modules/.git/vendor/dist.

Package issue is the project's ISSUE REGISTER: the durable, committed record of what is wrong, what is wanted, and what is required — before anyone starts work.

Package judge renders a SEMANTIC verdict on a piece of work: is it any good?

Package kb is the host-scope shared knowledge base for agents — the collective memory of every agent tool working on this machine, across all repositories.

Package lexicon teaches a fleet of agentic tools a team's jargon.

Package llmbudget provides the local-first meter and gate for LLM calls.

Package lockfile provides process-scoped file locks with blocking, try-once, and bounded-wait acquisition.

Package meet implements `bashy meet` — a multi-participant deliberation session where agentic CLIs and a human take turns.

Package mirror is a continuous one-way directory mirror — node B keeps a live replica of a directory on node A — built entirely from PERMISSIVE parts: it reuses Syncthing's *architecture* (a recursive filesystem watcher + a periodic full-scan backstop + delta transfer) without any Syncthing code.

Package nudge is the proactive half of the agent-hint subsystem: when an agent runs a legacy tool that has a better agentic counterpart, it emits ONE rate-limited hint pointing at it — never changing the tool's behavior.

Package ollm wraps the Ollama API client, isolating the rest of the codebase from the underlying github.com/ollama/ollama dependency.

Package pair runs work through TWO agents and a gate: one proposes, one pairs with it in a declared role, and a real gate — not a model — decides whether it is done.

Package pricing provides a local, data-driven token price catalog.

Package principal resolves a name to the thing it names, and says how to reach it.

Package recommend answers "the agent guessed the wrong name" from the shell's ground truth.

Package redact removes HOST IDENTITY from text before it is stored, shared, or exported.

Package repomap generates structured overviews of code repositories.

Package resources reports live SYSTEM-LEVEL resource utilization — CPU, memory, disk, network, and (best effort) GPU — so a steward can judge whether the host itself is the bottleneck behind a slow fleet.

Package role gives an assumed responsibility a place to be reached.

Package room is the same-host "host room": the canonical registry of live agentic-tool instances (membership) plus an append-only event log (timeline).

Package schedule is bashy's modern cron: `bashy schedule` runs commands on a cron expression, a fixed interval, or at a one-shot time, from a self-contained JSON store + an optional in-process daemon — no host crontab required (the host `cron`/`crontab` are left untouched and reachable as before).

Package scope is the one git-repo-aware store resolver shared by every stateful bashy verb whose data has both a per-repo and a per-host home (today: todo and kb; the same shape fits any future "replaces an ad-hoc markdown file" store).

Local search (P0b) — the other half of the find-things primitive.

Package secrets includes best-effort output masking for values registered with Redactor.

Package sota is `bashy sota` — the research capability (P1).

Package spacetime measures where-and-when code is running and answers whether a declared predicate holds here-now.

Package steward is the host/user-scoped seat of authority and continuity: exactly one steward per machine-and-account, holding an append-only, hash-chained, evidence-carrying journal that outlives whoever holds the seat.

Package supervise implements `bashy supervise` — the conductor-as-a-verb.

Package telemetry gives bashy an OpenTelemetry voice.

Package todo is the STEWARD'S task list — level 1 of the tracking hierarchy:

Package treesitter provides in-process AST parsing and structural code search using tree-sitter grammars.

Package weave is the filesystem-based multi-agent workspace orchestrator re-homed from ycode into the AgentOS hub.

Package weavecli holds the agent-friendly CLI conventions every `ycode weave` subverb shares: versioned-envelope marshaling, stable exit-code constants, tty/agent-mode detection, and the BASHY_AGENTIC switch that flips all the user-visible defaults to machine-friendly.