🧠 Sage-assistant - Your Intelligent AI CLI Assistant

Sage is a powerful command-line AI assistant built with Node.js and powered by Mistral AI. It lets you interact with your system using natural language, read files, fetch system data, and run safe commands in a seamless, intelligent experience — right from your terminal.

⚡ Imagine talking to your terminal and it responds like ChatGPT, but with access to your actual system. That’s Sage-assistant.

While tools like OpenAI Codex (powered by GPT-4) are reshaping how developers interact with code, Sage offers a lightweight, open-source alternative with several distinct advantages:

🆓 Completely free to use — powered by the open Mistral API (No paid subscription needed — the free tier works just fine for Sage.)

💻 Local-first design — no code is sent to centralized servers unless explicitly configured

🔐 Transparent and safe — ideal for those who value control and privacy

🚀 Features

• 🧠 Conversational AI assistant using Mistral API
• 🗃️ Reads system and user files on command
• 💻 Executes selected safe terminal commands
• 🛡️ secure command handling
• 🎛️ Tool calling with context-aware file access
• 🧵 Streamed responses for smooth interaction
• ⌨️ Clean, multi-line CLI input
• 👨‍💻 Can serve as a coding assistant to help you debug, understand, and write code

📦 Installation

Install via npm:

npm install -g sage-assistant

Then simply run:

sage

🛠️ Usage

Once installed run the AI assisstant:

sage

• You'll asked to enter an API key from mistral

Then after entering entering the API key You'll see instructions such as:

• Type "end" on a new line to submit your multi-line prompt

• Type "exit" or press Ctrl+C / Ctrl+D to quit

• Type any key to cancel the response mid-stream

Example Prompts 📝 "What’s inside app.py?"

⚙️ "Have the changes in file index.js been committed yet"

📂 "Read the contents of myScript.sh"

🔐 "Do I have SSH keys set up?"

🔍 How It Works Sage uses:

• The Mistral AI streaming API for intelligent interactions

• A secure tool interface for file access and safe command execution

• Local processing — no server, no telemetry

• A smart prompt system that guides AI behavior