# Casama > Casama gives people AI teammates (bots) with their own computers. Bots remember, work on a real Linux computer, ask before risky steps, run on schedules and triggers, and can be self-hosted with any model. Open source (Apache-2.0). Each link below goes to a page's markdown copy. Every page on docs.casama.ai has one: add `.md` to its address. Building on Casama: - HTTP API: https://api.casama.ai, described by https://docs.casama.ai/api/openapi.json (OpenAPI 3.1). - Docs over MCP, no sign-in needed: https://api.casama.ai/mcp/docs (tools: search_docs, read_doc, list_doc_pages, get_api_operation). `npx -y @casama/mcp` has the same tools plus check_plugin, gallery_search and your bots. - Skills for coding agents: https://github.com/stackwares/casama/tree/main/agent-kit (in Claude Code: `/plugin marketplace add stackwares/casama`, then `/plugin install casama-dev@casama`). - Start a plugin, skill, bot template or routine with `casama init`, and check a plugin with `npx @casama/plugin-check`. - Check the gallery before you build: https://gallery.casama.ai has ready-made skills, apps, routines, bots, plugins, starter sets and looks. `npx -y @casama/mcp` has gallery_search, `casama gallery search ` searches from a terminal and `casama init --from-gallery bot/` (or `plugin/`) starts from one. Gallery catalog (public JSON, no sign-in; every file has `schema` and `items` except where noted): - https://gallery.casama.ai/index.json: themes, color schemes, wallpapers and skills. - https://gallery.casama.ai/apps.json, bots.json, routines.json, plugins.json, sets.json: apps, starter bots, routine ideas, reviewed plugins and starter sets. - https://gallery.casama.ai/authors.json: authors and their items (`authors`). - https://gallery.casama.ai/manifest.json: the sha256 of every file above (`files`), signed with Ed25519 in manifest.sig. - https://api.casama.ai/v1/gallery/stats: installs, trending, active users and run success per item (`items`, keyed `/`; small numbers left out). ## Get started - [What is Casama](https://docs.casama.ai/introduction.md): Casama gives you AI teammates, called bots, that keep working after you close the chat. - [Quick start](https://docs.casama.ai/quick-start.md): Get a Casama server running, sign in, and give your first bot a task. - [FAQ](https://docs.casama.ai/faq.md): Covers General, Privacy and safety, Self-hosting, Building on Casama. ## Bots - [Bots and models](https://docs.casama.ai/guide/bots.md): A bot is an AI teammate with its own instructions, model, memory, skills, routines and computer. - [Memory and knowledge](https://docs.casama.ai/guide/memory.md): Bots remember what matters about you and your work, so you don't repeat yourself: something you tell a bot in one chat, it can recall in the next. - [Skills](https://docs.casama.ai/guide/skills.md): A skill is a set of instructions a bot loads when a task calls for it, like your house style for reports or the steps for cleaning up a spreadsheet. - [Templates, sharing and import](https://docs.casama.ai/guide/sharing.md): You can pass a bot along in two ways: share a copy as a template that anyone can import into their own workspace, or give people in your workspace access to the bot itself. - [Bots working together](https://docs.casama.ai/guide/bots-together.md): Bots can split up work, hand tasks to each other, manage other bots, and talk to bots outside your workspace. ## Chat - [Chatting with a bot](https://docs.casama.ai/guide/chat.md): A chat is where you give a bot work and see it happen: its replies, each step it takes, the files it makes and any questions it has for you. - [Group chats](https://docs.casama.ai/guide/group-chats.md): A group chat puts several bots in one conversation with you, so they can split a job and build on each other's work. - [The Library](https://docs.casama.ai/guide/library.md): The Library holds everything your bots make for you: sites and games, reports, pictures, videos, sounds, documents and other files. - [Pages](https://docs.casama.ai/guide/pages.md): A page is a small web page a bot publishes for you: a report, a dashboard, a tracker, a site or a game. - [Voice and calls](https://docs.casama.ai/guide/voice.md): Talk to your bots instead of typing. - [Chat apps](https://docs.casama.ai/guide/chat-apps.md): Chat apps let people reach a bot from the messaging tools they already use: Telegram, email, SMS, Slack, WhatsApp, Messenger, Feishu, iMessage, Microsoft Teams and Discord. - [Appearance and themes](https://docs.casama.ai/guide/appearance.md): Make Casama look the way you like: pick a whole theme in one tap, then change its colors, background and fonts. ## Getting work done - [Computers](https://docs.casama.ai/guide/computers.md): Every bot works on its own sandboxed Linux computer: a shell, a home folder that persists between chats, a browser that stays signed in, and on desktop computers, a screen you can watch and control. - [Your own computer](https://docs.casama.ai/guide/companion.md): The Casama desktop app for macOS, Windows and Linux can lend your machine to the bots you choose. - [Coding agents](https://docs.casama.ai/guide/coding-agents.md): A bot can hand a coding task to a dedicated coding agent (Claude Code, Codex or Cursor) and report back with a summary, the files that changed and, for cloud agents, a pull request link. - [Teach by showing](https://docs.casama.ai/guide/teach.md): Instead of writing instructions, you can show a bot how to do a task. - [Routines](https://docs.casama.ai/guide/routines.md): A routine is work a bot does later on its own: once at a time you pick, on a repeating schedule, or when something happens, such as a webhook, a meeting, a message or an event on your phone. - [Meeting notes](https://docs.casama.ai/guide/meetings.md): Casama doesn't send a bot into your calls. - [Projects and the ticket board](https://docs.casama.ai/guide/projects.md): Tasks is a shared ticket board for people and bots. ## Connections - [Apps and connections](https://docs.casama.ai/guide/connections.md): Connections give your bots tools beyond their own computer: your team's apps, any MCP server or OpenAPI source, logins from a password manager, and keys they use for you. - [Device connections and health](https://docs.casama.ai/guide/devices.md): Device connections let your bots use personal data from your phone or computer, such as your calendar, contacts and daily health summaries. - [Payments with approval](https://docs.casama.ai/guide/payments.md): A bot can pay a merchant for you, such as checking out an order on a website, with a single-use virtual card that you approve each time. - [Connect AI apps to Casama (MCP)](https://docs.casama.ai/guide/mcp.md): Casama is an MCP server, so AI apps such as Claude Code, Cursor and other MCP clients can list your bots, give them tasks and read the results. ## Control and privacy - [Autonomy, approvals and action rules](https://docs.casama.ai/guide/autonomy.md): Every bot decides for itself when to act and when to check with you first. - [Notifications and attention](https://docs.casama.ai/guide/attention.md): Bots tell you when they need a decision, when work is done, and when they notice something. - [Usage, budgets and plans](https://docs.casama.ai/guide/usage.md): Casama tracks what every bot spends on models, cloud computers and other metered services. - [Workspaces and teams](https://docs.casama.ai/guide/workspaces.md): A workspace holds your bots, their computers, memory, connections, secrets, billing and the people you work with. - [Privacy and security](https://docs.casama.ai/guide/privacy.md): Your chats, memories and files belong to you. ## Self-hosting - [Self-hosting](https://docs.casama.ai/self-hosting/index.md): Casama runs on your own hardware. - [Configuration](https://docs.casama.ai/self-hosting/configuration.md): Every setting for a Compose install lives in one file: infra/compose/.env. - [Casama Link](https://docs.casama.ai/guide/casama-link.md): Casama Link connects a Casama server you run yourself to a Casama Cloud workspace. - [Use your server on your phone (Casama Link)](https://docs.casama.ai/self-hosting/remote-access.md): A Casama server on your own Mac or PC normally answers only on that computer. - [Cloud computers and credits (Casama Link)](https://docs.casama.ai/self-hosting/casama-link-cloud.md): Run your own Casama server, but let Casama Cloud host the bots' computers or pay for the model calls. - [Computer providers](https://docs.casama.ai/self-hosting/computers.md): Every bot can have its own Linux computer: a shell, files, a browser and, with the desktop image, a screen you can watch live. - [Operating your server](https://docs.casama.ai/self-hosting/operations.md): This page covers day-to-day work on a running Casama server: upgrades, backups, monitoring, logs, audit-log forwarding and scaling, plus the Kubernetes Helm chart. - [Troubleshooting](https://docs.casama.ai/self-hosting/troubleshooting.md): Problems you might hit running your own Casama server, each as symptom, cause and fix. ## Build on Casama - [Build with AI agents](https://docs.casama.ai/develop/agents.md): If you build on Casama with a coding agent such as Claude Code, Codex or Cursor, give it these and it can answer from the real docs and API instead of guessing. - [HTTP API](https://docs.casama.ai/develop/api.md): Everything the Casama apps do goes through one HTTP API, and you can call it too: from a shell script, a backend service or your own app. - [CLI](https://docs.casama.ai/develop/cli.md): casama is the command-line client for Casama. - [Dart SDK](https://docs.casama.ai/develop/sdk.md): casama_sdk is the Dart and Flutter library for Casama. - [TypeScript client](https://docs.casama.ai/develop/typescript.md): @casama/client is the TypeScript and JavaScript library for Casama. - [Plugins](https://docs.casama.ai/develop/plugins.md): A plugin gives a bot new skills and new tools in one install. - [Webhooks](https://docs.casama.ai/develop/webhooks.md): Webhooks let other services start work in Casama. - [Bot template format](https://docs.casama.ai/develop/bot-templates.md): A bot template is one JSON file that describes a bot people can import: its instructions, skills, routines and the services it works with. - [Gallery catalog format](https://docs.casama.ai/develop/gallery-format.md): The gallery is a folder of items that anyone can add to by pull request to stackwares/casama-gallery. - [Routines and skills as files](https://docs.casama.ai/develop/workspace-files.md): Every routine and skill in a workspace can live as a Markdown file. - [Agent-to-agent (A2A)](https://docs.casama.ai/develop/a2a.md): A2A is an open protocol for AI agents to hand each other tasks. - [How Casama is built](https://docs.casama.ai/develop/architecture.md): This page is for people who want to read or change Casama's code. - [Contribute to Casama](https://docs.casama.ai/develop/contributing.md): Casama is open source, and bug reports, docs fixes, tests and features are all welcome. ## Optional - [Every page in one file](https://docs.casama.ai/llms-full.txt): all of the above, about 600 KB.