# Rytiv

> Rytiv is where coding agents build and ship: computers and sandboxes to work in, apps and Postgres databases to ship to, in the EU. Connect an agent once over MCP, or use the CLI `ry` or the REST API.

Every page below is Markdown. The whole documentation as one file is at https://docs.rytiv.com/llms-full.txt.
Pages and sections marked "Not yet available" describe what is planned, not what you can use today.

## Get started

- [Rytiv documentation](https://docs.rytiv.com/index.md): Rytiv is where your coding agent builds and ships. Connect it once, and it gets computers and sandboxes to work in, and apps and Postgres to ship to, in the EU.
- [Quickstart: connect your coding agent](https://docs.rytiv.com/quickstart.md): Add Rytiv to Claude Code with one command. Your agent can then deploy apps, create databases and work in computers on Rytiv.
- [Authentication](https://docs.rytiv.com/authentication.md): Every request to Rytiv carries an API key as a bearer token. Create keys in the console, with the CLI or over the API, narrow them with scopes or an agent class, and revoke them at any time.
- [Docs for agents](https://docs.rytiv.com/agents.md): These docs are written for people and for coding agents. Every page is available as Markdown, and the whole set as one file.

## Guides

- [Deploy a Next.js app](https://docs.rytiv.com/guides/deploy-nextjs.md): From a Next.js directory to a URL with one command, then secrets, logs, releases and rollbacks. The same path works for every framework Rytiv detects.
- [Apps](https://docs.rytiv.com/apps.md): Deploy from a source directory or a prebuilt image. Rolling deploys, secrets, logs, releases and rollbacks.
- [Computers](https://docs.rytiv.com/computers.md): A computer is a machine of its own for a coding agent. Create one, connect Claude Code to it, work in it over a shell or its desktop, and let it shut down when idle; the home disk stays.
- [Postgres](https://docs.rytiv.com/postgres.md): Create a Postgres database, connect an app or your laptop to it, branch it for an experiment, fork it from a point in time, restore it in place, and set when it sleeps.
- [Sandboxes](https://docs.rytiv.com/sandboxes.md): Short-lived machines for one task each. A sandbox starts from a template, runs commands and holds files, and is removed at its deadline.
- [Agents and tokens](https://docs.rytiv.com/guides/agents-and-tokens.md): Give a coding agent a key of its own, narrow it with scopes or an agent class, connect a hosted client through OAuth, and read the audit of what the agent did.
- [Credit and pricing](https://docs.rytiv.com/billing.md): Rytiv is paid from prepaid credit in euros. Every account admitted from the waitlist starts with 100 EUR; usage is drawn from the credit as it runs. Prices, top-ups, auto-recharge, and what happens at zero.
- [Custom domains and TLS](https://docs.rytiv.com/guides/custom-domains.md): Put your own domain on an app. Add it, set the DNS records the answer names, and Rytiv proves it, issues the certificate and renews it.
- [Buckets](https://docs.rytiv.com/guides/buckets.md): S3-compatible object storage. Create a bucket, upload and download with presigned URLs, attach it to an app for direct access, set CORS for browser uploads.
- [Cron and jobs](https://docs.rytiv.com/guides/cron-and-jobs.md): Run something of an app on a schedule, by calling a path or by running a command on a machine of its own, and run one-off commands as jobs with their exit code and output kept.

## Concepts

- [How Rytiv works](https://docs.rytiv.com/concepts/how-it-works.md): The building blocks your agent works with, how a request becomes a running machine, what sleeps and what stays, and the project model that comes next.
- [Projects](https://docs.rytiv.com/concepts/projects.md): A project holds everything one product needs on Rytiv: its sandbox, its twins and its production, so your agent can build it end to end.
- [Project sandbox](https://docs.rytiv.com/concepts/sandbox.md): The part of a project where your agent may do anything: build, break and try again.
- [Twins](https://docs.rytiv.com/concepts/twins.md): A twin is a disposable copy of production for one task, with its own database branch, its own preview address, its own machine.
- [Production](https://docs.rytiv.com/concepts/production.md): The part of a project that serves your users. Your agent reads it freely and changes it only in ways that can be undone.
- [Confirmations](https://docs.rytiv.com/concepts/confirmations.md): Irreversible steps wait for one tap with your passkey. Everything else runs without asking.
- [Limits and quotas](https://docs.rytiv.com/concepts/limits.md): Every bound the platform enforces, in one place. Organization limits, machine sizes, build machines, sandboxes, databases, tokens, schedules, jobs, domains, buckets and rate limits.
- [Error catalog](https://docs.rytiv.com/concepts/errors.md): Every error code the API answers, with its HTTP status and what to do about it. Generated from the contract's code lists.
- [Regions](https://docs.rytiv.com/concepts/regions.md): Where your machines, databases and files run. One EU region at launch; a machine never leaves the region it was created in.
- [Security and data](https://docs.rytiv.com/concepts/security.md): Where your data lives, how secrets are kept, what a key can reach, how machines are isolated and what TLS covers.

## API reference

- [REST API basics](https://docs.rytiv.com/reference/api-basics.md): The base URL, how requests are authenticated, the one error format every route answers with, and how to act for a managed organization.
- [API reference](https://docs.rytiv.com/reference/api.md): Every endpoint of the Rytiv REST API, generated from the control plane's routes and the contract's schemas.
- [Apps](https://docs.rytiv.com/reference/api/apps.md): Create, list, label and delete apps; attach databases, buckets and volumes; link apps to each other.
- [Deploys and releases](https://docs.rytiv.com/reference/api/deploys.md): Detect a project, build it, deploy an image, follow a deploy, list releases and roll back; previews and Git-connected deploys.
- [Machines](https://docs.rytiv.com/reference/api/machines.md): The virtual machines behind an app: create, read, start, stop, suspend, destroy, migrate; logs, snapshots, files and shell sessions.
- [Computers](https://docs.rytiv.com/reference/api/computers.md): Watch or take over a computer's desktop, and see who had control.
- [Sandboxes](https://docs.rytiv.com/reference/api/sandboxes.md): Short-lived machines with a deadline: create from a template, run commands, read and write files, extend, end.
- [Postgres](https://docs.rytiv.com/reference/api/postgres.md): Databases Rytiv runs for you: create, branch, fork, restore, expire, fetch a copy's connection URL, delete.
- [Volumes](https://docs.rytiv.com/reference/api/volumes.md): Persistent disks: create, list, resize, attach to an app, detach, delete.
- [Buckets](https://docs.rytiv.com/reference/api/buckets.md): S3-compatible object storage: create buckets, presign object URLs, list and delete objects, set CORS, attach to apps.
- [Secrets](https://docs.rytiv.com/reference/api/secrets.md): Encrypted environment variables of an app: set, list names, remove, and choose which ones a build may see.
- [Tokens and keys](https://docs.rytiv.com/reference/api/tokens.md): API keys with scopes and expiry, agent tokens with a class, the audit of agent actions, SSH keys and the device login.
- [Organization](https://docs.rytiv.com/reference/api/organization.md): Your organization, its wake page and signed-access keys, organizations you manage for others, and deleting your own.
- [Billing and usage](https://docs.rytiv.com/reference/api/billing.md): Prepaid credit in euro: balance, ledger, top-ups, auto-recharge, the payment portal, the billing preview and metered usage.
- [Custom domains](https://docs.rytiv.com/reference/api/domains.md): Your own domains on an app: add, check, redirect, remove; prove a whole zone once.
- [Cron and jobs](https://docs.rytiv.com/reference/api/cron-and-jobs.md): Schedules that call a path of an app or run a command on a machine of their own, their run history, and one-off jobs.
- [Protection and network](https://docs.rytiv.com/reference/api/protection-and-network.md): Who may open an app (password, signed links), what its machines may reach, and public UDP endpoints.
- [Mail](https://docs.rytiv.com/reference/api/mail.md): Send mail from your own domains, read the delivery log, receive inbound mail, and manage suppressions.
- [Webhooks](https://docs.rytiv.com/reference/api/webhooks.md): Be called when something happens in your organization, and read the deliveries.
- [MCP](https://docs.rytiv.com/reference/api/mcp.md): The MCP server your coding agent talks to: one endpoint, JSON-RPC over HTTP, the same key as every other route.
- [OAuth and device login](https://docs.rytiv.com/reference/api/oauth.md): How a hosted MCP client connects without a pasted key, and how the CLI signs in with a code.

## CLI reference

- [CLI reference](https://docs.rytiv.com/reference/cli.md): Every command of ry, the Rytiv CLI, generated from its source.
- [ry apps](https://docs.rytiv.com/reference/cli/apps.md): Manage apps.
- [ry attach](https://docs.rytiv.com/reference/cli/attach.md): Attach a resource to an app: injects the connection URL as a managed secret.
- [ry billing](https://docs.rytiv.com/reference/cli/billing.md): What the current usage costs.
- [ry bucket](https://docs.rytiv.com/reference/cli/bucket.md): Manage object storage buckets (files for your apps).
- [ry computer](https://docs.rytiv.com/reference/cli/computer.md): Links to watch or control a computer VM (images/computer), and who had control.
- [ry config](https://docs.rytiv.com/reference/cli/config.md): Manage the project file (rytiv.json).
- [ry console](https://docs.rytiv.com/reference/cli/console.md): Start a throwaway machine from this app's last image and get a shell in it.
- [ry cron](https://docs.rytiv.com/reference/cli/cron.md): Run something of an app on a schedule: call a path (the app is woken) or run a command on its own machine.
- [ry deploy](https://docs.rytiv.com/reference/cli/deploy.md): Deploy from a source directory (--source) or a prebuilt OCI image (--image); reads rytiv.json if present.
- [ry deploys](https://docs.rytiv.com/reference/cli/deploys.md): Deployment history of an app: which machines each deploy created and retired.
- [ry detect](https://docs.rytiv.com/reference/cli/detect.md): What this project is and what it needs - reads the directory, changes nothing.
- [ry domains](https://docs.rytiv.com/reference/cli/domains.md): Attach your own domains to an app.
- [ry exec](https://docs.rytiv.com/reference/cli/exec.md): Run a command in a running machine and exit with its exit code (the command goes after --).
- [ry forward](https://docs.rytiv.com/reference/cli/forward.md): Forward a local port to a port inside a machine, e.g. `ry forward shop 8080:3000` (no public port needed).
- [ry git](https://docs.rytiv.com/reference/cli/git.md): Deploy on push: connect an app to a GitHub repository and see what pushes did.
- [ry job](https://docs.rytiv.com/reference/cli/job.md): Run one command in an app's image on a throwaway machine, and get its result.
- [ry link](https://docs.rytiv.com/reference/cli/link.md): Let an app reach another app privately at <target>.internal (no public door needed).
- [ry links](https://docs.rytiv.com/reference/cli/links.md): Show the private app-to-app links in this workspace.
- [ry login](https://docs.rytiv.com/reference/cli/login.md): Sign in: shows a code to confirm in the console (--token stays for CI).
- [ry logs](https://docs.rytiv.com/reference/cli/logs.md): Stream the console output of an app's machines.
- [ry machine](https://docs.rytiv.com/reference/cli/machine.md): Act on a single machine.
- [ry machines](https://docs.rytiv.com/reference/cli/machines.md): List machines for an app.
- [ry mail](https://docs.rytiv.com/reference/cli/mail.md): Transactional email: sending domains, log, inbox, suppressions.
- [ry maintenance](https://docs.rytiv.com/reference/cli/maintenance.md): Switch an app's maintenance mode: the edge answers every request with 503, the machines keep running.
- [ry new](https://docs.rytiv.com/reference/cli/new.md): Start a new project from a template - scaffolder plus the part that makes it deploy here.
- [ry postgres](https://docs.rytiv.com/reference/cli/postgres.md): Managed Postgres: create, branch, fork, sleep policy (stored; not in force on every host).
- [ry preview](https://docs.rytiv.com/reference/cli/preview.md): One preview address per branch - opened by a push, closed by itself.
- [ry profile](https://docs.rytiv.com/reference/cli/profile.md): Saved logins for lab, prod, ...
- [ry protect](https://docs.rytiv.com/reference/cli/protect.md): Give an app a protected view (password or share link).
- [ry proxy](https://docs.rytiv.com/reference/cli/proxy.md): Forward a local port to a machine, e.g. `ry proxy my-db 15432:5432` then `psql -h 127.0.0.1 -p 15432`.
- [ry releases](https://docs.rytiv.com/reference/cli/releases.md): The releases of an app: what went out, which one runs, and which ones a rollback can bring back.
- [ry resource](https://docs.rytiv.com/reference/cli/resource.md): Manage attachable resources (redis, postgres).
- [ry rollback](https://docs.rytiv.com/reference/cli/rollback.md): Deploy an earlier release again, without a rebuild (default: the previous release that went live); secrets, settings, volumes and databases stay as they are.
- [ry sandbox](https://docs.rytiv.com/reference/cli/sandbox.md): Short-lived machines for one task each - created from a template, removed at their deadline.
- [ry secrets](https://docs.rytiv.com/reference/cli/secrets.md): Manage app secrets.
- [ry ssh](https://docs.rytiv.com/reference/cli/ssh.md): An interactive shell in a running machine (over the Rytiv API, no SSH needed); real SSH for IDEs: ry ssh config.
- [ry ssh-keys](https://docs.rytiv.com/reference/cli/ssh-keys.md): SSH public keys of this org (for ssh <app>@ssh.<domain>).
- [ry status](https://docs.rytiv.com/reference/cli/status.md): Overview of all apps and machine states.
- [ry tokens](https://docs.rytiv.com/reference/cli/tokens.md): API tokens for CI (org-scoped).
- [ry unlink](https://docs.rytiv.com/reference/cli/unlink.md): Remove a private link between two apps.
- [ry usage](https://docs.rytiv.com/reference/cli/usage.md): Show metered usage with prices and total.
- [ry volume](https://docs.rytiv.com/reference/cli/volume.md): Manage durable volumes (persistent block storage).
- [ry webhooks](https://docs.rytiv.com/reference/cli/webhooks.md): Endpoints we call when a message is sent, bounces, is complained about, fails or arrives.
- [ry whoami](https://docs.rytiv.com/reference/cli/whoami.md): Show the identity behind the configured token: an org (product token) or the system (operator token).

## SDK & MCP

- [MCP tools](https://docs.rytiv.com/reference/mcp-tools.md): The tools the Rytiv MCP server offers, with their parameters and annotations, generated from the server's tool table.
- [TypeScript SDK](https://docs.rytiv.com/sdk/typescript.md): A typed client for Rytiv in TypeScript follows. Until it is published, the REST API is a few lines of fetch, and the MCP server gives your agent the same platform as tools.