v0.5 Local Model Intelligence · MIT Licensed
XR — Cybernetic Guardian

The AI Agent You
Can Actually Trust

Local model auto-detection · BYOK cloud fallback · Hard spend ceiling
Ollama local mode · Hybrid routing · Tamper-evident audit

Local-first + BYOK — use no key, or bring your own.

$0
To Run (Local + Free Cloud)
0
AI Providers
0
Tests Passing
0
OS Supported
Scroll to explore

Why XR wins

Built for trust. Features the competition doesn't even attempt.

FeatureXRClaude CodeOpenClawHermes
One-command install
Full TUI (slash commands, history)partial
JARVIS computer control (screenshots)
System control (volume, clipboard, apps)partialpartial
Hard spend ceiling (code-enforced)
Tamper-evident audit log (SHA-256 chain)
Injection benchmark (runnable block-rate)
Egress allow-list (anti-exfil)partial
Non-regressive skills (auto-rollback)
Self-improving (learns from experience)
Docker sandbox for shell commandspartial
Voice control (wake word → STT → TTS)
Research mode (source-first, citation-aware)partial
BYOK + $0 to runpartial
Cross-platform (Win/Mac/Linux/Termux)

What makes XR different

Local-first + BYOK

No key required for local mode.

XR runs on your local Ollama model or your provider API key. v0.5 detects RAM/VRAM/CPU/disk, recommends a model, downloads it with approval, and keeps cloud fallback deterministic.

$0 to trust

JARVIS-Level Control

It sees your screen.

XR takes screenshots, reasons about what's on screen, and takes actions — click, type, scroll, open apps — just like you would. The difference between asking and showing.

Computer vision + action

Cost Governor

Enforced in code.

The agent literally cannot exceed your budget. checkBeforeStep() runs before every model call and blocks if the next step would breach the ceiling. Not a suggestion.

Code-enforced ceiling

Tamper-Evident Audit

SHA-256 hash chain.

Every action logged with SHA-256 hash chain. Verify integrity with xr verify-log. Any tampering is detected and reported. Redacts API keys before storage.

Git's trick, $0, offline

Everything you need.
Nothing you don't.

Built for developers and power users who want real control over their AI agent.

Shell & Docker Sandbox

Every shell command runs in isolated Docker containers. Zero risk of accidental system damage.

Persistent Memory

Layered memory across sessions — user profiles, agent context, and skill files all stored locally.

Voice Control

Wake word → speech-to-text → model → text-to-speech. Works on macOS (say command) and Windows (SAPI).

Research Mode (v0.7)

Source-first, citation-aware research. XR plans, searches, ranks sources by trust, fetches pages, extracts cited evidence, flags contradictions, and exports a signed report. Never fakes a source or fakes certainty.

Multi-Provider Support

Ollama, Claude, GPT, Gemini, Mistral, DeepSeek, Cerebras, OpenRouter, Groq, Together, Cohere, and Bedrock — swap anytime.

Computer Vision

Screenshots + vision-capable models = XR sees what's on your screen and acts accordingly.

Self-Improving Skills

Successful tasks are frozen as immutable skill baselines. Auto-rollback if a skill regresses.

Injection Defense

10-attack corpus benchmark. SHA-256 signed block-rate report. Real numbers, not marketing.

Egress Allow-List

Anti-exfiltration controls. Only configured domains can receive data from XR.

Cross-Platform

Linux, macOS, Windows, Android (Termux). One install script. Works everywhere.

Interactive TUI

Full terminal UI with slash commands, history, and context. Claude Code-style experience.

Telegram Bot

Control XR from your phone via Telegram. Same agent, same memory, any device.

Auto-Rollback

Skills that break are automatically rolled back to the last known good version.

Use any model

Ollama local models plus supported BYOK cloud providers. Swap anytime with one command.

Plus: provider base URL overrides for OpenAI-compatible services and any valid Ollama model ID.

Install in 30 seconds

One command. Any OS. No credit card. No vendor lock-in.

Linux Terminal
# One command. Any OS. That's it.
$curl -fsSL https://raw.githubusercontent.com/ahmadrrrtx/xr/main/install.sh | bash

# First run: choose Local-only or Hybrid
$xr onboarding
$xr models recommend
$xr "hello, who are you"

# Interactive TUI (Claude Code-style)
$xr --tui

# JARVIS GUI automation
$xr --computer "open browser and search for AI agents"

# Safe computer control (v0.8) — deterministic, opt-in, audited
$xr control start
$xr control open "https://github.com/ahmadrrrtx/xr"
$xr control test # dry-runs a plan — executes nothing

# Hard budget ceiling — literally cannot exceed
$xr --budget 0.25 "build a full REST API"
# Optional: Free Local AI
# Optional: Free local AI with Ollama
$curl -fsSL https://ollama.ai/install.sh | bash
$xr models install
$xr models test

Works on Ubuntu, Debian, Fedora, Arch, and more.

Trust is built in

Not bolted on. Every security feature is code-enforced, not suggested.

Tamper-Evident Audit Log

SHA-256 hash chain

Every action XR takes is logged with a SHA-256 hash chain. Verify integrity with a single command. Any tampering is detected instantly.

H(0)
H(1)
H(2)
H(3)
H(n)
xr verify-log → "✓ Audit chain intact (N entries)"

Cost Governor

Hard ceiling

Code-enforced spend limits. The agent literally cannot make a call that exceeds your budget.

Spent$0.12 / $0.25
xr --budget 0.25 "task"

Injection Defense

10-attack benchmark with SHA-256 signed block-rate reports.

Egress Allow-List

Only configured domains can receive data from XR.

Local-First Data

All data stored locally. Nothing leaves your infrastructure.

API Key Redaction

Keys are redacted before storage in the audit log.

1
GitHub Star
58+
Commits
124
Tests Passing
MIT
License

Finally an agent that actually respects your budget. The cost governor alone is worth switching.

Developer on X@dev_handle

The JARVIS computer control changed everything. It actually sees what I see and acts on it.

Power User@power_user

Tamper-evident audit log is the feature that sold me. I can verify every action XR took.

Security Engineer@sec_eng

Frequently asked questions

BYOK stands for 'Bring Your Own Key.' XR runs on your API key from any supported provider (Anthropic, OpenAI, Google, etc.) or your own local model via Ollama. We don't have access to your key or your data. It costs us $0 to maintain and you $0 to trust.

XR

Ready to take control?

One command. Any OS. $0 to run. $0 to trust.