---
title: Charming docs
description: Charming is a hosting platform for personal software for you and your AI agent.
sidebar:
  label: Docs home
  order: 1
seo:
  title: Docs home
---

<div class="chrm-mascot" aria-hidden="true">
  <img id="chrm-mascot" src="/docs/charming-mascot.svg" alt="" width="140" height="140" />
</div>
<script>
  (() => {
    const img = document.getElementById('chrm-mascot');
    if (!img) return;
    const sync = () => {
      const dark = document.documentElement.dataset.theme === 'dark';
      img.src = dark ? '/docs/charming-mascot-dark.svg' : '/docs/charming-mascot.svg';
    };
    sync();
    new MutationObserver(sync).observe(document.documentElement, { attributeFilter: ['data-theme'] });
  })();
</script>

## I'm new here

If you haven't built anything yet, start with [How Charming works](concepts/how-charming-works).

To build your first app, paste this into your agent:

```text
Read https://charm.ing/docs/prompts/build-your-first-app.md then help me create my first app.
```

See [Prompts for agents](prompts) for prompts you can copy to build, use, or design an app.

## What can my app do?

Every Charming app can:

- [Store data and files](capabilities/data-storage)
- [Use a stable name and URL](capabilities/app-names-and-urls)
- [Find apps again](concepts/where-your-apps-live)
- [Share with roles](capabilities/privacy-and-sharing)
- [Call services with secrets](capabilities/secrets)
- [Work from any AI agent](capabilities/connect-any-agent), automatically [over MCP](concepts/every-app-is-accessible-over-mcp)
- [Export source](capabilities/code-export)
- [Enable Template copies or publish a Listed Template](capabilities/templates) in the [public Template directory](https://charm.ing/templates)
- [Collect feedback](capabilities/feedback) and [ship fixes](guides/fix-and-improve-your-app)
- [Use a custom domain](capabilities/custom-domains)
- [Show images from another site](capabilities/external-images)
- [Use a small JavaScript library](guides/javascript-libraries)
- [Stay in sync with its AI agent](guides/agent-connected-apps)

## Charming for Work

Charming for Work adds company access, audit history, and data controls to regular Charming apps.

- [How Charming for Work works](work)
- [Security review](work/security-review)

## Look something up

Your connected agent can read these docs through Charming's `read_docs` tool, even without browser access. It can open the index, choose a page, and read the guidance before working on your app. See [Read docs through MCP](technical-reference#read-docs-through-mcp).

See [Limits](capabilities/limits) for current caps and rates.

To build without MCP, see [Build over the HTTP API](guides/build-over-the-http-api).

The agent-facing build manual and reference material live at these URLs:

- [Full build reference](https://charm.ing/docs/llms-full.txt)
- [MCP starter guide](https://charm.ing/docs/build-mcp.md)
- [HTTP starter guide](https://charm.ing/docs/build-http.md)
- [Prompts for agents](prompts)
- [Technical reference](technical-reference)
- [Browser runtime API](technical-reference/browser-runtime)
- [External files and CSP](technical-reference/external-files-and-csp)
- [JavaScript modules and libraries](guides/javascript-libraries)
- [REST API reference](reference) and [OpenAPI JSON](https://charm.ing/.well-known/openapi.json)
- [AI client setup guides](clients)
- [Client setup strings](https://charm.ing/docs/clients.txt)

For setup, choose your client under [AI clients](clients).

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.