npm package: @prizma-leon/prizma-companion
Description: An AI-powered CLI companion for exploring and understanding your codebase.
Author: Prizma AI Team
Latest version: 1.8.3

# ✧ Prizma Companion ✧

[![Version](https://img.shields.io/badge/version-1.8.0-blueviolet?style=for-the-badge)](https://www.npmjs.com/package/prizma-companion)
[![License: MIT](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Node](https://img.shields.io/badge/Node.js-%3E%3D%2018-green?style=for-the-badge)](https://nodejs.org/)

> **The ultimate AI-powered companion for your terminal.** Seamlessly explore, analyze, and understand your codebase with a stunning cyberpunk-inspired interface.

---

## 💎 Overview

**Prizma Companion** is not just another CLI tool; it's a high-performance resonance chamber for your projects. Designed for developers who live in the terminal, Prizma provides a deep, context-aware bridge between you and the world's most powerful AI models.

Inspired by the aesthetics of **Manus AI** and **Kortex**, Prizma brings a premium experience to the command line—complete with shimmering crystal animations, typewriter effects, and a robust logic engine.

## 🚀 Key Features

- **✧ Shimmering Crystal UI:** A bespoke, animated interface that makes every session feel like a journey into the matrix.
- **⚡ Multi-Engine Resonance:** Native support for:
  - **OpenRouter** (The portal to all models)
  - **OpenAI** (GPT-4o, GPT-o1, etc.)
  - **Google Gemini** (Ultra-fast reasoning)
  - **Anthropic Claude** (Superior coding intelligence)
- **📂 Smart Context Indexing:** Automatically scans your project, understands your folder structure, and selectively reads files for precise answers.
- **🛡️ Secure-First:** Your API keys are stored locally using `conf` and are NEVER sent to any third-party servers.
- **🧩 ReAct Logic Flow:** Uses a "Think-Read-Act" loop to provide deep insights without drowning the AI in irrelevant noise.

## 🛠️ Installation

Elevate your terminal experience globally:

```bash
npm install -g prizma-companion
```

*Or run it directly via npx:*

```bash
npx prizma-companion
```

## 🎮 How to Use

Simply type the resonance command:

```bash
prizma
```

### The Workflow

1. **Initiate:** Choose your preferred AI Provider
2. **Authorize:** Provide your API Key (safely stored for future sessions)
3. **Calibrate:** Select the model that fits your current task
4. **Locate:** Use the built-in folder browser to select your project directory
5. **Communicate:** Start chatting with Prizma about your code

## 🏗️ Tech Stack

- **Runtime:** Node.js
- **Language:** TypeScript
- **Display:** `chalk`, `gradient-string`, `boxen`, `figlet`
- **Logic:** `commander`, `ora`, `inquirer`, `glob`
- **AI SDKs:** OpenAI, Google Generative AI, Anthropic SDK

## 📦 Publishing to npm

If you are the maintainer and want to push a new version to the matrix:

1. **Build the resonance:**
   ```bash
   npm run build
   ```
2. **Authenticate with the collective:**
   ```bash
   npm login
   ```
3. **Initialize upload:**
   ```bash
   npm publish --access public
   ```

## 📜 License

This project is licensed under the **MIT License**.

---

> "The future of coding isn't just writing lines—it's resonance."