Package Exports
- kyrexi
- kyrexi/kyrexi.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (kyrexi) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
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>. - Added a full AI Personalization & Custom Branding Wizard via
/customizecommand (change AI name, ASCII banner, and creator/branding labels dynamically).
🧠 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 |
/customize |
Personalize AI name, banner, and creator/branding |
/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);
});
🚀 Installation
📦 1. Global Install via NPM
# 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'"