# Playcode Docs

> How to build, publish and run with Playcode. For you and your agent.

## Instructions for agents

- Act for the user through the Playcode MCP server at https://playcode.io/api/mcp, or through the Playcode CLI: `npm i -g @playcode/cli`.
- Read any page as Markdown: add `.md` to its address. The lists below give each page's Markdown address.
- Search the docs: https://playcode.io/docs/search.json?q=your+words
- Ask the user before anything that spends money, changes a plan or deletes.

## Start

- [What is Playcode](https://playcode.io/docs/start/what-is-playcode.md): Playcode is an AI platform for building and running websites and apps - what it builds, where it runs, what it costs and what stays yours.
- [Build and publish your first site](https://playcode.io/docs/start/first-site.md): From one sentence to a live address - describe the site, let the agent build it, check the preview and publish it on a free Playcode address.
- [How building with the agent works](https://playcode.io/docs/start/how-building-works.md): What the agent does after you send a message - questions, the plan, the work, the checks - what it costs, and how you steer, stop and undo it.
- [Plans and credits on one page](https://playcode.io/docs/start/plans-and-credits.md): The Free, Pro and Max plans side by side, what credits pay for, how long they last, and where to read the details.
- [Glossary](https://playcode.io/docs/start/glossary.md): Short definitions of the words these docs use - credit, workspace, project, static site, Cloud app, checkpoint, custom domain, agent, model, MCP and more.

## Build

- [Describe what you want](https://playcode.io/docs/build/describe-what-you-want.md): Write a request the agent can act on - who it is for, what to change, what to leave alone - and steer the work with answers, stops and undo.
- [Models and modes](https://playcode.io/docs/build/models-and-modes.md): The three build quality levels, the models behind each one, the Effort and Context dials, what they cost and where to change them.
- [Attach files and pictures](https://playcode.io/docs/build/attach-files.md): Give the agent screenshots, documents, spreadsheets, videos and archives in the chat - what it can read in each kind of file, and the size limits.
- [Images, music, voice and slides](https://playcode.io/docs/build/images-music-voice-and-slides.md): The media the agent makes for your project besides code - images, video clips, music, sound effects, narration and presentations - with costs and limits.
- [Undo and checkpoints](https://playcode.io/docs/build/undo-and-checkpoints.md): Take back the agent's changes in a static site, save and restore checkpoints in any project, and what each way back keeps and what it loses.
- [Spend fewer credits](https://playcode.io/docs/build/spend-fewer-credits.md): Get the same result for fewer credits - the right build quality, one part at a time, a new chat per task, lower Effort and Context, and a cost before big work.
- [What the agent remembers](https://playcode.io/docs/build/memory.md): What the agent knows in one chat, in a new chat and across a project - the conversation, the project's files and docs, AGENTS.md - and what it forgets.
- [Browser and Cloud projects](https://playcode.io/docs/build/browser-and-cloud-projects.md): The two kinds of Playcode project - a static site that runs in your browser and a Cloud app with its own computers - how to tell them apart and how to switch.
- [Projects and folders](https://playcode.io/docs/build/projects-and-folders.md): Find, rename, file, archive and delete projects in the left panel, and how many projects a workspace on the Free plan can keep.
- [Make a project private](https://playcode.io/docs/build/make-a-project-private.md): Turn off a project's public link on any plan, Free included, so only the people you invite can open it - and why the published site stays public.
- [Use the terminal](https://playcode.io/docs/build/terminal.md): Open a terminal on a Cloud app's development or production computer, keep a session running, and the limits on sessions.
- [Share a project](https://playcode.io/docs/build/share-a-project.md): Invite people to one project as Viewer, Editor or Admin, share it with a team, a workspace or by link, and see who can do what.
- [Workspaces, members and roles](https://playcode.io/docs/build/workspaces-members-and-roles.md): How a workspace holds projects, people, the plan and the credits - Personal and team workspaces, member roles, teams, invitations, and who pays.
- [Move a project to another workspace](https://playcode.io/docs/build/move-a-project.md): Move a project with its files, chats and Cloud computers into another workspace, and what changes for access, folders, billing and domains.

## Publish

- [Publish a website](https://playcode.io/docs/publish/publish-a-website.md): Put a static site or a Cloud app online at a free Playcode address, and publish again each time you want visitors to see a change.
- [Your Playcode address](https://playcode.io/docs/publish/your-playcode-address.md): Every published project gets a free address on playcode.site or playcode.run. On Pro or Max you can choose the name in it.
- [Bandwidth and limits](https://playcode.io/docs/publish/bandwidth-and-limits.md): What each plan includes for published projects - traffic, Cloud apps, branding and other limits - and what happens past each one.
- [Run a Cloud app](https://playcode.io/docs/publish/cloud-apps.md): How a Cloud app runs on Playcode - two computers, what a publish copies, where the data lives, sleep and wake, and what it costs.
- [Secrets and environment](https://playcode.io/docs/publish/secrets-and-environment.md): Keep API keys and settings out of your code. Store them per environment in Settings, and your Cloud app reads them from its environment.
- [Snapshots and rollback](https://playcode.io/docs/publish/snapshots-and-rollback.md): Save a checkpoint of a Cloud app's whole computer and restore it later. A restore discards every change made after that point.
- [Logs](https://playcode.io/docs/publish/logs.md): Read what your Cloud app writes while it runs, and the build log of a publish, to find out why something failed.
- [When a subscription ends](https://playcode.io/docs/publish/when-a-subscription-ends.md): What stays online and what stops when a Pro or Max plan ends - static sites, Cloud apps, domains and credits.
- [Buy a domain](https://playcode.io/docs/publish/buy-a-domain.md): Search for a name, see its yearly price and buy it in Playcode. Playcode registers it, runs its DNS, turns on HTTPS and connects it.
- [Connect a domain you own](https://playcode.io/docs/publish/connect-a-domain.md): Point a domain you bought elsewhere at your Playcode site.
- [DNS records](https://playcode.io/docs/publish/dns-records.md): Add, change and undo the DNS records of a domain whose DNS Playcode runs, for email, verification and other services.
- [Domain renewals and fees](https://playcode.io/docs/publish/renewals-and-fees.md): What a domain bought at Playcode costs to register, renew and restore, when it renews, and what happens if it expires.
- [Build and publish a mobile app](https://playcode.io/docs/publish/mobile-apps.md): Build an iPhone and Android app in a Cloud project, try it on your phone, and publish it to the App Store and Google Play.

## Add to your app

- [Send email from your app](https://playcode.io/docs/add-to-your-app/send-email.md): Your Cloud app sends email through Playcode, with no email provider to sign up for. Who receives it, what the send call answers, and what it costs.
- [Send from your own domain](https://playcode.io/docs/add-to-your-app/sending-domain.md): Verify a domain you control, and your app can email anyone, from an address like orders@send.example.com, with your name on it.
- [What your app may send](https://playcode.io/docs/add-to-your-app/what-your-app-may-send.md): Playcode Email carries transactional email only. What counts, what is not allowed and why, the sending limits, and what pauses an app's email.
- [Add AI to your app](https://playcode.io/docs/add-to-your-app/ai-in-your-app.md): Give your Cloud app AI features for its users. No AI account or key to buy - requests go through Playcode AI Gateway and use your credits.
- [Take payments with Stripe](https://playcode.io/docs/add-to-your-app/payments-with-stripe.md): The agent builds Stripe Checkout into your app, on your own Stripe account, with fraud protection and webhook fulfillment. What stays with you.
- [Connect Search Console or Notion](https://playcode.io/docs/add-to-your-app/connect-search-console-and-notion.md): Connect your Google Search Console or Notion account once, and the agent reads your search data or your notes when you ask, in any project.

## Account and billing

- [Plans](https://playcode.io/docs/account-and-billing/plans.md): Free, Pro and Max side by side - prices, monthly credits, what each plan includes, yearly billing, older plans, and who manages a workspace's plan.
- [Credits and balance](https://playcode.io/docs/account-and-billing/credits-and-balance.md): What credits pay for, where they come from, how long they last, the order Playcode spends them in, what stops at zero, and how to limit your spending.
- [Where your credits went](https://playcode.io/docs/account-and-billing/where-your-credits-went.md): Read the Usage page - spending by service, each member, each AI request and its cost breakdown - and see what one chat has spent.
- [Top-ups and auto-recharge](https://playcode.io/docs/account-and-billing/top-ups-and-auto-recharge.md): Buy credits once with a top-up, or let auto-recharge buy them when the balance runs low - packages, bonuses, limits, and what a failed charge does.
- [Invoices and tax ID](https://playcode.io/docs/account-and-billing/invoices-and-tax-id.md): Download invoices, add a tax ID and change the card - in Stripe's billing portal, which you open from Billing & plans - and get older invoices.
- [Change or cancel your plan](https://playcode.io/docs/account-and-billing/change-or-cancel-your-plan.md): Switch plans, sizes or monthly and yearly billing, cancel or keep a plan, end it at once, and what happens to credits, charges and refunds.
- [What a downgrade changes](https://playcode.io/docs/account-and-billing/what-a-downgrade-changes.md): What a workspace keeps and loses when it moves from Max to Pro, or from a paid plan to Free - credits, projects, Cloud apps, domains, uploads.
- [Email, sign-in and sessions](https://playcode.io/docs/account-and-billing/email-and-sign-in.md): How you sign in to Playcode, how to change your email address, see the devices you are signed in on, and sign one out or all of them.
- [Delete your account](https://playcode.io/docs/account-and-billing/delete-your-account.md): What to do before you delete your Playcode account, how to delete it in Settings, and what is removed at once, after 30 days, and never.

## Developers

- [Docs for agents](https://playcode.io/docs/developers/agents.md): For a coding agent such as Claude Code, Cursor or Codex - connect to Playcode, sign the user in, call operations, and know when to ask the user.
- [Access tokens and permissions](https://playcode.io/docs/developers/tokens-and-permissions.md): Create an access token for a script, a CI job or a tool that acts as you. What each permission allows, where it reaches, and how to revoke it.
- [The Playcode CLI](https://playcode.io/docs/developers/cli.md): The playcode command - sign in through the browser, list projects, read files and run commands on a project's computer, publish, and call any operation.
- [Connect Claude Code, Cursor or another MCP client](https://playcode.io/docs/developers/mcp.md): Give your coding agent Playcode's operations through MCP - run playcode mcp on your computer, or connect a client to Playcode's hosted server.
- [The Playcode SDK](https://playcode.io/docs/developers/sdk.md): @playcode/sdk for your app's backend: send email, generate video, call any management operation and verify webhooks, with typed errors.
- [The API](https://playcode.io/docs/developers/api.md): One GraphQL endpoint for every Playcode operation - how to call it, how operations are named and found, errors, consent and idempotency.
- [Webhooks](https://playcode.io/docs/developers/webhooks.md): Get a signed POST on your server when something changes in your workspace. Add an endpoint, verify each delivery, and handle retries.
- [Activity](https://playcode.io/docs/developers/activity.md): Every write in your workspace - who did it, when, through which door and to what. Read it on the Developers page or follow it through the API.

## Help

- [The preview does not load](https://playcode.io/docs/help/preview-does-not-load.md): Fix a preview that stays blank, spins, freezes the browser or shows an error, in a static site or a Cloud app.
- [A build or publish failed](https://playcode.io/docs/help/build-failed.md): Fix a publish that stopped - a static site's "The build failed", a Cloud app's "Publish failed", a history conflict, a cancelled publish or a plan limit.
- [My domain does not work](https://playcode.io/docs/help/domain-does-not-work.md): Fix a domain that does not open your site - a setting Playcode has not seen, one that points elsewhere, a certificate not ready yet, or a connect error.
- [An email did not arrive](https://playcode.io/docs/help/email-did-not-arrive.md): Find a sign-in code that did not come, or an email your Cloud app sent that never reached its inbox - and what to change in each case.
- [Credits went faster than expected](https://playcode.io/docs/help/credits-went-faster.md): Find what used your credits in Settings, Usage - the build quality, long chats, background tasks, media, Cloud computers, your app's AI - and how to spend less.
- [I cannot sign in](https://playcode.io/docs/help/cannot-sign-in.md): Fix a sign-in that fails - a code that does not work, a blocked check or cookie, Google, GitHub or Microsoft refusing, an ended session or an inactive account.
- [My projects are missing](https://playcode.io/docs/help/missing-projects.md): Find projects that do not show in the left panel - another workspace or account, a folder, the archive, a share that ended, or a stale copy in your browser.
- [Get help from a person](https://playcode.io/docs/help/get-help-from-a-person.md): Write to the Playcode team from the support page or the chat in the app - what to send, where the message goes, and what a person can do.
- [Report abuse](https://playcode.io/docs/help/report-abuse.md): Report a site or project on Playcode that hosts phishing, scams, malware, spam or other abuse - where to send it and what to include.

## Playcode Classic

- [Run code](https://playcode.io/docs/classic/run-code.md): How code runs in the browser editor - automatic runs, Start Preview, Stop and Reload, running one file, other languages, and loop protection.
- [Add npm packages](https://playcode.io/docs/classic/npm-packages.md): Add an npm package to a browser project from the NPM PACKAGES list, by importing it, or in package.json - and remove one.
- [The public folder](https://playcode.io/docs/classic/public-folder.md): Files in /public are served at your site's root as they are - favicon, robots.txt, downloads, files your code fetches - in the preview and when published.
- [Bundle configuration](https://playcode.io/docs/classic/bundle-configuration.md): How playcode.config.json sets the browser editor's build - minify, keep names, tree shaking, loop protection, the language and the Solid preset.
- [SPA mode](https://playcode.io/docs/classic/spa-mode.md): What SPA mode does in the preview and on the published site, when to turn it on or off, and how links to other pages behave.
- [Editor preferences](https://playcode.io/docs/classic/editor-preferences.md): The code editor's settings in Settings, Editor - font and tab size, line numbers, wrapping, formatting, code assist, Vim keys and the preview.
- [Turn off automatic runs](https://playcode.io/docs/classic/turn-off-auto-run.md): Stop the preview from rebuilding after every change with Live reload, make it wait longer with Live view delay, or keep a project from running when it opens.