Overview

RAYS-CORE is an open-source AI coding assistant for local repositories. It indexes your codebase, retrieves relevant symbols and files, plans changes, applies edits with permission controls, and maintains persistent project memory.

Why RAYS

• Works on real codebases with structural, symbol-level indexing.
• Supports read-only chat, targeted editing, and new-project generation in one CLI.
• Provider-flexible: local-first with Ollama, plus Gemini API.
• Tracks context over time via .rays memory.

Install

The recommended way to install is via pipx:

pipx install rays-core

Or with pip:

pip install rays-core

Quick start

rays /path/to/your/codebase

See Quickstart for a full first-run walkthrough, or jump to Architecture to understand the pipeline.