Tchiko Assistant v1.2
Ubuntu 22.04–25.10 · Google Antigravity SDK · MIT Open Source

Autonomous Linux systems agent and desktop companion.

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.

Ubuntu Quick Start
$git clone https://github.com/ZYNIQ-SOLUTIONS/Tchiko-Assistant-Sysadmin-companion.git $cd Tchiko-Assistant-Sysadmin-companion && ./run_tchiko.sh
Skin 901 · Metal
Roundness 50
Tchiko BoopFace Avatar Drag head · Hold center to squeeze · Pull spring antenna
Ready. Interact with the avatar above or test a command preset below.
Local Dispatch <15 ms
Execution Pipeline 5 Tiers
Permission Model 6 RBAC Domains
Avatar Materials 188 SVG Skins
01

5-Tier Execution Pipeline

Deterministic local tools resolve first; complex tasks stream through Antigravity or ReAct

tier-01-slash-router.log Ubuntu 25.10
02

Core Subsystems & Safety Governance

Built-in protection, undoable file transactions, and modular domain skills

01 · Policy

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.

classify_command() command_denylist
02 · Ledger

Snapshot & Rollback Ledger

Every file patch and write records SHA-256 hashes and a pre-edit snapshot under config/snapshots/, enabling instant rollback via /undo or /rollback.

/undo action_ledger.json
03 · Crash Doctor

6-Stage Application Crash Doctor

Resolves binaries and desktop launchers, checks SingletonLock and Crashpad dumps, scans session logs, verifies X.509 certificates via OpenSSL, and patches bundles safely.

diagnose_and_heal_app openssl x509
04 · Skills

Pluggable Markdown Runbooks

Drop YAML-frontmatter runbooks (Nginx TLS, PostgreSQL, GPU/CUDA, Git Recovery) into skills/*.md. Matching procedures are automatically injected into the agent prompt.

/skills skills/*.md
05 · Infrastructure

Containers, Systemd & Network

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.

/containers /systemd /net
06 · Desktop UX

Proactive Watchdog & Drag-and-Drop

Background daemon monitors RAM/Disk thresholds and failed systemd units with cooldown deduplication. Drop log files or folders onto the avatar for immediate analysis.

SystemWatchdog GTK3 Drag & Drop
03

BoopFace SVG Material & Expression Gallery

Click any live SVG specimen to equip its skin and state in the top workbench

Metal#901 · idle
Glaze#102 · waiting
Ice Glass#203 · inspect
Gummy#305 · success
Jelly#604 · affirm
Gem#1005 · wary
Shimmer#1302 · surprise
Tech#1703 · failure
04

Desktop Telemetry & 6-Stage Crash Doctor

Direct /proc metrics and automated application repair with snapshot backups

Host Telemetry (/proc/meminfo & statvfs)
CPU Load (24 Cores · 0.42) 18%
Memory (16.1 / 60.9 GB) 26%
NVMe Root (/dev/nvme0n1p2) 33%
Desktop Gestures
Middle-Click: Quick Pill Left-Click: Chat Studio Right-Click: Diagnose Clipboard Drop File/Dir: Auto-Analyze
diagnose_and_heal_app() · 6-Stage Pipeline
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.
05

Ubuntu Installation & Verification

Native PyGObject (GTK3) and PyCairo — zero Electron overhead

Run natively on Ubuntu 22.04, 24.04 & 25.10.

Uses system python3-gi and python3-gi-cairo packages for direct X11/XWayland RGBA compositing, streaming runtime logs to logs/tchiko.log.

Security Policy
# 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