Repository navigation
v0.1.0 — phase 1
First tagged release: the complete phase-1 control layer.
What it is: agents connect as the unprivileged sy user over SSH; the login shell (/usr/bin/sysh) enforces an operator-written argv policy with no shell semantics, and records everything server-side (journald + auditd, kernel-attested).
- Gateway: printable-ASCII argv split, exact-length matching, opt-in
restpatterns, deny rules with prefix semantics, per-rule timeouts with process-group kill backstop, 1 MiB output cap - Containment: NoNewPrivs, systemd scope execution (no-scope fallback),
ptrace_scope=1, root-only policy tree - Observability: journald events with key attribution (fingerprint, key id), policy hash, pre/post phases; auditd keys
sysh_exec/sysh_policy/sysh_lockdown - Operator channel:
sysh auth add/list/remove(option allowlist, canonical lines),sysh policy install/lint(denylist, warn-ack, permissive gated on auditd),sysh doctor(22 checks),sysh lockdown,sysh journal-group - One static Go binary, one .deb that does all host-local setup; snapshot-tested on Debian 12 (deployed and cold-reboot verified)
Honest limits: no seccomp yet (phase 2), approvals deferred (privileged rules refuse at exit 126), amd64 only.
curl -LO https://github.com/xezpeleta/sysh/releases/download/v0.1.0/sysh_0.1.0_amd64.deb
apt install ./sysh_0.1.0_amd64.deb
sysh doctor