Runable gives you three ways to interact with the AI: Agent Mode, Chat Mode, and Plan Mode. Each one is designed for a different type of task.Documentation Index
Fetch the complete documentation index at: https://docs.runable.com/llms.txt
Use this file to discover all available pages before exploring further.
Agent Mode
Agent Mode is the default. The agent builds things: writes code, generates media, deploys websites, creates documents, and executes multi-step tasks. When you send a message in Agent Mode, the agent gets a full sandbox environment where it can run commands, write files, install packages, search the web, and generate images, videos, and audio. You see everything happening live in the chat. Use Agent Mode when you need something built or created.Agent Mode: build a website for your business
What Agent Mode can do
- Write and run code in an isolated sandbox
- Generate images, videos, and audio
- Build and deploy websites with live URLs
- Create presentations, reports, spreadsheets, and carousels
- Search the web for current information
- Read and process files you upload
- Use skills for specialized workflows
- Install packages and start servers
Model tiers
Agent Mode lets you pick a model tier for each conversation:| Tier | Best for |
|---|---|
| Lite | Quick edits, simple questions, fast tasks |
| Pro | Most tasks. Good balance of quality and speed. |
| Max | Complex reasoning, multi-step projects, deep analysis |
Chat Mode
Chat Mode is text-only conversation. The agent answers questions and analyzes files, but it cannot execute code, generate media, search the web, or build anything. Switch to Chat Mode by clicking the Chat button in the input bar. Use Chat Mode when you need answers, not artifacts.Chat Mode: get advice on your marketing strategy
What Chat Mode can do
- Answer questions using the model’s knowledge
- Analyze attached images (PNG, JPG) and PDFs
- Have back-and-forth conversations
- Choose from all available AI models (not just tiers)
What Chat Mode cannot do
- Cannot execute code or run commands
- Cannot generate images, videos, or audio
- Cannot search the web
- No sandbox is created
- No rollback or branching
Plan Mode
Plan Mode is Agent Mode with a planning step first. Before building anything, the agent researches your request, asks clarifying questions, and writes a detailed plan for your approval. Only after you approve does it start executing. Turn on Plan Mode by clicking the Plan button in the input bar before sending your message. Use Plan Mode when your project has multiple moving parts and getting it wrong would waste time.Plan Mode: complex website with auth, payments, and database
What the agent does in Plan Mode
Researches your request
The agent searches the web for relevant patterns, reads files you uploaded, checks its memory for your preferences, and reviews documentation.
Asks clarifying questions
It comes back with questions about things you did not specify. For the client portal example: should login use email/password or magic links ? Do you need role-based access ? Should invoices support partial payments?
Writes a plan
After your answers, the agent creates a
plan.md file with a full breakdown: what it will build, in what order, using which tools, and how it will verify everything works.You review and approve
You read the plan in the side panel. Adjust anything you want. When it looks right, send a message approving it.
What Plan Mode cannot do
- The agent cannot edit files in Plan Mode (except the
plan.mditself) - The agent cannot run destructive commands while planning
- The agent cannot install packages or generate media until you approve the plan
Which mode to pick
| Situation | Mode |
|---|---|
| Build a website, presentation, video, image, or any artifact | Agent Mode |
| Ask a question, brainstorm, get advice, analyze a document | Chat Mode |
| Complex project with auth, payments, database, or multiple integrations | Plan Mode |
| Quick edit to something the agent already built | Agent Mode |
| Research a topic without building anything | Chat Mode |
| Project you tried before and it went in the wrong direction | Plan Mode |
You cannot switch between Agent Mode and Chat Mode in the middle of a conversation. The mode is set when the chat is created. Start a new chat to use a different mode.
Next steps
Branching and Rollback
Go back to any previous version or try multiple directions in parallel.
File Uploads
Upload images, documents, code, and other files for the agent to use.