🌟 What is Luna?

Luna is an advanced, highly-interactive AI agent built in Node.js/React (via Ink) that lives in your terminal. It acts as your personal coding assistant, system administrator, and digital friend.

Instead of just answering questions, Luna has the power to interact with your local environment. You can ask her to create files, build projects, run bash commands, push to GitHub, or manage your system securely!

🚀 Features

• 🧠 Advanced AI Brain: Powered by Groq/LLaMA 3.3 for lightning-fast, highly accurate responses.
• 💻 True Autonomy: Luna can execute terminal commands, install packages, and manage files automatically.
• 🔐 Secure Firebase Auth: Completely integrated with Firebase Authentication (Email/Password & Google OAuth).
• ⌨️ Interactive TUI: Built using React & Ink. Features arrow-key command autocompletion and a beautiful, color-coded chat interface.
• 🛡️ Cross-Platform: Automatically detects and operates seamlessly across Windows, Linux, and macOS!

🛠️ Installation

Because Luna is built with Node.js, she runs anywhere. We offer a few different ways to install her:

Option 1: NPM (Global Cross-Platform Install)

The easiest way to install Luna on Windows, macOS, or Linux is through NPM. You must have Node.js installed.

npm install -g @arunachalamarc017/luna-cli

Option 2: Arch Linux (AUR)

If you are using Arch Linux, Manjaro, or EndeavourOS, you can install Luna natively using your favorite AUR helper!

yay -S luna-cli

Option 3: Manual Clone & Build

git clone https://github.com/Arunachalam-gojosaturo/Luna-cli.git
cd Luna-cli
npm install
npm run build
npm start

📂 Folder Structure

Here is how the Luna-CLI project is organized:

Luna-cli/
├── src/
│   └── index.tsx          # The entire core logic! Contains the React TUI, AI prompts, and Auth flows.
├── dist/                  # The compiled, production-ready JavaScript code (generated by `npm run build`).
├── package.json           # Defines dependencies (Ink, Firebase, Groq, Express) and scripts.
├── tsconfig.json          # TypeScript compiler configuration.
├── ASCII.txt              # The beautiful ASCII art logo displayed on startup.
├── luna-cli.jpg           # The beautiful banner image used in this README.
└── README.md              # You are reading this right now!

🎮 How to use Luna

Once installed, just open your terminal and type:

luna-cli

Once inside the interface, just talk to her like a normal person! Or use the interactive commands by typing /:

• /help - Show all available commands.
• /login - Authenticate via Firebase Email or Google OAuth.
• /api - Configure your Groq, OpenAI, or Gemini API keys.
• /github - Generate SSH keys and configure Git integration.
• /config - Toggle Luna's ability to auto-run system commands without asking for permission.
• /clear - Clear the chat history.
• /exit - Instantly close the CLI.