# Cadet Docs > Cadet is a personal AI assistant that remembers, learns, and takes real action across your apps, files, and communication channels. Cadet runs in Cadet Cloud by default, can run locally or on your own infrastructure, and ships as open-source software. These docs cover setup, memory, channels, skills, tools, hosting, security, and developer workflows. Install: `curl -fsSL https://www.mycadet.ai/install.sh | bash && . ~/.config/cadet/env` Repo: https://github.com/vargasjr-dev/mycadet Docs: https://www.mycadet.ai/docs Full LLM index: https://www.mycadet.ai/llms.txt Every page below is served as Markdown at its canonical URL with a `.md` suffix (e.g. https://www.mycadet.ai/docs/getting-started.md) or by sending an `Accept: text/markdown` header. ## Docs - [Meet Cadet](https://www.mycadet.ai/docs/index.md): Cadet documentation — guides, tutorials, and references for building your personal AI assistant. - [Cadet Constitution](https://www.mycadet.ai/docs/constitution.md): The Cadet Constitution — our purpose, worldview, principles, and the commitments that guide every product, design, and engineering decision we make. - [Developer Guide](https://www.mycadet.ai/docs/developer-guide.md): Technical reference for contributors and developers working on Cadet Cloud. - [API & Communication](https://www.mycadet.ai/docs/developer-guide/api.md): SSE event stream, event payloads, connection management, and remote access via SSH. - [Architecture](https://www.mycadet.ai/docs/developer-guide/architecture.md): Platform domains, repository structure, and how the runtime, clients, and gateway fit together. - [Contributing](https://www.mycadet.ai/docs/developer-guide/contributing.md): How to set up the Cadet repo locally, run tests, follow code conventions, and submit a pull request. - [Development Workflow](https://www.mycadet.ai/docs/developer-guide/development-workflow.md): Claude Code slash commands, parallel PR execution, automated review loops, and the release pipeline. - [Features & Capabilities](https://www.mycadet.ai/docs/developer-guide/features.md): Integrations, dynamic skill authoring, browser automation, attachments, and media embeds. - [Get Started](https://www.mycadet.ai/docs/developer-guide/get-started.md): Developer on-ramp for Cadet: repo layout, local dev setup, CLI, HTTP API, and SSE event stream. - [Architecture](https://www.mycadet.ai/docs/developer-guide/internals/architecture.md): Cross-system map of the Cadet repo — invariants, domain boundaries, data flow, and the local/cloud hosting split. - [Assistant Architecture](https://www.mycadet.ai/docs/developer-guide/internals/assistant-architecture.md): Runtime internals — conversation loop, tool dispatch, memory, scheduling, and the daemon boundary. - [Credential Execution Service](https://www.mycadet.ai/docs/developer-guide/internals/credential-execution-service.md): CES — credential isolation, secure commands, and the RPC boundary. - [Gateway Architecture](https://www.mycadet.ai/docs/developer-guide/internals/gateway-architecture.md): Ingress boundary — webhooks, Telegram, Twilio, and the reverse proxy. - [Integrations Architecture](https://www.mycadet.ai/docs/developer-guide/internals/integrations.md): How third-party integrations (OAuth2 skills, channels, and plugins) attach to the assistant. - [Memory Architecture](https://www.mycadet.ai/docs/developer-guide/internals/memory.md): Memory system — extraction, recall, and provenance gates. - [Scheduling Architecture](https://www.mycadet.ai/docs/developer-guide/internals/scheduling.md): How the assistant schedules work — heartbeats, wake intents, and task queues. - [Security Architecture](https://www.mycadet.ai/docs/developer-guide/internals/security.md): Security model — sandboxing, credentials, permissions, and secret handling. - [Turn Actor Architecture](https://www.mycadet.ai/docs/developer-guide/internals/turn-actor.md): The turn-actor model — how a conversation turn is routed and executed. - [Security & Permissions](https://www.mycadet.ai/docs/developer-guide/security.md): Sandbox model, credential storage, trust rules, and permission modes for Cadet Cloud. - [Environments](https://www.mycadet.ai/docs/environments.md): Choose a deployment environment for Cadet: Cadet Cloud (recommended), local, or user-hosted (GCP or a custom Linux host), with trade-offs for each. - [Extensibility](https://www.mycadet.ai/docs/extensibility.md): All of the ways your Assistant can build on themselves. Overview of the surfaces a plugin can bundle and how they compose. - [Apps](https://www.mycadet.ai/docs/extensibility/apps.md): Apps let a plugin ship persistent, interactive UI (dashboards, tools, games) served in the workspace panel, built as compiled React. - [Channels](https://www.mycadet.ai/docs/extensibility/channels.md): Incoming webhooks can be accepted by declaring public ingress in channels/ingress.json. The gateway signature-checks those routes and forwards them to matching plugin handlers. - [Distribution](https://www.mycadet.ai/docs/extensibility/distribution.md): How plugins ship: a curated marketplace catalog, installing by name from the CLI, installing directly from a GitHub URL (untrusted), the catalog row shape, and why entries pin an immutable commit. - [Hooks](https://www.mycadet.ai/docs/extensibility/hooks.md): Lifecycle hooks let a plugin run code at fixed points during the Assistant's lifecycle. - [MCP servers](https://www.mycadet.ai/docs/extensibility/mcp.md): A plugin declares MCP servers in a root mcp.json. The assistant connects them on install and registers their tools alongside workspace-configured MCP tools. - [Plugins](https://www.mycadet.ai/docs/extensibility/plugins.md): How a plugin is laid out on disk, what its package.json manifest declares, and the single @mycadet/plugin-api package every surface imports from. - [Routes](https://www.mycadet.ai/docs/extensibility/routes.md): Routes let a plugin serve HTTP endpoints in its own /x/plugins// namespace. Public internet webhooks are declared separately as plugin ingress. - [Skills](https://www.mycadet.ai/docs/extensibility/skills.md): Skills let a plugin bundle instructions, assets, and scripts the Assistant loads on demand when a conversation matches what the skill is for. - [Tools](https://www.mycadet.ai/docs/extensibility/tools.md): Tools let a plugin add new actions the model can call, landing in the same catalog as the Assistant's built-in tools. - [Getting Started](https://www.mycadet.ai/docs/getting-started.md): Get started with Cadet: installation, key concepts, a quick start guide, and self-improving skills. - [Installation](https://www.mycadet.ai/docs/getting-started/installation.md): Get started with Cadet: sign up for Cadet Cloud, install the iOS or Android app, the macOS or Windows desktop app, or self-host. System requirements, setup, and permissions. - [Quick Start](https://www.mycadet.ai/docs/getting-started/quick-start.md): Your first 2 minutes with Cadet — setup, meeting your assistant, and getting started. - [What is Cadet?](https://www.mycadet.ai/docs/getting-started/what-is-cadet.md): What is Cadet? A personal AI assistant with tools, memory, identity, and a private cloud workspace. - [Your First Skill](https://www.mycadet.ai/docs/getting-started/your-first-skill.md): Use and create your first Cadet skill — discover built-in skills, install new ones, and build custom skills. - [Glossary](https://www.mycadet.ai/docs/glossary.md): Cadet glossary — shared definitions for assistant, guardian, personal intelligence, memory, skills, channels, gateway, and other key terms. - [Help](https://www.mycadet.ai/docs/help.md): Get help with Cadet — frequently asked questions, common issues, and support channels. - [Common Issues](https://www.mycadet.ai/docs/help/common-issues.md): Troubleshoot common Cadet issues — installation, permissions, skills, performance, and workspace problems. - [FAQ](https://www.mycadet.ai/docs/help/faq.md): Frequently asked questions about Cadet — product capabilities, privacy, data handling, and your assistant. - [Getting Help](https://www.mycadet.ai/docs/help/getting-help.md): How to get help with Cadet — community, GitHub issues, email support, and what information to include. - [Hosting options](https://www.mycadet.ai/docs/hosting-options.md): Choose where your assistant runs: Cadet Cloud (recommended), local on your Mac or Windows PC, or self-hosted on your own infrastructure. - [Cloud hosting](https://www.mycadet.ai/docs/hosting-options/cloud-hosting.md): Run your assistant on Cadet Cloud: always-on, sandboxed per account, reachable from web, desktop, voice, and chat channels. - [GCP](https://www.mycadet.ai/docs/hosting-options/gcp.md): Run your assistant on a Compute Engine VM in your own Google Cloud project: provision the VM, hatch on it, and reach it through a tunnel. - [Local hosting](https://www.mycadet.ai/docs/hosting-options/local-hosting.md): Run your assistant locally on your Mac or Windows PC with setup guidance, tradeoffs, and best practices. - [Pair a device](https://www.mycadet.ai/docs/hosting-options/pair-a-device.md): Reach a self-hosted assistant from your phone, tablet, or another computer: open a tunnel, pair a device, and revoke access when you're done. - [Key Concepts](https://www.mycadet.ai/docs/key-concepts.md): Core Cadet concepts — workspace, skills and tools, memory and context, channels, assistant identity, and glossary. - [Agentic Payments](https://www.mycadet.ai/docs/key-concepts/agentic-payments.md): How your assistant pays for things on your behalf through your Link account: approve an amount in the Link app, and it checks out with a single-use virtual card. - [Channels](https://www.mycadet.ai/docs/key-concepts/channels.md): Cadet communication channels — desktop app, CLI, Telegram, Slack, email, and phone. Same assistant everywhere, adapted to each channel. - [Memory & Context](https://www.mycadet.ai/docs/key-concepts/memory-and-context.md): How Memory v3 captures, organizes, connects, and recalls useful knowledge across conversations, plus the controls for creating and refining memories. - [Model Profiles](https://www.mycadet.ai/docs/key-concepts/model-profiles.md): Control which LLM model and settings your assistant uses for each job — conversations, memory, background tasks — and optimize token costs with profiles and call-site overrides. - [OAuth Integrations](https://www.mycadet.ai/docs/key-concepts/oauth-integrations.md): How Cadet connects to third-party services via OAuth2: supported services, how the credential vault works, security model, and troubleshooting. - [Scheduling](https://www.mycadet.ai/docs/key-concepts/scheduling.md): How scheduling and automation work in Cadet — one-shot and recurring schedules, heartbeats, watchers, playbooks, and proactive background work. - [Self-improving Skills](https://www.mycadet.ai/docs/key-concepts/self-improving-skills.md): See how your assistant turns procedures it has carried out into reusable skills that you can review, update, and remove. - [Tools & Skills](https://www.mycadet.ai/docs/key-concepts/skills-and-tools.md): Skills vs. tools in Cadet — atomic actions, capability bundles, built-in skills, and creating custom skills. - [The Workspace](https://www.mycadet.ai/docs/key-concepts/the-workspace.md): The Cadet workspace — folder structure, IDENTITY.md, SOUL.md, USER.md, LOOKS.md, config.json, and skills directory. - [Web Search](https://www.mycadet.ai/docs/key-concepts/web-search.md): How web search works in Cadet: managed vs bring your own, the four built-in providers (Provider Native, Perplexity, Brave, Tavily), the fallback chain, and how it's billed. - [Brave Search](https://www.mycadet.ai/docs/key-concepts/web-search/brave.md): How to connect Brave Search as your web search provider in Cadet: API key setup, provider configuration, and usage. - [Exa](https://www.mycadet.ai/docs/key-concepts/web-search/exa.md): How to connect Exa as your web search provider in Cadet: API key setup, provider configuration, and usage. - [Firecrawl](https://www.mycadet.ai/docs/key-concepts/web-search/firecrawl.md): How to connect Firecrawl as your web search and web fetch provider in Cadet: API key setup, provider configuration, and usage. - [Perplexity](https://www.mycadet.ai/docs/key-concepts/web-search/perplexity.md): How to connect Perplexity as your web search provider in Cadet: API key setup, provider configuration, and usage. - [Serply](https://www.mycadet.ai/docs/key-concepts/web-search/serply.md): How to connect Serply as your web search provider in Cadet: API key setup, provider configuration, and usage. - [Tavily](https://www.mycadet.ai/docs/key-concepts/web-search/tavily.md): How to connect Tavily as your web search provider in Cadet: API key setup, provider configuration, and usage. - [Privacy Notice](https://www.mycadet.ai/docs/privacy-policy.md): Cadet's privacy notice explaining how we collect, use, disclose and otherwise process your information. - [Cadet Prohibited Use Policy](https://www.mycadet.ai/docs/prohibited-use.md): Cadet's prohibited use policy — ensuring the Services are used safely, ethically, and in accordance with all applicable laws and regulations. - [Releases - Cadet Docs](https://www.mycadet.ai/docs/releases.md): Cadet release notes, versioning, update channels, and how to stay up to date with the latest features and fixes. - [Roadmap](https://www.mycadet.ai/docs/roadmap.md): What's coming to Cadet — shipping soon, up next, on the horizon, and what we're exploring. - [Skills Reference](https://www.mycadet.ai/docs/skills-reference.md): Cadet skills reference — documentation for all available skills, capabilities, and configuration options. - [ACP](https://www.mycadet.ai/docs/skills-reference/acp.md): ACP skill for Cadet — delegates development tasks through the Agent Client Protocol. - [Amazon](https://www.mycadet.ai/docs/skills-reference/amazon.md): Amazon skill for Cadet — shop, track orders, and manage your Amazon account through your assistant. - [App Builder](https://www.mycadet.ai/docs/skills-reference/app-builder.md): App Builder skill for Cadet — create interactive web apps with HTML, CSS, and JavaScript through conversation. - [Browser](https://www.mycadet.ai/docs/skills-reference/browser.md): Browser skill for Cadet — navigate web pages, interact with content, and extract information. - [ChatGPT Import](https://www.mycadet.ai/docs/skills-reference/chatgpt-import.md): ChatGPT Import skill for Cadet — imports your conversation history from ChatGPT into Cadet. - [Computer Use](https://www.mycadet.ai/docs/skills-reference/computer-use.md): Computer Use skill for Cadet: control supported apps on macOS and Windows with screen observation, clicking, and typing. - [Contacts](https://www.mycadet.ai/docs/skills-reference/contacts.md): Contacts skill for Cadet — manage contacts, communication channels, access control, and invite links. - [Document](https://www.mycadet.ai/docs/skills-reference/document.md): Document skill for Cadet — create and edit long-form text in a dedicated rich-text editor with Markdown support. - [DoorDash](https://www.mycadet.ai/docs/skills-reference/doordash.md): DoorDash skill for Cadet — order food, groceries, and convenience items through your assistant. - [Followups](https://www.mycadet.ai/docs/skills-reference/followups.md): Followups skill for Cadet — tracks messages awaiting responses across all communication channels. - [Gmail](https://www.mycadet.ai/docs/skills-reference/gmail.md): Gmail skill for Cadet — full inbox management including archive, label, draft, send, and filter capabilities. - [Google Calendar](https://www.mycadet.ai/docs/skills-reference/google-calendar.md): Google Calendar skill for Cadet — view events, create meetings, and check availability. - [Image Studio](https://www.mycadet.ai/docs/skills-reference/image-studio.md): Image Studio skill for Cadet — generate and edit images using AI through your assistant. - [Media Processing](https://www.mycadet.ai/docs/skills-reference/media-processing.md): Media Processing skill for Cadet — processes video, audio, and image files through a multi-phase AI pipeline. - [Messaging](https://www.mycadet.ai/docs/skills-reference/messaging.md): Messaging skill for Cadet — send and receive messages across Slack, Gmail, and Telegram. - [Notifications](https://www.mycadet.ai/docs/skills-reference/notifications.md): Notifications skill for Cadet — sends notifications through a unified routing system across connected channels. - [Phone Calls](https://www.mycadet.ai/docs/skills-reference/phone-calls.md): Phone Calls skill for Cadet — make and receive calls via Twilio with real-time voice conversation and transcription. - [Playbooks](https://www.mycadet.ai/docs/skills-reference/playbooks.md): Playbooks skill for Cadet — trigger-action automation rules for handling incoming messages. - [Schedule](https://www.mycadet.ai/docs/skills-reference/schedule.md): Schedule skill for Cadet — recurring and one-shot scheduled actions using cron syntax, RRULE patterns, or simple timestamps. - [Screen Watch](https://www.mycadet.ai/docs/skills-reference/screen-watch.md): Screen Watch skill for Cadet — observe your screen at regular intervals with OCR for context-aware assistance. - [Skill Management](https://www.mycadet.ai/docs/skills-reference/skill-management.md): Skill Management skill for Cadet — creates and deletes custom managed skills to extend your assistant. - [Slack](https://www.mycadet.ai/docs/skills-reference/slack.md): Slack skill for Cadet — scan channels, summarize threads, manage reactions, and configure privacy-aware integration. - [Start the Day](https://www.mycadet.ai/docs/skills-reference/start-the-day.md): Start the Day skill for Cadet — get a personalized daily briefing with weather, news, and tasks. - [Subagent](https://www.mycadet.ai/docs/skills-reference/subagent.md): Subagent skill for Cadet — spawns autonomous background agents that work independently on tasks. - [Tasks](https://www.mycadet.ai/docs/skills-reference/tasks.md): Tasks skill for Cadet — a two-layer task system with reusable templates and a prioritized work queue. - [Transcribe](https://www.mycadet.ai/docs/skills-reference/transcribe.md): Transcribe skill for Cadet — transcribes audio and video files using OpenAI Whisper or whisper.cpp. - [Watcher](https://www.mycadet.ai/docs/skills-reference/watcher.md): Watcher skill for Cadet — polls external services for changes and notifies you when something happens. - [Weather](https://www.mycadet.ai/docs/skills-reference/weather.md): Weather skill for Cadet — get current conditions and forecasts for any location. - [Cadet Terms of Service](https://www.mycadet.ai/docs/terms-of-use.md): Cadet's terms of service — the agreement governing your use of the assistant cloud and services. - [Trust & Security](https://www.mycadet.ai/docs/trust-security.md): Cadet trust and security — privacy, data handling, permissions, and deployment best practices. - [Privacy & Data](https://www.mycadet.ai/docs/trust-security/privacy-and-data.md): Cadet privacy and data — what stays local, what leaves your device, and what Cadet never does. - [Security Best Practices](https://www.mycadet.ai/docs/trust-security/security-best-practices.md): Security best practices for Cadet — sharing information, reviewing files, permissions, and credentials. - [The Permissions Model](https://www.mycadet.ai/docs/trust-security/the-permissions-model.md): Cadet's permissions model — risk tolerance tiers, sandbox boundary, trust rules, and the Allow/Deny permission prompt.