3-Tier Shell Risk Classifier
Tokenizes chained shell pipelines into SAFE_READONLY, MUTATING_LOCAL, or PRIVILEGED_DESTRUCTIVE. Read-only diagnostics run smoothly without prompts in Supervised Review mode.
Tchiko pairs sub-15ms local system diagnostics with the Antigravity NDJSON stream bridge, a 3-tier shell risk classifier, snapshot-backed file rollbacks, and an interactive BoopFace SVG overlay.
$git clone https://github.com/ZYNIQ-SOLUTIONS/Tchiko-Assistant-Sysadmin-companion.git
$cd Tchiko-Assistant-Sysadmin-companion && ./run_tchiko.shTokenizes chained shell pipelines into SAFE_READONLY, MUTATING_LOCAL, or PRIVILEGED_DESTRUCTIVE. Read-only diagnostics run smoothly without prompts in Supervised Review mode.
Every file patch and write records SHA-256 hashes and a pre-edit snapshot under config/snapshots/, enabling instant rollback via /undo or /rollback.
Resolves binaries and desktop launchers, checks SingletonLock and Crashpad dumps, scans session logs, verifies X.509 certificates via OpenSSL, and patches bundles safely.
Drop YAML-frontmatter runbooks (Nginx TLS, PostgreSQL, GPU/CUDA, Git Recovery) into skills/*.md. Matching procedures are automatically injected into the agent prompt.
Inspect Docker/Podman containers and tail Exited (137) logs, query failed systemd units and journald, audit listening sockets and UFW/nftables, plus disk, GPU, TLS, and Git tools.
Background daemon monitors RAM/Disk thresholds and failed systemd units with cooldown deduplication. Drop log files or folders onto the avatar for immediate analysis.
| 01 | Resolve Binaries | Checks PATH, ~/.local/bin symlinks, and .desktop launchers. |
| 02 | Inspect Locks | Audits stale SingletonLock sockets and recent Crashpad dumps. |
| 03 | Scan Crash Logs | Extracts ConnectError, TLS handshake, and segfault traces. |
| 04 | Audit X.509 Certs | Verifies bundled .pem certificate expiry dates via OpenSSL. |
| 05 | Atomic Patch | Saves snapshot + .bak backup before patching bundle options. |
| 06 | Verify & Report | Verifies fix integrity and streams root-cause summary to Chat. |
Uses system python3-gi and python3-gi-cairo packages for direct X11/XWayland RGBA compositing, streaming runtime logs to logs/tchiko.log.
# 1. Install system GTK3 & Cairo bindings
sudo apt update && sudo apt install -y \
python3 python3-venv python3-gi python3-gi-cairo gir1.2-gtk-3.0 xclip
# 2. Clone repository & run verification suite
git clone https://github.com/ZYNIQ-SOLUTIONS/Tchiko-Assistant-Sysadmin-companion.git
cd Tchiko-Assistant-Sysadmin-companion
make self-test && make test
# 3. Launch desktop companion (logs to logs/tchiko.log)
./run_tchiko.sh