🖥️ Nexus IDE - Terminal Edition

Code in Your Terminal. AI at Your Fingertips.

⚡ Quick Start

From NPM (Recommended)

# Run instantly - no install needed
npx nexus-ide@cli

# Or install globally
npm install -g nexus-ide@cli
nexus

From GitHub

npx github:TheStrongestOfTomorrow/Nexus-IDE#cli

🚀 How to Use

⚠️ IMPORTANT: Do NOT use npm run dev

The TUI is designed to run directly. Using npm run dev starts the web server, NOT the terminal interface!

✅ Correct Usage

# After cloning the repo
git clone -b cli https://github.com/TheStrongestOfTomorrow/Nexus-IDE.git
cd Nexus-IDE
npm install

# Run TUI (Terminal User Interface)
npm run tui
# OR
node cli/nexus.js
# OR
npx nexus

📋 Available Commands

| Command | Description | |---------|-------------| | npx nexus-ide@cli | Run TUI from npm | | npm run tui | Run TUI (after clone) | | node cli/nexus.js | Run TUI directly | | nexus | Run TUI (if installed globally) |

🌟 Features

🎯 Full Terminal IDE

| Feature | Description | |---------|-------------| | 📁 File Explorer | Navigate directories with keyboard | | ✏️ Code Editor | Edit files directly in terminal | | 🤖 AI Assistant | Chat with 12+ AI providers | | 💻 Built-in Terminal | Run commands without leaving | | 🔧 Git Integration | View status, branch info |

🤖 AI Providers

| Provider | Models | Type | |----------|--------|------| | OpenAI | GPT-4o, O1, O3 Mini | Cloud | | Anthropic | Claude Opus 4, Sonnet 4 | Cloud | | Google | Gemini 2.5 Pro, Flash | Cloud | | xAI | Grok 3, Grok 3 Fast | Cloud | | Mistral | Mistral Large, Codestral | Cloud | | DeepSeek | Coder, R1 | Cloud | | Groq | Llama 3.3 70B | Cloud (Free) | | Ollama | Llama, Mistral | Local |

⌨️ Keyboard Shortcuts

Navigation

| Key | Action | |:---:|--------| | ↑ ↓ | Navigate items | | Enter | Select / Open | | Tab | Switch panels | | Q / Esc | Back / Quit |

File Operations

| Key | Action | |:---:|--------| | E | Edit file | | D | Delete file | | N | New file | | H | Go up directory |

AI Chat

| Key | Action | |:---:|--------| | C | Start chat | | H | AI help |

📋 CLI Commands

nexus                    # Launch TUI (default)
nexus tui                # Same as above
nexus start              # Start web server (not TUI!)
nexus ai "prompt"        # Quick AI question
nexus run file.js        # Execute code
nexus ls                 # List files
nexus config             # View settings

🌿 All NPM Versions

| Version | Install Command | Description | |---------|-----------------|-------------| | Stable | npx nexus-ide or npx nexus-ide@latest | ✅ Production ready | | Beta | npx nexus-ide@beta | 🧪 Latest features | | CLI/TUI | npx nexus-ide@cli | 🖥️ Terminal only | | Professional | npx nexus-ide@pro | 💼 CLI + Web |

🎯 Use Cases

• 🖥️ SSH Development - Full IDE over SSH
• ☁️ Server Admin - Edit configs remotely
• 📱 Low Resources - Lightweight interface
• ⌨️ Keyboard Lovers - No mouse needed
• 🐧 Linux/WSL - Native terminal experience

🔧 Configuration

Set AI Provider

# In TUI, go to Settings (option 6)
# Or use environment variables:
export NEXUS_AI_PROVIDER=openai
export NEXUS_AI_KEY=sk-...
export NEXUS_AI_MODEL=gpt-4o

Config File Location

~/.nexus-ide/config.json

🔗 Quick Links

| Resource | Link | |----------|------| | NPM | https://www.npmjs.com/package/nexus-ide | | GitHub | https://github.com/TheStrongestOfTomorrow/Nexus-IDE | | Issues | https://github.com/TheStrongestOfTomorrow/Nexus-IDE/issues | | Stable | npx nexus-ide@latest | | Beta | npx nexus-ide@beta | | Professional | npx nexus-ide@pro |

Made with ❤️ by Taz

Terminal. Simplified.