APPROVED

EYES ONLY

← Return to Main Terminal DEEPDISH // PROJECT INDEX

RadGotchi

Your RadTech Desktop Intelligence Companion

💬 Chat with Local AI

📈 Level Up & Earn XP

🖥️ System Health Monitor

🎮 25+ Mood Animations

🪟 Windows

🍎 macOS

🐧 Linux

📦 Open Source

SIGINT NOMINAL

⚡ Quick Install

Linux / macOS

Windows

curl -fsSL https://tylerirl.com/install_rg.sh | bash

View on GitHub

What is RadGotchi?

A desktop companion app that floats on your screen, chats with local AI (Ollama, LM Studio), monitors your system health, and rewards you with a full progression system — 50 levels, 13 clearance ranks, and achievement milestones. It's a virtual pet that actually does something useful.

Core Capabilities

💬

SIGINT Terminal

Chat with local LLMs — Ollama, LM Studio, LocalAI. Streaming responses, markdown rendering.

🎖️

Progression Engine

50 levels, 13 ranks from TRAINEE to PHANTOM. XP from interactions, messages, focus sessions.

📊

System Telemetry

CPU, memory, network monitoring. Visual alerts for high usage. Hung process detection.

🎮

Movement Protocols

STATIC, BOUNCE, FOLLOW, or WANDER. Your companion moves how you want.

⏱️

Focus Operations

Built-in Pomodoro. 25min work, 5min break. +25 XP per completed session.

🔊

Audio Subsystem

14 procedural sounds via Web Audio API. No external files. Toggle mute anytime.

🏅

Clearance Ranks

13 ranks from TRAINEE → PHANTOM. Unlock milestones at key levels.

🏹

Asset Maintenance

Feed via terminal. Energy via sleep mode. Stats panel tracks all vitals.

🧠

Behavioral Intelligence

25+ mood states with smooth transitions. Contextual status in EN/中文.

◆ RADGOTCHI v2.0 LIVE ◆ SIGINT TERMINAL ACTIVE ◆ LOCAL LLM INTEGRATION: OLLAMA/LM STUDIO/LOCALAI ◆ 13 CLEARANCE RANKS: TRAINEE→PHANTOM ◆ 50+ LEVEL PROGRESSION ◆ 4 MOVEMENT PROTOCOLS: STATIC/BOUNCE/FOLLOW/WANDER ◆ 14 PROCEDURAL SOUND EFFECTS ◆ POMODORO FOCUS OPS: +25XP ◆ ASSET MAINTENANCE SYSTEM ◆ LOCALIZATION: EN/中文 ◆ CROSS-PLATFORM: WIN/MAC/LINUX ◆ 25+ MOOD STATES ◆ FULL XP PERSISTENCE ◆ GITHUB REPO OPEN SOURCE ◆

SI // NOFORN

FIELD MANUAL // RADGOTCHI

Project Details

◆ sigint terminal demo ◆

Document ID RG-2026-0308

Clearance TSSI-GAMMA

Status ● ACTIVE

Last Update 2026.03.08 // 09:47 UTC

25+

Moods

Ranks

Levels

Sounds

Move Modes

▲

LIVE

PROJECT:RADGOTCHI v2.0

CLASS:TOP SECRET//SI

SIGINT:LLM TERMINAL

PLATFORM:Electron + Node.js

LOCALE:EN / 中文

AUTHOR:TylerIRL + Contributors

RadGotchi — Desktop Intelligence Asset

Cross-platform companion // Local LLM chat // Progression system // Reacts to your system // Keeps you company

Technical Deep Dive

§1.0 Project Overview

RadGotchi is a cross-platform Electron desktop application — a persistent intelligence asset that floats on your screen, interfaces with local AI via SIGINT Terminal, tracks your cursor, monitors system health, and rewards operational engagement through a full progression system with 50 levels and 13 clearance ranks.

📦 Open Source — MIT License

github.com/itsTylerIRL/radgotchi — Clone, build, customize. Contributions welcome.

§2.0 Platform & Requirements

Component	Specification	Status
Framework	Electron (Chromium + Node.js)	NOMINAL
Node.js	v18+ required	NOMINAL
Windows	10/11 (NSIS installer + portable)	SUPPORTED
macOS	10.15+ Catalina (DMG + ZIP)	SUPPORTED
Linux	Ubuntu/Debian (AppImage + DEB)	SUPPORTED
SIGINT Terminal	Local LLM Chat (Ollama/LM Studio)	ACTIVE
Progression	50 Levels, 13 Ranks, XP System	TRACKING
Audio	14 Procedural Sounds (Web Audio API)	LOADED
Localization	English + 中文 (Chinese)	READY
License	MIT (Open Source)	FREE

Built with Electron for cross-platform desktop deployment. Custom faces by RiverGod. Contributors: TylerIRL, 0x19e02, Claude, Yuriko.

§3.0 Core Features

💬 SIGINT Terminal

Local LLM integration — Ollama, LM Studio, LocalAI. Streaming decode. Session persistence. Markdown rendering. CRT aesthetic terminal interface.

🎮 Movement Protocols

4 modes: STATIC (fixed), BOUNCE (edge patrol), FOLLOW (cursor tracking), WANDER (autonomous exploration). Switch via tray menu.

📈 Progression Engine

50 levels, 13 ranks from TRAINEE to PHANTOM. XP from interactions, messages, focus sessions. Milestone achievements. All progress persists.

🔊 Audio Subsystem

14 procedural sounds via Web Audio API. Level ups, clicks, chat events, pomodoro alerts. Volume control. Toggle mute via UI.

🎙️ 25+ Mood States

Hand-crafted pixel art with smooth transitions. Contextual status messages in EN/中文. Adapts to system events and user engagement.

📊 System Telemetry

CPU monitoring (80%/95% thresholds), memory pressure (85%), network status, hung process detection, idle detection (2min sleep).

🏹 Asset Maintenance

Sustenance system — Feed via terminal. Energy via sleep mode. XP penalties for neglect. Stats panel tracks all vitals.

⏱️ Focus Operations

Pomodoro timer — 25min work, 5min break. Audio alerts. +25 XP per completed session. Stay productive, level up.

Technical Specifications

📋 Event Response Matrix + Movement Protocols [ click to expand ]

§3.1 Event Response Matrix

Trigger	Asset Response	State
CPU > 80%	Alert state, elevated alertness	WARNING
CPU > 95%	Critical alert, shaking animation	CRITICAL
Memory > 85%	Pressure warning indicator	WARNING
Network Lost	Connection lost indicator	ALERT
Network Up	Connectivity restored	OK
Process Hung	Process fault detected	ALERT
User Idle 2min	Sleep mode engaged	SLEEP
User Returns	Wake event, excited animation	AWAKE

§3.2 Movement Protocols

Mode	Behavior	Use Case
STATIC	Fixed position, manual repositioning only	Work focus
BOUNCE	Perimeter patrol, edge reflection	Screensaver
FOLLOW	Cursor tracking, maintains visual contact	Companion
WANDER	Autonomous exploration with rest intervals	Ambient

§4.0 Installation & Quick Start

Clone the repo, install dependencies, run. That's it. No config needed — works out of the box on all platforms.

●

Node.js 18+

●

npm install

●

npm start

3 STEPS

Total

§4.1 Quick Start Commands

# Clone the repository
git clone https://github.com/itsTylerIRL/radgotchi.git
cd radgotchi

# Install dependencies
npm install

# Run the app
npm start

# GPU issues? (VM/remote session)
npm run start:safe
                

§4.2 Project Structure

File	Purpose	Type
main.js	Electron main process — state management, IPC, tray	Main
preload.js	Secure IPC bridge for main window	Bridge
preload-chat.js	Secure IPC bridge for terminal window	Bridge
renderer.js	UI logic — drag, resize, interactions	Renderer
radgotchi.js	Pet behavior module — mood engine, reactions	Module
sounds.js	Audio synthesis — 14 procedural sounds	Audio
index.html	Primary interface — main pet window	UI
chat.html	SIGINT Terminal — LLM chat interface	UI
styles.css	Animations, themes, glow effects	Styles
assets/	25+ sprite images (gotchi/ folder)	Assets

§4.3 Sprite Roster — 25 Mood Expressions

Each sprite is hand-crafted pixel art. Full face atlas (sample shown):

HAPPY

COOL

EXCITED

GRATEFUL

INTENSE

LONELY

LOOK_L

LOOK_L_HAPPY

LOOK_R

LOOK_R_HAPPY

SAD

SLEEP

SLEEP2

SMART

UPLOAD

§4.4 Controls & XP Rewards

Action	Effect	XP Reward
Drag	Reposition asset on screen	—
Scroll Wheel	Scale adjustment (resize)	—
Click	Interaction event (3s cooldown)	+2 XP
Passive	Every 30 seconds of uptime	+1 XP
Send Message	Chat transmission to LLM	+5 XP
Receive Message	LLM response received	+3 XP
Focus Complete	Pomodoro session done (25min)	+25 XP
Alert Response	Attention event triggered	+15 XP
Right-click Tray	Access Command Center menu	—

§4.5 Command Center (Tray Menu)

Option	Function
Always on Top	Window priority toggle
Reset Position	Return to origin coordinates
Movement	Protocol selection (STATIC/BOUNCE/FOLLOW/WANDER)
Color	Visual theme configuration (10 themes)
Language	Localization toggle (EN/中文)
Chat Settings	LLM endpoint configuration
Dev Tools	Debug interface
Update	Pull latest from repository
Quit	Terminate session

§5.0 Building Distributables

Requires Node.js 18+ and npm. Build outputs go to dist/ folder.

§5.1 Build Commands

# Build for current platform
npm run build

# Platform-specific builds
npm run build:win      # Windows (NSIS installer + portable)
npm run build:mac      # macOS (DMG + ZIP)
npm run build:linux    # Linux (AppImage + DEB)

# Windows portable only
npm run build:portable
                

§5.2 Build Outputs

Platform	Installer	Portable/Archive
Windows	Radgotchi Setup x.x.x.exe	Radgotchi x.x.x.exe
macOS	Radgotchi-x.x.x.dmg	Radgotchi-x.x.x-mac.zip
Linux	radgotchi_x.x.x_amd64.deb	Radgotchi-x.x.x.AppImage

§5.3 SIGINT Terminal (LLM Chat)

Integrated communication interface with local language model support. All traffic stays local unless you configure external endpoints.

📶 Compatible Endpoints

Ollama	localhost:11434/v1/chat/completions
LM Studio	localhost:1234/v1/chat/completions
LocalAI	Custom configuration
OpenAI	Any conformant endpoint

💻 Terminal Features

CRT scanlines, grid overlay, retro aesthetic
Real-time streaming token decode
Session history persistence
Activity log (XP, milestones, system)
Markdown with code block copy
Movement, theme, language controls
Stats panel, focus timer, MUTE toggle

Configuration: Command Center → Chat Settings → Enable, set endpoint URL, model ID (llama2, mistral, etc.), optional system prompt.

§6.0 Clearance Progression

Operational engagement generates XP. Sustained activity advances clearance level through 50 levels and 13 ranks.

🎖️ Clearance Ranks (13 Tiers)

TRAINEE	Lv 1	CONTROLLER	Lv 17
ANALYST	Lv 3	DIRECTOR	Lv 20
OPERATIVE	Lv 5	EXECUTIVE	Lv 24
AGENT	Lv 8	OVERSEER	Lv 28
SPECIALIST	Lv 11	SENTINEL	Lv 33
HANDLER	Lv 14	ARCHITECT	Lv 40
		PHANTOM	Lv 50

🏆 Milestone Objectives

Interactions	10→50→100→500→1K→5K
Transmissions	5→25→50→100→250→500
Sessions	5→10→25→50→100
Total XP	100→500→1K→5K→10K→50K
Uptime	1h→4h→12h→24h→48h→72h

Persistence: All XP, levels, milestones, and chat history stored in user data directory (JSON). Survives updates.

§7.0 Programmatic API

§7.1 RG Module

The global RG object for asset manipulation:

// Set mood with options
RG.setMood('happy', { duration: 3000, anim: 'bounce', status: 'Custom!' });

// React to severity levels
RG.react('critical', 'Alert!');
RG.react('warning', 'Heads up');
RG.react('ok', 'All good');

// Feed system metrics
RG.assessHealth({ cpu: { usage_total: 45 }, memory: { percent: 60 } });

// Read state
console.log(RG.mood, RG.petCount);
                

§7.2 SoundSystem API

Procedural audio control via Web Audio API:

// Playback
SoundSystem.play('levelUp');
SoundSystem.play('click');
SoundSystem.play('messageReceive');

// Available: chatOpen, chatClose, messageSend, messageReceive, click,
// sleepStart, sleepEnd, attentionStart, attentionEnd, levelUp,
// milestone, pomodoroStart, pomodoroComplete, xpGain, xpLoss

// Enable/disable & volume
SoundSystem.setEnabled(true);
SoundSystem.setVolume(0.5);  // 0.0 - 1.0
                

§8.0 Customization

§8.1 Visual Themes (10 Presets)

Right-click tray → Color, or use terminal dropdown:

●

Red

●

Cyan

●

Green

●

Purple

●

Pink

●

Orange

●

Yellow

●

Lime

●

Blue

●

White

§8.2 Localization

Switch instantly via tray or terminal. All interface elements localize automatically:

🇺🇸

English (Default)

🇨🇳

中文 (Chinese)

§8.3 Sleepy Mode

Low-power rest state via terminal toggle. Reduces visual activity, prevents energy loss.

§8.4 CSS Variables

For deeper customization, edit styles.css:

:root {
    --rg-color: #ff3344;       /* Main accent */
    --rg-glow: #ff334488;      /* Glow effect */
    --rg-status-color: #cc2233; /* Status text */
}
                

§8.5 Persistent Data

Stored in user data directory (survives updates):

llm-config.json	LLM endpoint configuration
xp-data.json	Progression state, streaks
chat-data.json	Message history
milestones.json	Achievement records

† RadGotchi faces by RiverGod (@giverrod). Desktop app by TylerIRL, 0x19e02, Claude, Yuriko. MIT License — GitHub

‡ Inspired by Radbro Webring and Remilio (Remilia Corporation). Clone, build, customize. Contributions welcome.