Getting started

Quickstart

Point RAYS at any local repository:

rays /path/to/your/codebase

Or from inside a repo:

cd /path/to/your/codebase
rays

Operating modes

Agent orchestrator (default prompt)

Type a normal prompt. RAYS discovers skills and MCP servers, plans spawn steps and runs dynamic sub-agents. Use this for Blender, docs, GitHub MCP and local file/shell tasks.

Editing mode — `/code`

Analyzes the task, identifies symbols and files, negotiates permissions, plans edits and applies changes.

Chat mode — `/chat`

Read-only, contextual Q&A over your repo. No edits.

Example prompts

# agent orchestrator
> List this project's top-level files and summarize the README.

# editing
> /code Refactor auth middleware to support JWT refresh tokens.

# chat
> /chat how does the permission negotiation pipeline work in this repo?