Repository navigation
v0.4.0 — signed approvals + sy mcp
Transport B and the laptop side — approval power moves to keys; agents get a protocol.
The approval channel of v0.3.0 answered from a root shell. Now approval power is bound to a registered approver key, and the agent's toolkit speaks MCP over plain SSH.
- Signed approvals:
sysh approver add/list/removeregisters approver public keys (recommendedsk-*— hardware-backed: no signature without a physical touch).sysh approve <id> --showprints the exact request bytes; sign anywhere with stock tooling (ssh-keygen -Y sign -n sysh-approve) and submit with--sig. Verification is in-process (golang.org/x/crypto/ssh— no ssh-keygen on the verify path): the signature must cover the request's exact bytes, under thesysh-approvenamespace, by a key byte-identical to a registered approver. Requests stay TTL'd, single-use, content-bound — a captured signature approves nothing else. sy mcp— a stdio MCP server for agent harnesses:sy_exec,sy_docs,sy_policyover plain SSH as the unprivilegedsyuser, strict known_hosts, operator-edited host registry (~/.config/sy/hosts.toml). An approval-required exec surfaces the request id (isError: false, "do not retry") — no approval power of any kind in tool space.sy approve/sy approvals(operator side, same deb): the approval ceremony in one command — fetch the request bytes over your root SSH channel, display the server-recorded argv, recompute the request id locally before anything reaches the signing gesture, then sign and submit. Forsk-*keys: an insert-your-YubiKey loop, PIN and touch insidessh-keygen. A TTY-only confirmation prompt sits between the display and the signature; piped stdin is refused.
The trust argument, once: the FIDO2 PIN and touch prompts are blind — they authorize whatever bytes the invoking process signs. So the argv display must come from the server over a channel the agent cannot write to, which is why the ceremony is operator-run and absent from MCP tool space.
Verified live on a test host: full signed cycle (touch request → --show → sign → --sig → executed as root), all refusal paths live (stranger key, wrong namespace, cross-request signature, replayed signature), the MCP toolset end-to-end over real SSH, and the one-command ceremony driven from an agent session.
Deferred (v0.5 candidates, documented in PROJECT.md §9): sy approver-init setup wizard, phone-passkey approval transport (WebAuthn research note included), Telegram transport, seccomp read-only profile.
curl -LO https://github.com/xezpeleta/sysh/releases/download/v0.4.0/sysh_0.4.0_amd64.deb
apt install ./sysh_0.4.0_amd64.deb
sysh doctor