Rayu Code v3 is a native terminal AI coding agent: one binary, no runtime to install. Sign in once to use hosted models on one credit balance, narrow the tools it may use, and script it headless with rayu run.
Get started
InstallationRayuCode v3 ships as a single native Rust binary named rayu . There is no Node.js, npm, Bun, Python or sudo involved: the installer downloads one prebuilt execuQuickstartThe fastest path is a Rayu account: sign in once and Rayu's hosted models are ready to use — no provider keys, no per provider setup.VS Code extensionRayucode is the same agent as the terminal, inside Visual Studio Code: the same tools, MCP servers, skills and slash commands, rendered in a webview with an ediTelegram botDrive a Rayu session from your phone. Send a prompt from Telegram, watch the answer stream back, approve the tools the agent wants to run, and answer its questi
Guides
Keyboard & inputThe prompt is a small editor. This page is the key map; the behaviour behind some keys lives in other pages. /help inside a session shows the same map, filteredPermissions & safetyRayuCode v3 does not show a per tool approval prompt during an interactive session. The model reads, edits and runs commands without asking. What protects you iSessions & checkpointsA session is one conversation plus the work it did, saved continuously. This page covers where sessions live, how to resume and fork them, and how to get back tMemory & project instructionsRayu reads standing instructions at the start of every session, before you type anything. They are how you stop repeating yourself: "we use pnpm, not npm", "a sSkills & pluginsA skill is a reusable procedure Rayu loads only when it is needed. Instead of putting a long workflow into RAYU.md and paying for it on every turn, you write itMCP serversThe Model Context Protocol connects Rayu to external tool servers: an issue tracker, a database, a design tool, a browser. Each server publishes tools, resourceSubagents & swarmRayu can spread work across several agents. In v3 there is one mechanism for that: the swarm . The agent spawns todo lane workers, each gets its own session witHooksHooks run your own commands at fixed points in a session: when a turn starts, when a tool is about to run, after an edit, when a session closes. Use them for ruHeadless & CIrayu run sends one message, prints the answer, and exits. It is the interface for scripts, cron jobs, git hooks, and CI: no terminal UI, no interactive prompt, IDEs & terminalsRayuCode v3 is a terminal program. It does not connect to a running editor, and there is no /ide command in v3. What it does have is careful terminal support: iMedia generationSome Rayu plans include hosted image and video models, reachable with the same Rayu API key that serves chat. This page covers the API surface and the credit mo
Models and providers
ModelsRayuCode v3 reads its model catalog live from the provider. With a Rayu credential, that catalog is whatever your account or key may use: labels, descriptions, ProvidersA provider is where model requests actually go. RayuCode v3 supports two credential shapes, but the shipped public build enables only the first. Build ProvidersAPI keys and the Rayu APIThis page is for your own code calling Rayu hosted models with a Rayu API key. One key works across every model your plan allows — you choose the model on each
Plans and billing
Subscription plansThis page explains how Rayu bills you, what each plan unlocks, and where to see your live numbers. Personal and team plans are one catalog with one ladder: eachCredits and limitsCredits are Rayu's metering currency for hosted model usage: every request you make to a Rayu hosted model is priced in credits, and your plan's allowance is spHow tokens are chargedThis page is the exact math behind a credit charge on Rayu hosted models: how the four token buckets are counted, what each bucket costs, and how precision and PoliciesThis page summarises the local payment policies for RayuCode subscriptions. The binding legal document is the RayuCode — Local Payment Terms and Conditions; if
Reference
CLI referenceEverything below is the surface of the shipped rayu v3 binary. Every flag and subcommand is real: it was read from rayu help on a release build. When in doubt, Slash commandsSlash commands run inside an interactive session (the terminal TUI, or the RayuCode editor panel). Type / to open the menu, keep typing to filter, press Enter tConfigurationRayuCode v3 is configured in TOML at /.rayu/config.toml . There is one file, not a JSON settings hierarchy, and no settings.json merge chain. Three ways to chanTroubleshootingStart with these three, in this order. They answer most problems. Inside a session, /info shows the running build, model, account and token counters, /auth show