⚡ Vortex v2 — AI-Powered Sysadmin Terminal

Vortex is a beautiful, intelligent, autonomous sysadmin assistant that lives in your terminal. It translates natural language into shell commands, monitors your system, and learns from your history.

✨ Features

• 🤖 Multi-Provider AI: Supports Google Gemini, Anthropic Claude, and AWS Bedrock.
• 🖥️ Full TUI: A professional monochrome Terminal UI built with Textual.
• 🐚 Persistent Shell: Maintains state (cd, export) across commands in a session.
• 🛡️ Risk Awareness: Automatically classifies commands as SAFE, CAUTION, or DANGEROUS.
• 🧠 RAG Memory: Remembers past commands and outcomes using ChromaDB.
• 📈 System Monitoring: Background daemon to alert on high CPU/MEM/Disk usage.
• 🔗 Direct Passthrough: Run raw shell commands with the # prefix.

🚀 Installation

git clone https://github.com/ichigo-k/Vortex
cd vortex
pip install -e .

⚙️ Setup

1. Run the configuration wizard:

   vortex config setup

2. Or set your API keys in .env or ~/.vortex/config.toml.

📖 Usage

Interactive TUI

vortex chat

One-shot Commands

vortex ask "How do I check open ports?"
vortex run "restart my nginx server"

System Monitoring

vortex monitor start
vortex monitor status

Direct Passthrough (in chat)

# df -h

Slash Commands (in chat)

• /clear - Fresh start
• /help - Show all commands

🛠️ Tech Stack

• Textual (TUI)
• Click (CLI)
• Google Gemini / Anthropic / Bedrock (AI)
• ChromaDB (Vector DB)
• SQLite (History)
• psutil (Monitoring)