# Understand and extend RAgents

Getting started, workflows, and development based on the current specification and the usage and operations documentation.

- [Core ideas](guide-ideas.md): How AI, TypeScript, and interactive interfaces work together.
- [Actors and messages](guide-runtime.md): Runs, actors, messages, turns, and the journal form the shared runtime.
- [Get started](guide-getting-started.md): Install RAgents, start a profile, and create your first run.
- [Web and VS Code](guide-clients.md): Use the same runs in the browser and in the VS Code extension; automate them through the API and command-line tools.
- [Distributed work](guide-distributed.md): Run the host locally or remotely, keep tools beside the project, and move runs between servers.
- [Work with TypeScript](guide-functions.md): Combine functions, program deterministic workflows, and involve models where needed.
- [Build mini-apps](guide-programs.md): Expose actor state and functions through interactive React views.
- [Plugins and skills](guide-plugins.md): Choose the right plugin form, connect contracts and prompts, and verify lifecycle and UI behavior.
- [Assign permissions](guide-access.md): Distinguish user permissions, actor grants, and the capabilities given to a subagent.