kyrexi
v1.6.4
Published
Kyrexi AI — Your companion in the terminal and your code
Readme
About
Kyrexi is a high-performance, autonomous agentic AI ecosystem designed for developers. It bridges the gap between high-level reasoning and low-level execution, providing a unified platform across CLI and Web. Built with a "Security-First" architecture, Kyrexi empowers users with real-time file system interaction, automated coding, and a stunning "Agentic Pro" visual interface.
✨ What's New in v3.7 Ultra
Kyrexi CLI was upgraded from the original Agentic Pro flow into a more complete developer terminal assistant.
🎨 Visual & UX Updates
- Added multi-theme terminal colors: neon, fire, ocean, candy, and matrix.
- Added richer status boxes, better icons, cleaner prompt labels, and gradient branding.
- Added
/compactmode for cleaner output when working in small terminals. - Added persistent theme saving through
/config set theme <name>.
🧠 Agent Logic Updates
- Stronger mission prompts for standard mode and fixer mode.
- Added safer tool-call parsing for malformed JSON/tool blocks.
- Added local session context tracking and
/context+/reset-contextcontrols. - Added local prompt history logging with
/history. - Added
/toolsto show all available built-in and plugin tools.
🔒 Safety Updates
- Fixed the settings/backups directory initializer.
- Added automatic file backups before destructive file edits where supported.
- Added
/safemode to block high-risk actions like deletes and background commands. - Added dangerous shell command detection for commands such as
rm -rf,format,mkfs,shutdown, and pipe-to-shell patterns. - Added
/trust <n>for controlled pre-authorization instead of permanently enabling full agentic mode. - Tokens shown in
/configare masked for privacy.
🛠️ Developer Workflow Updates
- Added
/doctorto check Node.js version, settings folder, token status, auth verification, and chat API connection. - Added
/scan [path]to quickly inspect project size, file count, and ignored folders. - Added
/backup [file]to create backups manually and list recent backups. - Added
/pwdand/cd <path>for smoother project navigation inside the CLI. - Added saved config support for theme and compact mode.
🧩 Plugin & Tooling Updates
- Keeps support for
kyrexi.tools.jsplugin loading. - Keeps existing tools: file read/write/edit, command execution, background commands, search, URL reading, HTTP requests, image generation, system info, copy/delete/append.
- Adds better display of dangerous tools in
/tools.
CLI Commands
| Command | Action |
|:---|:---|
| /chats / /sessions | List all active agent sessions |
| /delete [id] | Remove the current or a specific chat session |
| /agent / /agentic | Toggle Autonomous Mode on/off |
| /trust <n> | Pre-authorize the next N dangerous tool actions |
| /fix <error> | Auto-fix an error using tools |
| /init / /create | Scaffold a new Kyrexi-powered project |
| /pwd | Show current working directory |
| /cd <path> | Change current working directory |
| /status | Show mode, version, theme, memory usage, and paths |
| /theme [name] | View/change theme: neon, fire, ocean, candy, matrix |
| /safe | Toggle extra protection for dangerous actions |
| /debug | Toggle debug logs |
| /history | Show recent local prompt history |
| /tools | List every built-in and plugin tool available to the agent |
| /doctor | Run auth, server, Node.js, and chat API health checks |
| /compact | Toggle compact terminal output mode |
| /context | Show saved session context summary |
| /reset-context | Clear saved session context summary |
| /config show | Show current CLI config with masked token |
| /config set theme <name> | Save preferred theme permanently |
| /backup [file] | List backups or create a backup for a file |
| /scan [path] | Scan project file count, folder count, size, and ignored folders |
| /clear | Wipe terminal history and reset branding |
| /login | Force secure re-authentication flow |
| /exit / /q | Gracefully terminate the Kyrexi session |
💡 Pro Tip: Use
--agentic/-afor full autonomy,--safefor extra protection,--resumeto continue your last session, andKYREXI_THEME=fire kyrexito start with a theme.
Autonomous Toolbox
Kyrexi v3.7 Ultra comes equipped with a suite of professional-grade tools:
- 📂 File System:
list_dir,read_file,write_file,edit_file,multi_edit_file - 💻 Execution:
run_command,run_background_command,get_command_status - 🔍 Research:
search_files(grep),search_web(DuckDuckGo),read_url - 🎨 Creativity:
generate_image(AI-powered visuals) - 🧠 Reasoning: Built-in visual
<thinking>process for transparency - 🩺 Health:
/doctor,/status,/scan, and/configfor professional diagnostics - 🛡️ Safety: safe mode, dangerous command blocking, manual backups, and pre-authorization controls
🛠️ Autonomous Auto-Fix
Kyrexi v3.7 introduces a dedicated Fixer mode. Instead of just analyzing an error, Kyrexi will autonomously navigate your codebase to resolve it.
The 4-Step Mission Protocol:
- 🔍 Locate: Scans your project directory to find the failing code.
- 🧠 Diagnose: Analyzes the logic and identifies the root cause.
- 🛠️ Fix: Applies precise code modifications using
edit_file. - ✅ Verify: Runs your build/test commands to ensure the fix is successful.
Usage:
kyrexi fix "Your error message here"Or use /fix inside the interactive CLI.
Advanced Intelligence
Powered by the latest Kyrexi Ø Edition, the CLI now supports:
- Vision Intelligence: Analyze images and visual data directly.
- Video Generation: Create stunning AI videos without limits.
- Privacy First: End-to-end encryption with no data selling.
- Mobile Integration: Sync your work with the Kyrexi Android App.
🚀 Kyrexi SDK (Beta)
Integrate Kyrexi's intelligence directly into your own applications! Use the Kyrexi SDK for Autonomous Self-Healing—automatically detecting, diagnosing, and fixing production errors in real-time.
import { Kyrexi } from 'kyrexi';
const kyrexi = new Kyrexi('YOUR_API_KEY');
try {
throw new Error("Critical database failure");
} catch (err) {
const report = await kyrexi.fix(err, { env: 'production' });
console.log("Kyrexi Auto-Fix Report:", report);
}🛠️ Project Scaffolding & Global Self-Healing (kyrexi init)
Kyrexi v1.3.9 introduces Interactive Scaffolding to boost your developer velocity. You can bootstrap a production-ready application pre-configured with Kyrexi's autonomous self-healing engines in seconds!
Scaffolding Wizard
Run the scaffolder via the CLI command:
kyrexi initOr use /init or /create inside the interactive terminal session.
The wizard will guide you through:
- 📂 Project Naming (custom project folder creation)
- 🗂️ Template Selection:
- 🚀 Node.js / Express Server: A ready-to-run Express server setup.
- 📜 Basic Script: A clean template for automation scripts.
- 🤖 Kyrexi Self-Healing Integration: Automates key generation from your active session, writes the
.envfile, and hooks global error interceptors!
Global Error Interceptors
When Self-Healing is enabled, the scaffolder registers full crash-prevention listeners to intercept unhandled exceptions and autonomously invoke healing diagnostics:
import { Kyrexi } from 'kyrexi';
import dotenv from 'dotenv';
dotenv.config();
const kyrexi = new Kyrexi(process.env.KYREXI_API_KEY);
process.on('uncaughtException', async (error) => {
console.error('\n❌ [CRASH DETECTED]:', error.message);
console.log('🤖 Kyrexi Pro is executing autonomous self-healing diagnostics...');
try {
const report = await kyrexi.fix(error, { filePath: import.meta.url });
console.log('🤖 Kyrexi Healing Report:', report);
} catch (e) {
console.error('❌ Kyrexi self-healing invocation failed:', e.message);
}
process.exit(1);
});🖥️ Kyrexi v3.8 Dashboard Update
New updates added by UDMODZ × THENUXOFC:
| Feature | Command | Description |
|:---|:---|:---|
| Live Dashboard | /dashboard or /dash | Shows CLI mode, theme, server status, token mask, chat count, CWD, Git branch, project file stats, code mix, background processes, backups, runtime, memory and CPU meters. |
| Creator Branding | Built-in | Default branding now shows Kyrexi Pro • Creators: UDMODZ × THENUXOFC. |
| Customization Update | /customize | Creator branding examples now include UDMODZ × THENUXOFC. |
| Help Menu Update | /help | Command palette now includes /dashboard. |
Test it
kyrexi --agenticInside the CLI:
/dashboardOr quick alias:
/dash🚀 Installation
# Install globally
npm install -g kyrexi
# Start the agent (Standard)
kyrexi
# Start the agent (Agentic Pro)
kyrexi --agentic
# Start with safe mode
kyrexi --safe
# Resume last session
kyrexi --resume
# Start with a custom theme
KYREXI_THEME=matrix kyrexi
# Auto-fix an error
kyrexi fix "Error: Cannot find module './utils'"