# Tchiko Native GTK3 Linux sysadmin companion with sub-15ms local dispatch

> Source: <https://zyniq-solutions.github.io/Tchiko-Assistant-Sysadmin-companion/>
> Published: 2026-11-18 23:52:10+00:00

**Key takeaway:** Tchiko classifies chained shell pipelines into SAFE_READONLY, MUTATING_LOCAL, or PRIVILEGED_DESTRUCTIVE tiers so read-only diagnostics run without prompts in Supervised Review mode, and it snapshots every file write under config/snapshots/ with SHA-256 hashes for /undo rollback.

### 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.sh
```
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
```


