MCPcopy Index your code
hub / github.com/RightNow-AI/rightnow-cli

github.com/RightNow-AI/rightnow-cli @v1.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.0 ↗ · + Follow
1,049 symbols 3,394 edges 87 files 933 documented · 89%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

RightNow CLI - GPU-Native AI Code Editor

    ██████╗ ██╗ ██████╗ ██╗  ██╗████████╗███╗   ██╗ ██████╗ ██╗    ██╗
    ██╔══██╗██║██╔════╝ ██║  ██║╚══██╔══╝████╗  ██║██╔═══██╗██║    ██║
    ██████╔╝██║██║  ███╗███████║   ██║   ██╔██╗ ██║██║   ██║██║ █╗ ██║
    ██╔══██╗██║██║   ██║██╔══██║   ██║   ██║╚██╗██║██║   ██║██║███╗██║
    ██║  ██║██║╚██████╔╝██║  ██║   ██║   ██║ ╚████║╚██████╔╝╚███╔███╔╝
    ╚═╝  ╚═╝╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═══╝ ╚═════╝  ╚══╝╚══╝

                    CUDA AI Assistant • Open Source

rightnowai.co@rightnowai_coDiscord

Version Python License

Open Source CLI Tool - Want a full-featured CUDA development environment with code completion, integrated debugging, and advanced AI features? Try RightNow Code Editor - Our complete IDE for GPU development.

RightNow CLI is an AI-powered CUDA development assistant that helps you write, optimize, and debug GPU code. Start FREE with no credit card required!

RightNow CLI Demo


Quick Install (30 seconds)

Option 1: pip (Recommended)

pip install rightnow-cli

Option 2: Quick Install Scripts

Linux/macOS:

curl -sSL https://raw.githubusercontent.com/RightNow-AI/rightnow-cli/main/install.sh | bash

Windows (PowerShell as Admin):

irm https://raw.githubusercontent.com/RightNow-AI/rightnow-cli/main/install.ps1 | iex

Getting Started (2 minutes)

1. Get your FREE API key (30 seconds)

# Visit OpenRouter (no credit card needed!)
https://openrouter.ai

# Sign up with Google/GitHub for instant access
# Copy your API key from the dashboard

2. Start RightNow

rightnow
# Paste your API key when prompted (one-time setup)

3. Start coding!

You: Create a vector addition CUDA kernel

RightNow: [Creates optimized kernel with detailed explanations]

What Can It Do?

For Beginners

  • Learn CUDA: "Explain how CUDA threads work"
  • Write Code: "Create a simple matrix multiplication kernel"
  • Fix Errors: "Help! My kernel crashes with error X"

For Experts

  • Optimize: "Optimize this kernel for memory coalescing"
  • Debug: "Find the race condition in my code"
  • Analyze: "Profile this kernel and suggest improvements"

Key Features

Start FREE

  • No credit card required
  • Free models included (Google Gemini, Meta Llama)
  • Upgrade to premium models when needed

Smart AI Agents

  • General Assistant: Helps with any CUDA task
  • Optimizer: Maximizes performance
  • Debugger: Finds and fixes bugs
  • Analyzer: Explains and improves code

Powerful Tools

  • Read and write CUDA files
  • Analyze performance bottlenecks
  • Generate optimized variants
  • Monitor GPU status
  • Execute bash commands

Example Usage

Basic Commands

# Start interactive mode
rightnow

# Inside RightNow:
/models     # List available AI models
/gpu        # Show GPU status
/clear      # Clear conversation
/help       # Show help
/quit       # Exit

Example Conversations

Creating a Kernel:

You: Create a parallel reduction kernel

RightNow: [Writes complete kernel with shared memory optimization]

Optimizing Code:

You: Optimize my matrix multiplication for RTX 4090

RightNow: [Analyzes and provides optimized version with 10x speedup]

Debugging:

You: My kernel gives wrong results for large arrays

RightNow: [Identifies overflow issue and provides fix]

Available Models

Free Models (No cost!)

  • Google Gemini 2.0 Flash - Fast and capable (default)
  • Meta Llama 3.2 3B - Efficient for simple tasks

Premium Models (Pay-per-use via OpenRouter)

  • GPT-4o - Most capable overall
  • Claude 3.5 Sonnet - Best for complex code
  • Gemini 1.5 Flash - Fast with huge context

Switch models anytime with /models command!

System Requirements

Minimum

  • Python 3.9+
  • Any OS (Windows, Linux, macOS)
  • Internet connection

Recommended (for CUDA features)

  • NVIDIA GPU (GTX 1650 or newer)
  • CUDA Toolkit 11.0+
  • 8GB+ RAM

Troubleshooting

"Command not found"

# Add to PATH (Linux/macOS)
export PATH="$HOME/.local/bin:$PATH"

# Or reinstall
pip uninstall rightnow-cli
pip install rightnow-cli --user

"API key error"

# Get your free key at:
https://openrouter.ai

# Clear old key and re-enter:
rm -rf ~/.rightnow-cli
rightnow  # Will prompt for new key

GPU not detected

# Check NVIDIA driver
nvidia-smi

# Check CUDA
nvcc --version

# RightNow works without GPU (CPU simulation mode)

Documentation

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Proprietary Non-Commercial License - FREE for personal and educational use. See LICENSE for details.

For commercial use, contact: licensing@rightnowai.co

Support


Built with <3 by the RightNow AI Team

First GPU Native AI Code Editor

Core symbols most depended-on inside this repo

get
called by 272
rightnow_cli/tools/registry.py
exists
called by 73
rightnow_cli/sessions/storage.py
flush
called by 28
rightnow_cli/openrouter_v2.py
run
called by 24
rightnow_cli/ui/tool_display.py
execute
called by 21
rightnow_cli/tools/base.py
search
called by 20
rightnow_cli/sessions/storage.py
ask
called by 19
rightnow_cli/permissions/checker.py
show_warning
called by 19
rightnow_cli/ui/theme.py

Shape

Method 750
Class 152
Function 147

Languages

Python100%

Modules by API surface

rightnow_cli/exceptions.py54 symbols
tests/test_cache.py45 symbols
tests/test_bench.py40 symbols
tests/test_openrouter.py37 symbols
tests/test_cli.py37 symbols
rightnow_cli/backends/base.py32 symbols
rightnow_cli/plugins/manager.py31 symbols
rightnow_cli/utils/detection.py30 symbols
rightnow_cli/backends/cuda_backend.py27 symbols
rightnow_cli/ui/tool_display.py25 symbols
rightnow_cli/chat_agent.py25 symbols
rightnow_cli/agents/base_agent.py23 symbols

For agents

$ claude mcp add rightnow-cli \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page