coreutils

module
v0.0.0-...-c495aaa Latest Latest
Warning

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

 Go to latest Published: Jul 31, 2026 License: MIT

README

coreutils

A pure-Go agent userland: one set of Unix-style tools with identical behavior on every major platform (Linux, macOS, Windows), no system binaries required.

This repo exists for agents, not humans. Agentic tools (shells, tool executors, automation harnesses) need a predictable command vocabulary — ls, cat, sort, git, … — that behaves the same whether the host is a Linux CI runner, a developer's Mac, or a Windows box with nothing installed. Re-implementing the tools in pure Go (no cgo, no shell-out) is what makes that possible: the same code path everywhere, embedded directly into the consuming process.

It pairs with qiangli/sh (a fork of mvdan.cc/sh/v3 with an in-process bash interpreter): sh provides the shell, coreutils provides the userland. Wired together through the interpreter's ExecHandler, an agent gets a complete Unix-like environment in a single Go process.

The agent contract

Every tool in this repo follows the same rules:

  • Deterministic output. LC_ALL=C semantics always; no locale, color, or terminal-width variance by default.
  • GNU-compatible where implemented. Behavior follows the GNU coreutils manual and POSIX — implemented from the documentation (or adapted from permissively-licensed reimplementations, see THIRD_PARTY_LICENSES.md), never from GPL sources. A supported flag means exactly what the upstream documentation says — same spelling, same defaults, same output; meanings are never changed or approximated.
  • Clear errors for the rest. Not every flag is supported. An unsupported flag or mode fails loudly, naming the flag, with exit code 2 — never silently ignored, never silently approximated.
  • Pure Go. No tool ever shells out to a system binary. If the pure-Go implementation can't do something, you get an error that says so.

Packages

  • git/ — self-contained git client built on go-git/v5: the typed API (Clone, Pull, Merge, …) for CLIs that own their flag parsing, and Exec(ctx, dir, args) for argv-style callers, with ErrUnsupported as the fall-back-or-fail signal. Pull and merge integrate fast-forwards only (preserving non-conflicting local changes, like real git); conflict resolution is out of scope by design. Even local-path remotes use go-git's in-process server transport — git-upload-pack is never spawned.

  • cmds/ — the userland: 74 commands (Phase A of docs/commands.md) covering file operations (cp, mv, rm, mkdir, ln, chmod, …), listing (ls, stat, du, df, …), text (cat, head, tail, wc, sort, uniq, cut, tr, grep, diff, …), system info (date, uname, id, …), checksums (md5/sha*sum, base64/32), and archives (tar, gzip). Each command is its own importable package registered into tool/'s registry; cmds/all pulls in everything. Agent-traffic compatibility includes GNU grep -A/-B/-C context and ordered --include filtering, plus sed addr,+N ranges and -i[SUFFIX] in-place editing.

  • tool/ — the framework: registry + per-invocation RunContext (stdio, working directory, environment — tools never touch process globals) + strict GNU-style flags with automatic --help/--version.

  • cmd/coreutils — busybox-style multicall binary (coreutils ls …, or symlink a tool name to the binary for argv[0] dispatch).

Planned next (see docs/commands.md): Phase B — the rest of the GNU manual (printf, test, expr, od, dd, …) — then sed/xargs/ps and the mvdan.cc/sh/v3 ExecHandler adapter.

Consumers

  • outpost — outpost git … is a cobra CLI over git/'s typed API.
  • ycode — yc git … dispatches through git.Exec natively, falling back to a host git binary (and then a container) for anything ErrUnsupported.

License

MIT

Directories

Path Synopsis
cmd
coreutils command
coreutils is the busybox-style multicall binary: invoke a tool as `coreutils <name> [args...]`, or symlink/rename the binary to a tool name and invoke it directly (argv[0] dispatch).
 coreutils is the busybox-style multicall binary: invoke a tool as `coreutils <name> [args...]`, or symlink/rename the binary to a tool name and invoke it directly (argv[0] dispatch).
perfbench command
Command perfbench is the DEV-ONLY host for the perfbench measurement harness (coreutils/cmds/perfbench).
 Command perfbench is the DEV-ONLY host for the perfbench measurement harness (coreutils/cmds/perfbench).
cmds
all
Package all registers every implemented command via blank imports.
 Package all registers every implemented command via blank imports.
arch
ast
Package astcmd registers the AgentOS code-intelligence feature as a single `ast` command with subcommands — `ast symbols` (list), `ast search`, `ast refs`, `ast map` (repo map), `ast query` (structural tree-sitter query) — reachable through every coreutils surface (shell dispatch, multicall, MCP run_tool).
 Package astcmd registers the AgentOS code-intelligence feature as a single `ast` command with subcommands — `ast symbols` (list), `ast search`, `ast refs`, `ast map` (repo map), `ast query` (structural tree-sitter query) — reachable through every coreutils surface (shell dispatch, multicall, MCP run_tool).
at
Package atcmd implements at(1): execute a command at a specified time.
 Package atcmd implements at(1): execute a command at a specified time.
atq
Package atqcmd implements atq(1): list pending one-shot `at` jobs from the bashy schedule store.
 Package atqcmd implements atq(1): list pending one-shot `at` jobs from the bashy schedule store.
atrm
Package atrmcmd implements atrm(1): remove pending `at` jobs from the bashy schedule store.
 Package atrmcmd implements atrm(1): remove pending `at` jobs from the bashy schedule store.
awk
Package awkcmd implements awk(1) by embedding GoAWK.
 Package awkcmd implements awk(1) by embedding GoAWK.
b2sum
Package b2sumcmd implements b2sum(1) for BLAKE2b-512 checksums.
 Package b2sumcmd implements b2sum(1) for BLAKE2b-512 checksums.
base32
Package base32cmd implements base32(1) per the GNU coreutils manual: encode with 76-column wrapping by default (-w COLS, 0 = no wrap), decode with -d (embedded newlines tolerated), -i to ignore non-alphabet bytes on decode.
 Package base32cmd implements base32(1) per the GNU coreutils manual: encode with 76-column wrapping by default (-w COLS, 0 = no wrap), decode with -d (embedded newlines tolerated), -i to ignore non-alphabet bytes on decode.
base64
Package base64cmd implements base64(1) per the GNU coreutils manual: encode with 76-column wrapping by default (-w COLS, 0 = no wrap), decode with -d (embedded newlines tolerated), -i to ignore non-alphabet bytes on decode.
 Package base64cmd implements base64(1) per the GNU coreutils manual: encode with 76-column wrapping by default (-w COLS, 0 = no wrap), decode with -d (embedded newlines tolerated), -i to ignore non-alphabet bytes on decode.
basename
Package basenamecmd implements basename(1) per the GNU coreutils manual: strip directory and (optionally) suffix from each NAME.
 Package basenamecmd implements basename(1) per the GNU coreutils manual: strip directory and (optionally) suffix from each NAME.
basenc
Package basenccmd implements basenc(1) for common RFC 4648 encodings.
 Package basenccmd implements basenc(1) for common RFC 4648 encodings.
batch
Package batchcmd implements batch(1): schedule a command to run when system load permits — in our implementation, this is an alias for "at now" (immediate one-shot).
 Package batchcmd implements batch(1): schedule a command to run when system load permits — in our implementation, this is an alias for "at now" (immediate one-shot).
browser
cal
Package calcmd implements cal(1): print a calendar for a month or year.
 Package calcmd implements cal(1): print a calendar for a month or year.
cat
Package catcmd implements cat(1) per the GNU coreutils manual: concatenate FILE(s) to standard output.
 Package catcmd implements cat(1) per the GNU coreutils manual: concatenate FILE(s) to standard output.
chcon
Package chconcmd implements chcon(1): change the SELinux security context of each FILE.
 Package chconcmd implements chcon(1): change the SELinux security context of each FILE.
chgrp
Package chgrpcmd implements chgrp(1) per the GNU coreutils manual: change the group of each FILE to GROUP (name or numeric id), with -R.
 Package chgrpcmd implements chgrp(1) per the GNU coreutils manual: change the group of each FILE to GROUP (name or numeric id), with -R.
chmod
Package chmodcmd implements chmod(1) per the GNU coreutils manual: change file mode bits, with octal and symbolic modes and -R.
 Package chmodcmd implements chmod(1) per the GNU coreutils manual: change file mode bits, with octal and symbolic modes and -R.
chown
Package chowncmd implements chown(1) per the GNU coreutils manual: change file owner and group ([OWNER][:[GROUP]] by name or numeric ID), with -R.
 Package chowncmd implements chown(1) per the GNU coreutils manual: change file owner and group ([OWNER][:[GROUP]] by name or numeric ID), with -R.
chroot
cksum
Package cksumcmd implements POSIX cksum(1) plus GNU's -a digest multiplexer.
 Package cksumcmd implements POSIX cksum(1) plus GNU's -a digest multiplexer.
clip
Package clipcmd implements `clip`: read/write the system clipboard (pbcopy/pbpaste-style).
 Package clipcmd implements `clip`: read/write the system clipboard (pbcopy/pbpaste-style).
cmp
Package cmpcmd implements cmp(1) per the GNU diffutils manual: compare two files byte by byte.
 Package cmpcmd implements cmp(1) per the GNU diffutils manual: compare two files byte by byte.
comm
Package commcmd implements comm(1) per the GNU coreutils manual: compare two sorted files line by line, producing three-column output — lines unique to FILE1, lines unique to FILE2, and lines common to both — with each output column indented by one TAB per column printed before it.
 Package commcmd implements comm(1) per the GNU coreutils manual: compare two sorted files line by line, producing three-column output — lines unique to FILE1, lines unique to FILE2, and lines common to both — with each output column indented by one TAB per column printed before it.
cp
Package cpcmd implements cp(1) per the GNU coreutils manual: copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.
 Package cpcmd implements cp(1) per the GNU coreutils manual: copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.
crontab
Package crontabcmd implements crontab(1): manage per-user cron tables backed by the bashy schedule store.
 Package crontabcmd implements crontab(1): manage per-user cron tables backed by the bashy schedule store.
csplit
Package csplitcmd implements a practical csplit(1) subset: split an input file at line numbers or regular-expression matches.
 Package csplitcmd implements a practical csplit(1) subset: split an input file at line numbers or regular-expression matches.
cut
Package cutcmd implements cut(1) per the GNU coreutils manual: print selected parts of lines from each FILE to standard output.
 Package cutcmd implements cut(1) per the GNU coreutils manual: print selected parts of lines from each FILE to standard output.
date
Package datecmd implements date(1) per the GNU coreutils manual (C locale): print the current (or specified) time in the default format or per a +FORMAT operand built from strftime directives.
 Package datecmd implements date(1) per the GNU coreutils manual (C locale): print the current (or specified) time in the default format or per a +FORMAT operand built from strftime directives.
dd
Package ddcmd implements a practical dd(1) subset: copy bytes from input to output using dd-style KEY=VALUE operands.
 Package ddcmd implements a practical dd(1) subset: copy bytes from input to output using dd-style KEY=VALUE operands.
df
Package dfcmd implements df(1) per the GNU coreutils manual for the commonly used reporting flags.
 Package dfcmd implements df(1) per the GNU coreutils manual for the commonly used reporting flags.
diff
Package diffcmd implements diff(1) per GNU diffutils (https://www.gnu.org/software/diffutils/manual/): compare files line by line, in the default "normal" format or unified format (-u / -U NUM / --unified[=NUM]), with -r recursive directory comparison, -q brief mode, -N absent-as-empty, and the -i / -w / -b comparison-relaxing flags.
 Package diffcmd implements diff(1) per GNU diffutils (https://www.gnu.org/software/diffutils/manual/): compare files line by line, in the default "normal" format or unified format (-u / -U NUM / --unified[=NUM]), with -r recursive directory comparison, -q brief mode, -N absent-as-empty, and the -i / -w / -b comparison-relaxing flags.
dir
dircolors
Package dircolorscmd implements a useful GNU-compatible subset of dircolors(1): emit Bourne-shell or C-shell setup code for LS_COLORS, print the built-in database, and parse color database files with GNU's TERM/COLORTERM gating (entries before any TERM/COLORTERM line always apply; entries after them apply once any pattern has matched the current terminal).
 Package dircolorscmd implements a useful GNU-compatible subset of dircolors(1): emit Bourne-shell or C-shell setup code for LS_COLORS, print the built-in database, and parse color database files with GNU's TERM/COLORTERM gating (entries before any TERM/COLORTERM line always apply; entries after them apply once any pattern has matched the current terminal).
dirname
Package dirnamecmd implements dirname(1) per the GNU coreutils manual: output each NAME with its last non-slash component and trailing slashes removed; if NAME contains no '/', output '.'.
 Package dirnamecmd implements dirname(1) per the GNU coreutils manual: output each NAME with its last non-slash component and trailing slashes removed; if NAME contains no '/', output '.'.
du
Package ducmd implements du(1) per the GNU coreutils manual for the flag subset -a -b -c -d/--max-depth -h -s.
 Package ducmd implements du(1) per the GNU coreutils manual for the flag subset -a -b -c -d/--max-depth -h -s.
duration
echo
Package echocmd implements echo(1) per the GNU coreutils manual: write arguments to standard output, separated by spaces, terminated by a newline.
 Package echocmd implements echo(1) per the GNU coreutils manual: write arguments to standard output, separated by spaces, terminated by a newline.
env
Package envcmd implements env(1) per the GNU coreutils manual: print the environment, optionally modified by -i, -u NAME, and NAME=VALUE assignments, or run a command in that environment.
 Package envcmd implements env(1) per the GNU coreutils manual: print the environment, optionally modified by -i, -u NAME, and NAME=VALUE assignments, or run a command in that environment.
expand
Package expandcmd implements expand(1): convert tabs to spaces.
 Package expandcmd implements expand(1): convert tabs to spaces.
expr
factor
false
Package falsecmd implements false(1): do nothing, unsuccessfully.
 Package falsecmd implements false(1): do nothing, unsuccessfully.
fetch
Package fetchcmd implements `fetch`: an agent-friendly URL / REST client.
 Package fetchcmd implements `fetch`: an agent-friendly URL / REST client.
find
Package findcmd implements find(1) per the GNU findutils manual: walk each starting-point and evaluate an expression for every file.
 Package findcmd implements find(1) per the GNU findutils manual: walk each starting-point and evaluate an expression for every file.
fmt
Package fmtcmd implements fmt(1): simple paragraph formatting.
 Package fmtcmd implements fmt(1): simple paragraph formatting.
fold
Package foldcmd implements fold(1): wrap input lines.
 Package foldcmd implements fold(1): wrap input lines.
foreman
graph
Package graphcmd registers the AgentOS code-knowledge-graph feature as a single `graph` command with subcommands — `graph build`, `graph stats`, `graph neighbors`, `graph impact`, `graph path`, `graph hotspots`, `graph query` (the structural, gfy-backed code-graph reads over coreutils/pkg/codegraph) plus the contribution subcommands `graph note`, `graph link`, `graph observe`, `graph forget`, `graph recall`, `graph notes`, `graph pitfalls` (the durable per-repo "agentic wiki").
 Package graphcmd registers the AgentOS code-knowledge-graph feature as a single `graph` command with subcommands — `graph build`, `graph stats`, `graph neighbors`, `graph impact`, `graph path`, `graph hotspots`, `graph query` (the structural, gfy-backed code-graph reads over coreutils/pkg/codegraph) plus the contribution subcommands `graph note`, `graph link`, `graph observe`, `graph forget`, `graph recall`, `graph notes`, `graph pitfalls` (the durable per-repo "agentic wiki").
grep
Package grepcmd implements grep(1) per the GNU grep manual: print lines of each FILE (or standard input) that match PATTERNS.
 Package grepcmd implements grep(1) per the GNU grep manual: print lines of each FILE (or standard input) that match PATTERNS.
groups
gzip
Package gzipcmd implements gzip(1), plus the gunzip and zcat aliases, per the GNU gzip manual: -d decompress, -k keep, -c stdout, -f force, -1..-9 / --fast / --best levels.
 Package gzipcmd implements gzip(1), plus the gunzip and zcat aliases, per the GNU gzip manual: -d decompress, -k keep, -c stdout, -f force, -1..-9 / --fast / --best levels.
head
Package headcmd implements head(1) per the GNU coreutils manual: output the first part of files.
 Package headcmd implements head(1) per the GNU coreutils manual: output the first part of files.
hexdump
Package hexdumpcmd implements hexdump(1) (util-linux) in its canonical -C mode only: hex+ASCII display, 16 bytes per line, with the documented default squeezing of repeated identical lines into a single "*" and a final line giving the total input offset.
 Package hexdumpcmd implements hexdump(1) (util-linux) in its canonical -C mode only: hex+ASCII display, 16 bytes per line, with the documented default squeezing of repeated identical lines into a single "*" and a final line giving the total input offset.
hostid
hostname
Package hostnamecmd implements hostname(1) (print mode only): show the system's host name.
 Package hostnamecmd implements hostname(1) (print mode only): show the system's host name.
id
Package idcmd implements id(1) per the GNU coreutils manual: print user and group information for a specified USER, or for the current process when no USER is given.
 Package idcmd implements id(1) per the GNU coreutils manual: print user and group information for a specified USER, or for the current process when no USER is given.
install
Package installcmd implements a practical GNU install(1) subset: directory creation plus copying regular files with final chmod.
 Package installcmd implements a practical GNU install(1) subset: directory creation plus copying regular files with final chmod.
internal/hashenc
Package hashenc is the shared, non-registered engine behind the checksum tools (md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum) and the base-encoding tools (base64, base32).
 Package hashenc is the shared, non-registered engine behind the checksum tools (md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum) and the base-encoding tools (base64, base32).
internal/rootguard
Package rootguard provides filesystem-identity checks for recursive commands' --preserve-root failsafes.
 Package rootguard provides filesystem-identity checks for recursive commands' --preserve-root failsafes.
internal/session
join
Package joincmd implements join(1) per the GNU coreutils manual: for each pair of input lines with identical join fields, write a line to standard output.
 Package joincmd implements join(1) per the GNU coreutils manual: for each pair of input lines with identical join fields, write a line to standard output.
jq
Package jqcmd implements jq(1) for JSON filtering.
 Package jqcmd implements jq(1) for JSON filtering.
link
Package linkcmd implements link(1) per the GNU coreutils manual: call the link function to create a link named FILE2 to an existing FILE1.
 Package linkcmd implements link(1) per the GNU coreutils manual: call the link function to create a link named FILE2 to an existing FILE1.
ln
Package lncmd implements ln(1) per the GNU coreutils manual: make hard or symbolic links between files.
 Package lncmd implements ln(1) per the GNU coreutils manual: make hard or symbolic links between files.
logname
ls
Package lscmd implements ls(1) per the GNU coreutils manual for the flag subset -l -a -A -d -R -r -t -S -1 -h -i.
 Package lscmd implements ls(1) per the GNU coreutils manual for the flag subset -l -a -A -d -R -r -t -S -1 -h -i.
md5sum
Package md5sumcmd implements md5sum(1) per the GNU coreutils manual: print "<hex> <file>" lines ("-" = stdin), -b switches the separator to " *" (digest bytes are identical on every platform — no text-mode translation ever happens), --tag emits BSD-style output, -c verifies checksum lists with OK/FAILED per line and GNU WARNING summaries.
 Package md5sumcmd implements md5sum(1) per the GNU coreutils manual: print "<hex> <file>" lines ("-" = stdin), -b switches the separator to " *" (digest bytes are identical on every platform — no text-mode translation ever happens), --tag emits BSD-style output, -c verifies checksum lists with OK/FAILED per line and GNU WARNING summaries.
mkdir
Package mkdircmd implements mkdir(1) per the GNU coreutils manual: create the DIRECTORY(ies), if they do not already exist.
 Package mkdircmd implements mkdir(1) per the GNU coreutils manual: create the DIRECTORY(ies), if they do not already exist.
mkfifo
Package mkfifocmd implements mkfifo(1): create named pipes.
 Package mkfifocmd implements mkfifo(1): create named pipes.
mknod
Package mknodcmd implements mknod(1): create special files.
 Package mknodcmd implements mknod(1): create special files.
mktemp
Package mktempcmd implements mktemp(1) per the GNU coreutils manual: create a temporary file or directory safely and print its name.
 Package mktempcmd implements mktemp(1) per the GNU coreutils manual: create a temporary file or directory safely and print its name.
more
Package morecmd implements a non-interactive more(1) fallback for agent use: concatenate files or stdin to stdout without terminal control.
 Package morecmd implements a non-interactive more(1) fallback for agent use: concatenate files or stdin to stdout without terminal control.
mv
Package mvcmd implements mv(1) per the GNU coreutils manual: rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
 Package mvcmd implements mv(1) per the GNU coreutils manual: rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
nice
nl
Package nlcmd implements a focused nl(1) subset: line numbering for files and standard input with common style, format, separator, width, and numbering-sequence options.
 Package nlcmd implements a focused nl(1) subset: line numbering for files and standard input with common style, format, separator, width, and numbering-sequence options.
nohup
nproc
ntp
numfmt
Package numfmtcmd implements a compact numfmt(1) subset for common SI/IEC scaling conversions.
 Package numfmtcmd implements a compact numfmt(1) subset for common SI/IEC scaling conversions.
od
Package odcmd implements a practical od(1) subset for agents: octal-word default output plus common byte-oriented -t formats and offset/limit controls.
 Package odcmd implements a practical od(1) subset for agents: octal-word default output plus common byte-oriented -t formats and offset/limit controls.
paste
Package pastecmd implements paste(1) per the GNU coreutils manual: write lines consisting of the sequentially corresponding lines from each FILE, separated by TABs, to standard output.
 Package pastecmd implements paste(1) per the GNU coreutils manual: write lines consisting of the sequentially corresponding lines from each FILE, separated by TABs, to standard output.
pathchk
perfbench
Package perfbenchcmd is the DEV-ONLY measurement harness for the bashy-vs-GNU head-to-head: a cmdperf/hyperfine-style A/B timing runner (mode "run") plus a byte-identical GNU-fidelity differ (mode "conformance") plus a deterministic corpus generator (mode "gen"), over the complete coreutils 9.11 inventory (inventory.go).
 Package perfbenchcmd is the DEV-ONLY measurement harness for the bashy-vs-GNU head-to-head: a cmdperf/hyperfine-style A/B timing runner (mode "run") plus a byte-identical GNU-fidelity differ (mode "conformance") plus a deterministic corpus generator (mode "gen"), over the complete coreutils 9.11 inventory (inventory.go).
pinky
pr
Package prcmd implements a pr(1) subset: GNU page structure (66-line pages: 5-line header, body, 5-line trailer, with the last page padded to full length), form-feed page breaks, page ranges (--pages and the +FIRST[:LAST] operand), line numbering, margins, and -t/-T.
 Package prcmd implements a pr(1) subset: GNU page structure (66-line pages: 5-line header, body, 5-line trailer, with the last page padded to full length), form-feed page breaks, page ranges (--pages and the +FIRST[:LAST] operand), line numbering, margins, and -t/-T.
printenv
Package printenvcmd implements printenv(1) per the GNU coreutils manual: print all environment variables, or the values of the named VARIABLEs.
 Package printenvcmd implements printenv(1) per the GNU coreutils manual: print all environment variables, or the values of the named VARIABLEs.
ptx
Package ptxcmd implements ptx(1): produce a permuted index of file contents in GNU's dumb-terminal output format — each keyword aligned at the center of a line of --width columns (default 72), fields separated by --gap-size spaces (default 3), with '/' marking truncated context, roff .xx lines via -O/--format=roff, or TeX macro lines via -T/--format=tex.
 Package ptxcmd implements ptx(1): produce a permuted index of file contents in GNU's dumb-terminal output format — each keyword aligned at the center of a line of --width columns (default 72), fields separated by --gap-size spaces (default 3), with '/' marking truncated context, roff .xx lines via -O/--format=roff, or TeX macro lines via -T/--format=tex.
pwd
Package pwdcmd implements pwd(1) per the GNU coreutils manual: print the name of the current working directory.
 Package pwdcmd implements pwd(1) per the GNU coreutils manual: print the name of the current working directory.
readlink
Canonicalization engine shared (by duplication — cmds packages do not import each other) with cmds/realpath.
 Canonicalization engine shared (by duplication — cmds packages do not import each other) with cmds/realpath.
realpath
Canonicalization engine shared (by duplication — cmds packages do not import each other) with cmds/readlink.
 Canonicalization engine shared (by duplication — cmds packages do not import each other) with cmds/readlink.
resources
Package resourcescmd implements `resources`: report fleet utilization across providers (Anthropic, OpenAI, Google, Zhipu, Moonshot, DeepSeek) and bands (L1-L4).
 Package resourcescmd implements `resources`: report fleet utilization across providers (Anthropic, OpenAI, Google, Zhipu, Moonshot, DeepSeek) and bands (L1-L4).
rm
Package rmcmd implements rm(1) per the GNU coreutils manual: remove files or directories.
 Package rmcmd implements rm(1) per the GNU coreutils manual: remove files or directories.
rmdir
Package rmdircmd implements rmdir(1) per the GNU coreutils manual: remove the DIRECTORY(ies), if they are empty.
 Package rmdircmd implements rmdir(1) per the GNU coreutils manual: remove the DIRECTORY(ies), if they are empty.
runcon
sed
Package sedcmd implements a pure-Go drop-in for GNU sed: a stream editor that applies a script to each line of its input.
 Package sedcmd implements a pure-Go drop-in for GNU sed: a stream editor that applies a script to each line of its input.
sed/internal/gosed
Package gosed implements the classic UNIX sed language in pure Go.
 Package gosed implements the classic UNIX sed language in pure Go.
seq
Package seqcmd implements seq(1) per the GNU coreutils manual: print numbers from FIRST to LAST, in steps of INCREMENT.
 Package seqcmd implements seq(1) per the GNU coreutils manual: print numbers from FIRST to LAST, in steps of INCREMENT.
sha1sum
Package sha1sumcmd implements sha1sum(1) per the GNU coreutils manual.
 Package sha1sumcmd implements sha1sum(1) per the GNU coreutils manual.
sha224sum
Package sha224sumcmd implements sha224sum(1) per the GNU coreutils manual.
 Package sha224sumcmd implements sha224sum(1) per the GNU coreutils manual.
sha256sum
Package sha256sumcmd implements sha256sum(1) per the GNU coreutils manual.
 Package sha256sumcmd implements sha256sum(1) per the GNU coreutils manual.
sha384sum
Package sha384sumcmd implements sha384sum(1) per the GNU coreutils manual.
 Package sha384sumcmd implements sha384sum(1) per the GNU coreutils manual.
sha512sum
Package sha512sumcmd implements sha512sum(1) per the GNU coreutils manual.
 Package sha512sumcmd implements sha512sum(1) per the GNU coreutils manual.
shred
Package shredcmd implements shred(1) for regular files: overwrite file contents to make casual recovery harder, optionally remove the file.
 Package shredcmd implements shred(1) for regular files: overwrite file contents to make casual recovery harder, optionally remove the file.
shuf
Package shufcmd implements shuf(1) per the GNU coreutils manual: write a random permutation of the input lines to standard output.
 Package shufcmd implements shuf(1) per the GNU coreutils manual: write a random permutation of the input lines to standard output.
sleep
Package sleepcmd implements sleep(1) per the GNU coreutils manual: pause for NUMBER seconds, where NUMBER may be fractional and may carry an s/m/h/d suffix; multiple arguments are summed.
 Package sleepcmd implements sleep(1) per the GNU coreutils manual: pause for NUMBER seconds, where NUMBER may be fractional and may carry an s/m/h/d suffix; multiple arguments are summed.
sort
Sort-algorithm selection: unstable pdqsort where the comparator is a total order, parallel chunk sort + stable k-way merge above a size threshold, and an LSD radix sort for the all-integer numeric fast path.
 Sort-algorithm selection: unstable pdqsort where the comparator is a total order, parallel chunk sort + stable k-way merge above a size threshold, and an LSD radix sort for the all-integer numeric fast path.
split
Package splitcmd implements split(1) per the GNU coreutils manual: split a file into pieces.
 Package splitcmd implements split(1) per the GNU coreutils manual: split a file into pieces.
stat
Package statcmd implements stat(1) per the GNU coreutils manual: the default information block, plus --format/-c --printf --terse/-t --dereference/-L --file-system/-f with directives %n %s %F %a %U %G %u %g %x %y %z %i %h (and %%).
 Package statcmd implements stat(1) per the GNU coreutils manual: the default information block, plus --format/-c --printf --terse/-t --dereference/-L --file-system/-f with directives %n %s %F %a %U %G %u %g %x %y %z %i %h (and %%).
stdbuf
strings
Package stringscmd implements strings(1) per the GNU binutils manual: print the sequences of printable characters in files.
 Package stringscmd implements strings(1) per the GNU binutils manual: print the sequences of printable characters in files.
stty
sum
Package sumcmd implements the legacy sum(1) checksum utility.
 Package sumcmd implements the legacy sum(1) checksum utility.
sync
Package synccmd implements sync(1) per the GNU coreutils manual: synchronize cached writes to persistent storage.
 Package synccmd implements sync(1) per the GNU coreutils manual: synchronize cached writes to persistent storage.
tac
Package taccmd implements tac(1) per the GNU coreutils manual: concatenate and print files in reverse (record order).
 Package taccmd implements tac(1) per the GNU coreutils manual: concatenate and print files in reverse (record order).
tail
Package tailcmd implements tail(1) per the GNU coreutils manual: output the last part of files.
 Package tailcmd implements tail(1) per the GNU coreutils manual: output the last part of files.
tar
Package tarcmd implements tar(1) — the GNU tar common surface: -c create, -x extract, -t list, -f FILE ('-' = stdin/stdout), -z gzip, -v verbose, -C DIR, --strip-components=N (extract).
 Package tarcmd implements tar(1) — the GNU tar common surface: -c create, -x extract, -t list, -f FILE ('-' = stdin/stdout), -z gzip, -v verbose, -C DIR, --strip-components=N (extract).
tee
Package teecmd implements tee(1) per the GNU coreutils manual: copy standard input to each FILE, and also to standard output.
 Package teecmd implements tee(1) per the GNU coreutils manual: copy standard input to each FILE, and also to standard output.
time
Package timecmd implements a pure-Go drop-in for the GNU `time` utility (`/usr/bin/time`): run a program, then report the real (wall), user, and system time it consumed (plus peak resident memory where the OS exposes it).
 Package timecmd implements a pure-Go drop-in for the GNU `time` utility (`/usr/bin/time`): run a program, then report the real (wall), user, and system time it consumed (plus peak resident memory where the OS exposes it).
timeout
Package timeoutcmd implements a pure-Go drop-in for the GNU `timeout` utility: run COMMAND, and if it is still running after DURATION, send it a signal (SIGTERM by default).
 Package timeoutcmd implements a pure-Go drop-in for the GNU `timeout` utility: run COMMAND, and if it is still running after DURATION, send it a signal (SIGTERM by default).
tokens
Package tokenscmd implements `tokens`: count the LLM tokens of files or standard input — a `wc` for tokens, so an agent can budget context before reading.
 Package tokenscmd implements `tokens`: count the LLM tokens of files or standard input — a `wc` for tokens, so an agent can budget context before reading.
touch
Package touchcmd implements touch(1) per the GNU coreutils manual: update the access and modification times of each FILE to the current time, creating missing files unless told otherwise.
 Package touchcmd implements touch(1) per the GNU coreutils manual: update the access and modification times of each FILE to the current time, creating missing files unless told otherwise.
tr
Package trcmd implements tr(1) per the GNU coreutils manual: translate, squeeze, and/or delete characters from standard input, writing to standard output.
 Package trcmd implements tr(1) per the GNU coreutils manual: translate, squeeze, and/or delete characters from standard input, writing to standard output.
tree
Package treecmd implements a pure-Go tree(1): a recursive, indented listing of a directory using box-drawing connectors, ending with a directory/file count.
 Package treecmd implements a pure-Go tree(1): a recursive, indented listing of a directory using box-drawing connectors, ending with a directory/file count.
true
Package truecmd implements true(1): do nothing, successfully.
 Package truecmd implements true(1): do nothing, successfully.
truncate
Package truncatecmd implements truncate(1) per the GNU coreutils manual: shrink or extend the size of each FILE to the specified size.
 Package truncatecmd implements truncate(1) per the GNU coreutils manual: shrink or extend the size of each FILE to the specified size.
tsort
Package tsortcmd implements tsort(1) per POSIX.1-2024 and the GNU coreutils manual: write a totally ordered list of items consistent with the partial ordering given as whitespace-separated pairs in FILE (or standard input; "-" means standard input).
 Package tsortcmd implements tsort(1) per POSIX.1-2024 and the GNU coreutils manual: write a totally ordered list of items consistent with the partial ordering given as whitespace-separated pairs in FILE (or standard input; "-" means standard input).
tty
Package ttycmd implements tty(1) per the GNU coreutils manual: print the file name of the terminal connected to standard input, or "not a tty" (exit status 1) when standard input is not a terminal.
 Package ttycmd implements tty(1) per the GNU coreutils manual: print the file name of the terminal connected to standard input, or "not a tty" (exit status 1) when standard input is not a terminal.
tz
uname
Package unamecmd implements uname(1) per the GNU coreutils manual: print system information.
 Package unamecmd implements uname(1) per the GNU coreutils manual: print system information.
unexpand
Package unexpandcmd implements unexpand(1): convert spaces to tabs.
 Package unexpandcmd implements unexpand(1): convert spaces to tabs.
uniq
Package uniqcmd implements uniq(1) per the GNU coreutils manual: filter adjacent matching lines from INPUT (or standard input), writing to OUTPUT (or standard output).
 Package uniqcmd implements uniq(1) per the GNU coreutils manual: filter adjacent matching lines from INPUT (or standard input), writing to OUTPUT (or standard output).
unlink
Package unlinkcmd implements unlink(1) per the GNU coreutils manual: call the unlink function to remove the specified FILE.
 Package unlinkcmd implements unlink(1) per the GNU coreutils manual: call the unlink function to remove the specified FILE.
uptime
Package uptimecmd implements uptime(1) (GNU/procps output shape): current time, how long the system has been running, and the load averages where the platform provides them.
 Package uptimecmd implements uptime(1) (GNU/procps output shape): current time, how long the system has been running, and the load averages where the platform provides them.
users
vdir
watch
Package watchcmd implements watch(1): run a command periodically.
 Package watchcmd implements watch(1): run a command periodically.
wc
Package wccmd implements wc(1) per the GNU coreutils manual: print newline, word, character, byte, and maximum line length counts.
 Package wccmd implements wc(1) per the GNU coreutils manual: print newline, word, character, byte, and maximum line length counts.
which
Package whichcmd implements which(1) (debianutils/GNU-which common surface): locate each COMMAND on the search PATH and print the full path of the executable that would run.
 Package whichcmd implements which(1) (debianutils/GNU-which common surface): locate each COMMAND on the search PATH and print the full path of the executable that would run.
who
whoami
Package whoamicmd implements whoami(1) per the GNU coreutils manual: print the user name associated with the current effective user ID.
 Package whoamicmd implements whoami(1) per the GNU coreutils manual: print the user name associated with the current effective user ID.
xargs
Package xargscmd implements a pure-Go GNU-subset xargs: read items from standard input and run a command with them as arguments.
 Package xargscmd implements a pure-Go GNU-subset xargs: read items from standard input and run a command with them as arguments.
yes
Package yescmd implements yes(1) per the GNU coreutils manual: repeatedly output a line with all specified STRING(s), or 'y'.
 Package yescmd implements yes(1) per the GNU coreutils manual: repeatedly output a line with all specified STRING(s), or 'y'.
external
act
Package act runs nektos/act (run GitHub Actions locally) as a managed external binary (pkg/binmgr): downloaded → sha256-verified → cached, never compiled in.
 Package act runs nektos/act (run GitHub Actions locally) as a managed external binary (pkg/binmgr): downloaded → sha256-verified → cached, never compiled in.
actrunner
Package actrunner runs Gitea's act_runner (the GitHub-Actions-compatible CI runner) as a managed external binary (pkg/binmgr) — the CI executor for the dhnt mesh.
 Package actrunner runs Gitea's act_runner (the GitHub-Actions-compatible CI runner) as a managed external binary (pkg/binmgr) — the CI executor for the dhnt mesh.
clang
Package clang provisions a standalone C/C++ toolchain on demand so `bashy clang` works on a bare node.
 Package clang provisions a standalone C/C++ toolchain on demand so `bashy clang` works on a bare node.
cmake
Package cmake provisions an official CMake on demand so `bashy cmake` works on a bare node with no system CMake: resolve the per-platform archive from Kitware's GitHub release, verify it against the published SHA-256 file, then hand off to binmgr's tree-mode Ensure (download → verify → extract → cache → exec).
 Package cmake provisions an official CMake on demand so `bashy cmake` works on a bare node with no system CMake: resolve the per-platform archive from Kitware's GitHub release, verify it against the published SHA-256 file, then hand off to binmgr's tree-mode Ensure (download → verify → extract → cache → exec).
curlbin
Package curlbin provides `bashy curl`.
 Package curlbin provides `bashy curl`.
gcloud
Package gcloud is a thin, cross-platform PASSTHROUGH wrapper for the Google Cloud SDK CLI (`gcloud`) — provisioning + exec, never a reimplementation.
 Package gcloud is a thin, cross-platform PASSTHROUGH wrapper for the Google Cloud SDK CLI (`gcloud`) — provisioning + exec, never a reimplementation.
gh
Package gh runs the GitHub CLI (cli/cli) as a managed external binary (pkg/binmgr): downloaded → sha256-verified → cached, never compiled in.
 Package gh runs the GitHub CLI (cli/cli) as a managed external binary (pkg/binmgr): downloaded → sha256-verified → cached, never compiled in.
gitscm
Package gitscm provisions a REAL git — the official git-for-windows MinGit on Windows — as a managed, checksum-verified toolchain.
 Package gitscm provisions a REAL git — the official git-for-windows MinGit on Windows — as a managed, checksum-verified toolchain.
gotoolchain
Package gotoolchain provisions an official Go toolchain on demand so `bashy go` works on a bare node with no system Go: resolve the platform archive from go.dev's release index (for the sha256 — go has no .sha256 sidecar), then hand off to binmgr's tree-mode Ensure (download → verify → extract the whole GOROOT → cache → exec).
 Package gotoolchain provisions an official Go toolchain on demand so `bashy go` works on a bare node with no system Go: resolve the platform archive from go.dev's release index (for the sha256 — go has no .sha256 sidecar), then hand off to binmgr's tree-mode Ensure (download → verify → extract the whole GOROOT → cache → exec).
helm
Package helm runs the Helm CLI (kubernetes package manager) as a managed external binary (pkg/binmgr): downloaded from get.helm.sh → sha256-verified → cached, never compiled in.
 Package helm runs the Helm CLI (kubernetes package manager) as a managed external binary (pkg/binmgr): downloaded from get.helm.sh → sha256-verified → cached, never compiled in.
kopia
Package kopia runs Kopia (a pure-Go, content-addressed, encrypted snapshot backup tool) as a managed external binary (pkg/binmgr) — the backup service for the dhnt mesh.
 Package kopia runs Kopia (a pure-Go, content-addressed, encrypted snapshot backup tool) as a managed external binary (pkg/binmgr) — the backup service for the dhnt mesh.
kube
Package kube holds the small pieces shared by the managed kubernetes clients `bashy kubectl` and `bashy helm`: cache-first binary resolution and the DKS kubeconfig default so both tools target the dhnt cluster out of the box.
 Package kube holds the small pieces shared by the managed kubernetes clients `bashy kubectl` and `bashy helm`: cache-first binary resolution and the DKS kubeconfig default so both tools target the dhnt cluster out of the box.
kubectl
Package kubectl runs the kubernetes CLI (kubectl) as a managed external binary (pkg/binmgr): downloaded from dl.k8s.io → sha256-verified → cached, never compiled in.
 Package kubectl runs the kubernetes CLI (kubectl) as a managed external binary (pkg/binmgr): downloaded from dl.k8s.io → sha256-verified → cached, never compiled in.
loom
Package loom runs Gitea as a managed external binary (pkg/binmgr) — the git forge for the dhnt mesh.
 Package loom runs Gitea as a managed external binary (pkg/binmgr) — the git forge for the dhnt mesh.
meshagent
Package meshagent resolves and execs the outpost mesh agent WITHOUT linking it, so bashy stays the standalone userland keystone.
 Package meshagent resolves and execs the outpost mesh agent WITHOUT linking it, so bashy stays the standalone userland keystone.
mise
Package mise runs jdx/mise (the polyglot dev-tool / runtime version manager) as a managed external binary (pkg/binmgr): downloaded → verified → cached, never compiled in.
 Package mise runs jdx/mise (the polyglot dev-tool / runtime version manager) as a managed external binary (pkg/binmgr): downloaded → verified → cached, never compiled in.
node
Package node provisions an official Node.js runtime on demand so `bashy node` (and `npm`/`npx` via the same tree) work on a bare node with no system Node: resolve the platform archive + its sha256 from nodejs.org's per-release SHASUMS256.txt, then hand off to binmgr's tree-mode Ensure (download → verify → extract → cache → exec).
 Package node provisions an official Node.js runtime on demand so `bashy node` (and `npm`/`npx` via the same tree) work on a bare node with no system Node: resolve the platform archive + its sha256 from nodejs.org's per-release SHASUMS256.txt, then hand off to binmgr's tree-mode Ensure (download → verify → extract → cache → exec).
ollama
Package ollama is a thin shell-out front-door to an externally installed ollama binary, and provides Cobra commands to manage and run models.
 Package ollama is a thin shell-out front-door to an externally installed ollama binary, and provides Cobra commands to manage and run models.
ollama/runner_embed
Package runner_embed self-extracts an embedded ollama inference runner subprocess (llama.cpp + thin HTTP server) into the user cache on first use.
 Package runner_embed self-extracts an embedded ollama inference runner subprocess (llama.cpp + thin HTTP server) into the user cache on first use.
ollama/web
Package web provides the embedded Ollama management web UI.
 Package web provides the embedded Ollama management web UI.
podman
Package podman is a thin shell-out front-door to an externally installed podman binary.
 Package podman is a thin shell-out front-door to an externally installed podman binary.
podman/engine
dks.go — the `bashy dks` front-door verb: provision and manage the dedicated, uniform, ROOTFUL podman machine that DKS (the dhnt Kubernetes tier) runs k3s in.
 dks.go — the `bashy dks` front-door verb: provision and manage the dedicated, uniform, ROOTFUL podman machine that DKS (the dhnt Kubernetes tier) runs k3s in.
podman/engine/gvproxy_embed
Package gvproxy_embed self-extracts an embedded gvproxy binary (the user-mode network proxy `podman machine` forwards host sockets through) into the user cache on first use.
 Package gvproxy_embed self-extracts an embedded gvproxy binary (the user-mode network proxy `podman machine` forwards host sockets through) into the user cache on first use.
podman/engine/podman_embed
Package podman_embed self-extracts an embedded podman binary into the user cache on first use.
 Package podman_embed self-extracts an embedded podman binary into the user cache on first use.
podman/engine/vfkit_embed
Package vfkit_embed self-extracts an embedded vfkit binary (Apple Virtualization Framework helper for `podman machine`) into the user cache on first use.
 Package vfkit_embed self-extracts an embedded vfkit binary (Apple Virtualization Framework helper for `podman machine`) into the user cache on first use.
podman/winhelper
Package winhelper provisions the helper binaries podman needs on Windows, and exports the environment that lets podman find them.
 Package winhelper provisions the helper binaries podman needs on Windows, and exports the environment that lets podman find them.
python
Package python provisions the Python toolchain on demand via astral-sh/uv — a single self-contained binary that itself downloads + manages CPython.
 Package python provisions the Python toolchain on demand via astral-sh/uv — a single self-contained binary that itself downloads + manages CPython.
rclone
Package rclone runs rclone (a pure-Go, MIT, sync/transfer multi-protocol tool) as a managed external binary (pkg/binmgr) — the transfer engine for the dhnt mesh directory-mirror (pkg/mirror) and a NAS-style file server.
 Package rclone runs rclone (a pure-Go, MIT, sync/transfer multi-protocol tool) as a managed external binary (pkg/binmgr) — the transfer engine for the dhnt mesh directory-mirror (pkg/mirror) and a NAS-style file server.
registry
Package registry is the declarative catalog of self-provisioning managed external CLIs — the tier-5/6 client tools bashy fronts (kubectl, helm, doctl, and, as they land, aws/azure/gcloud/…).
 Package registry is the declarative catalog of self-provisioning managed external CLIs — the tier-5/6 client tools bashy fronts (kubectl, helm, doctl, and, as they land, aws/azure/gcloud/…).
rust
Package rust provisions the Rust toolchain on demand via the official rustup-init, so `bashy cargo`/`rustc`/`rustup` work on a bare node with no system Rust: binmgr fetches rustup-init (download → sha256-verify via the official .sha256 sidecar → cache), then runs it once with a bashy-owned CARGO_HOME/RUSTUP_HOME (minimal profile, no PATH modification).
 Package rust provisions the Rust toolchain on demand via the official rustup-init, so `bashy cargo`/`rustc`/`rustup` work on a bare node with no system Rust: binmgr fetches rustup-init (download → sha256-verify via the official .sha256 sidecar → cache), then runs it once with a bashy-owned CARGO_HOME/RUSTUP_HOME (minimal profile, no PATH modification).
seaweedfs
Package seaweedfs runs SeaweedFS (a pure-Go object/blob store with an S3 gateway) as a managed external binary (pkg/binmgr) — the storage spine for the dhnt mesh (it can also back the Zot registry's blob store).
 Package seaweedfs runs SeaweedFS (a pure-Go object/blob store with an S3 gateway) as a managed external binary (pkg/binmgr) — the storage spine for the dhnt mesh (it can also back the Zot registry's blob store).
sphere
Package sphere is the `bashy sphere` front-door for the dhnt SPHERE tier (execution tier 4): multi-node, peer-direct pooled p2p inference/compute — the layer between a single-node sandbox and an orchestrated cluster.
 Package sphere is the `bashy sphere` front-door for the dhnt SPHERE tier (execution tier 4): multi-node, peer-direct pooled p2p inference/compute — the layer between a single-node sandbox and an orchestrated cluster.
tessaro
Package tessaro is the account / front-door for the dhnt system: `bashy tessaro` (login/logout/status/open) and the top-level shortcut `bashy login`.
 Package tessaro is the account / front-door for the dhnt system: `bashy tessaro` (login/logout/status/open) and the top-level shortcut `bashy login`.
zot
Package zot runs Zot (a pure-Go, OCI-native image/artifact registry) as a managed external binary (pkg/binmgr) — the OCI registry for the dhnt mesh.
 Package zot runs Zot (a pure-Go, OCI-native image/artifact registry) as a managed external binary (pkg/binmgr) — the OCI registry for the dhnt mesh.
otel module
Package git is a self-contained, pure-Go git client built on go-git/v5: the typical clone → edit → add → commit → push lifecycle, the read/inspect verbs (status, log, diff, branch, show, remote, fetch, merge-base, rev-list, ls-files, blame, grep), and the local write verbs (merge fast-forward, tag, reset, rm, config).
 Package git is a self-contained, pure-Go git client built on go-git/v5: the typical clone → edit → add → commit → push lifecycle, the read/inspect verbs (status, log, diff, branch, show, remote, fetch, merge-base, rev-list, ls-files, blame, grep), and the local write verbs (merge fast-forward, tag, reset, rm, config).
Package mcp exposes the coreutils tool registry over the Model Context Protocol — the third consumption surface (alongside the in-process shell ExecHandler and the busybox multicall binary) so that non-Go agents (codex, claude, …) can drive the AgentOS userland.
 Package mcp exposes the coreutils tool registry over the Model Context Protocol — the third consumption surface (alongside the in-process shell ExecHandler and the busybox multicall binary) so that non-Go agents (codex, claude, …) can drive the AgentOS userland.
Package multicall is the busybox-style dispatch shared by every binary that fronts the coreutils tool registry: the standalone `coreutils` binary, a symlink/rename to a tool name (argv[0] dispatch), and the AgentOS `bashy` bootstrapper which also offers `bashy <tool> …`.
 Package multicall is the busybox-style dispatch shared by every binary that fronts the coreutils tool registry: the standalone `coreutils` binary, a symlink/rename to a tool name (argv[0] dispatch), and the AgentOS `bashy` bootstrapper which also offers `bashy <tool> …`.
pkg
acp
Package acp is a small, bashy-owned adapter for the Agent Client Protocol (ACP).
 Package acp is a small, bashy-owned adapter for the Agent Client Protocol (ACP).
agentcmd
agentctl
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 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.
agentlaunch
agentpty
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 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.
ask
Package ask reaches the HUMAN OPERATOR for an ad-hoc value from inside an agent session.
 Package ask reaches the HUMAN OPERATOR for an ad-hoc value from inside an agent session.
assetring
Package assetring is the ring catalog shared by every declarative asset bashy carries: skills, tools, models, agents.
 Package assetring is the ring catalog shared by every declarative asset bashy carries: skills, tools, models, agents.
atlas
Package atlas is the Command Atlas: the curated multi-axis catalog of the bashy/coreutils command surface.
 Package atlas is the Command Atlas: the curated multi-axis catalog of the bashy/coreutils command surface.
autofix
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 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.
autoretry
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 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.
binmgr
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 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.
board
Package board implements bashy's read-only steward/conductor projection.
 Package board implements bashy's read-only steward/conductor projection.
bre
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 bre matches POSIX Basic Regular Expressions (plus the common GNU extensions), shared by the pure-Go tools that default to BRE (grep, sed).
browser
Package browser provides the per-session Client surface used by the browser_* tool shims.
 Package browser provides the per-session Client surface used by the browser_* tool shims.
browser/internal/cdpactions
browser/live
Package live is bashy's "live" browser mode — an MV3 Chrome extension paired with a Go WebSocket hub, used to drive the user's real, logged-in Chrome (cookies, SSO, fingerprint).
 Package live is bashy's "live" browser mode — an MV3 Chrome extension paired with a Go WebSocket hub, used to drive the user's real, logged-in Chrome (cookies, SSO, fingerprint).
browser/probe
browser/solo
browser/wire
Package wire is the build-tag-free transport schema for browser automation.
 Package wire is the build-tag-free transport schema for browser automation.
bus
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 bus is the agent notification bus: the PUSH half of how agents on a host coordinate, where `bashy kb` is the durable PULL half.
bus/event
Package event is the dependency-light publishing core of pkg/bus.
 Package event is the dependency-light publishing core of pkg/bus.
capability
Package capability is the living capability matrix behind capability-routed delegation (see dhnt/docs/capability-routed-delegation.md).
 Package capability is the living capability matrix behind capability-routed delegation (see dhnt/docs/capability-routed-delegation.md).
chat
codegraph
Package codegraph wraps gfy's knowledge graph pipeline for ycode.
 Package codegraph wraps gfy's knowledge graph pipeline for ycode.
coopauth
Package coopauth is the ONE shared implementation of the cloudbox/outpost cooperative-web-app identity + privilege model.
 Package coopauth is the ONE shared implementation of the cloudbox/outpost cooperative-web-app identity + privilege model.
craft
Package craft is the living skill graph: what a host has LEARNED from running skills, as opposed to which skills it has.
 Package craft is the living skill graph: what a host has LEARNED from running skills, as opposed to which skills it has.
ctty
Package ctty reaches the HUMAN OPERATOR from a process whose stdio does not belong to them.
 Package ctty reaches the HUMAN OPERATOR from a process whose stdio does not belong to them.
dag
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 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.
fleet
Package fleet is the declarative registry of the things an agentic host runs with: tools, models, and agents.
 Package fleet is the declarative registry of the things an agentic host runs with: tools, models, and agents.
foreman
gate
Package gate answers the one question every stage transition depends on:
 Package gate answers the one question every stage transition depends on:
handoff
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 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.
herald
Package herald reaches agents that are not on this host.
 Package herald reaches agents that are not on this host.
ignore
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 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.
issue
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 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.
jobs
judge
Package judge renders a SEMANTIC verdict on a piece of work: is it any good?
 Package judge renders a SEMANTIC verdict on a piece of work: is it any good?
kb
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 kb is the host-scope shared knowledge base for agents — the collective memory of every agent tool working on this machine, across all repositories.
lexicon
Package lexicon teaches a fleet of agentic tools a team's jargon.
 Package lexicon teaches a fleet of agentic tools a team's jargon.
llmbudget
Package llmbudget provides the local-first meter and gate for LLM calls.
 Package llmbudget provides the local-first meter and gate for LLM calls.
lockfile
Package lockfile provides process-scoped file locks with blocking, try-once, and bounded-wait acquisition.
 Package lockfile provides process-scoped file locks with blocking, try-once, and bounded-wait acquisition.
meet
Package meet implements `bashy meet` — a multi-participant deliberation session where agentic CLIs and a human take turns.
 Package meet implements `bashy meet` — a multi-participant deliberation session where agentic CLIs and a human take turns.
mirror
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 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.
nudge
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 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.
ollm
Package ollm wraps the Ollama API client, isolating the rest of the codebase from the underlying github.com/ollama/ollama dependency.
 Package ollm wraps the Ollama API client, isolating the rest of the codebase from the underlying github.com/ollama/ollama dependency.
otelquery
pair
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 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.
policy/audit
Package audit is the tamper-evident record of what a shell actually executed.
 Package audit is the tamper-evident record of what a shell actually executed.
policy/coord
Package coord stops two agents from writing the same project at the same time.
 Package coord stops two agents from writing the same project at the same time.
pricing
Package pricing provides a local, data-driven token price catalog.
 Package pricing provides a local, data-driven token price catalog.
principal
Package principal resolves a name to the thing it names, and says how to reach it.
 Package principal resolves a name to the thing it names, and says how to reach it.
recommend
Package recommend answers "the agent guessed the wrong name" from the shell's ground truth.
 Package recommend answers "the agent guessed the wrong name" from the shell's ground truth.
redact
Package redact removes HOST IDENTITY from text before it is stored, shared, or exported.
 Package redact removes HOST IDENTITY from text before it is stored, shared, or exported.
repomap
Package repomap generates structured overviews of code repositories.
 Package repomap generates structured overviews of code repositories.
resources
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 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.
role
Package role gives an assumed responsibility a place to be reached.
 Package role gives an assumed responsibility a place to be reached.
role/meetroom
Package meetroom implements pkg/role's rooms on top of `bashy meet`.
 Package meetroom implements pkg/role's rooms on top of `bashy meet`.
room
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 room is the same-host "host room": the canonical registry of live agentic-tool instances (membership) plus an append-only event log (timeline).
schedule
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 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).
scope
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).
 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).
sdlc
search
Local search (P0b) — the other half of the find-things primitive.
 Local search (P0b) — the other half of the find-things primitive.
secrets
Package secrets includes best-effort output masking for values registered with Redactor.
 Package secrets includes best-effort output masking for values registered with Redactor.
skills
sota
Package sota is `bashy sota` — the research capability (P1).
 Package sota is `bashy sota` — the research capability (P1).
spacetime
Package spacetime measures where-and-when code is running and answers whether a declared predicate holds here-now.
 Package spacetime measures where-and-when code is running and answers whether a declared predicate holds here-now.
steward
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 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.
supervise
Package supervise implements `bashy supervise` — the conductor-as-a-verb.
 Package supervise implements `bashy supervise` — the conductor-as-a-verb.
telemetry
Package telemetry gives bashy an OpenTelemetry voice.
 Package telemetry gives bashy an OpenTelemetry voice.
timezones
todo
Package todo is the STEWARD'S task list — level 1 of the tracking hierarchy:
 Package todo is the STEWARD'S task list — level 1 of the tracking hierarchy:
treesitter
Package treesitter provides in-process AST parsing and structural code search using tree-sitter grammars.
 Package treesitter provides in-process AST parsing and structural code search using tree-sitter grammars.
weave
Package weave is the filesystem-based multi-agent workspace orchestrator re-homed from ycode into the AgentOS hub.
 Package weave is the filesystem-based multi-agent workspace orchestrator re-homed from ycode into the AgentOS hub.
weave/memory
weavecli
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.
 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.
webinspect
oci module
Package shell adapts the coreutils tool registry to mvdan.cc/sh/v3 so any embedding shell exposes the whole pure-Go userland as in-process commands.
 Package shell adapts the coreutils tool registry to mvdan.cc/sh/v3 so any embedding shell exposes the whole pure-Go userland as in-process commands.
Package tool is the framework every command in this repository is built on: a registry of named tools, a process-free invocation context (stdio + working directory + environment, no os globals), and a strict GNU-style flag layer (flags.go).
 Package tool is the framework every command in this repository is built on: a registry of named tools, a process-free invocation context (stdio + working directory + environment, no os globals), and a strict GNU-style flag layer (flags.go).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.