FAQ
Frequently asked questions about Cosmo — features, billing, integrations, and more.
General
What is Cosmo?
Cosmo is an AI-native collaboration workspace that connects teams with their tools through MCP integrations, LLM orchestration, and shared workspaces. It's not a chatbot — it's a persistent environment where your tools, your team, and AI work together continuously.
How is Cosmo different from ChatGPT or Claude.ai?
General AI assistants are stateless and personal — every conversation starts fresh, and you can't share context with teammates. Cosmo is persistent and collaborative:
- Memory — AI remembers your team's conventions, decisions, and context across every session
- Integrations — direct connections to your tools (Google Drive, Slack, Linear, etc.) via MCP
- Shared workspaces — your whole team works in the same AI context
- Artifacts — structured outputs (documents, reports) that persist in your workspace, not just in a chat log
What AI providers does Cosmo support?
Cosmo supports Anthropic (Claude 4 family — Opus, Sonnet, Haiku) and OpenAI (GPT-4o, o1, and others). You can switch between providers and models at any time. Enterprise plans support BYO (Bring Your Own) API keys.
What is MCP?
MCP (Model Context Protocol) is an open standard — developed by Anthropic — for giving AI structured access to external services. Cosmo uses MCP to connect to tools like Google Drive, Notion, Slack, Linear, and GitHub. Each integration provides named tools the AI can invoke directly, rather than requiring copy-paste.
Is Cosmo a desktop app or a web app?
Both. The primary experience is the desktop app (Mac and Windows), which provides a native, persistent environment. The web app handles account management, onboarding, and billing. A CLI is available for developers who prefer terminal workflows.
Is there an iOS or Android app?
Not currently. Cosmo is desktop-first. Mobile access is on the roadmap.
Can I use Cosmo for personal use?
Yes. The Free plan supports personal use: 1 member, 3 MCP connections, 1M tokens/day, no cloud sync. For personal use with cloud sync and more integrations, the Standard plan is $19/month.
Account & Organizations
How do I create an account?
Visit cosmo.dev or download the desktop app and sign up with your email. Google sign-in is also supported. New accounts trigger an onboarding flow that creates your first organization.
What is an organization?
An organization is the top-level tenant boundary in Cosmo. It owns billing, members, and MCP configurations. Everything you create — workspaces, artifacts, integrations — belongs to an organization.
Can I belong to multiple organizations?
Yes. You can be a member of multiple organizations — for example, your company's org and a personal org. Switch between them from the profile menu in the sidebar.
How do I invite teammates?
Go to Settings → Organization → Members and click Invite Member. Enter their email address and select a role (Admin, Member, or Viewer). They'll receive an invitation email with a link to accept and join.
What are the different roles?
| Role | Permissions |
|---|---|
| Owner | Full access; can manage billing, transfer ownership, delete the org |
| Admin | Manage members, integrations, and settings; cannot manage billing |
| Member | Create and use workspaces; cannot manage org settings |
| Viewer | Read-only access to workspaces they've been given access to |
How do I switch organizations?
Click your organization name or avatar in the sidebar. If you belong to multiple orgs, you'll see a switcher.
Can I delete my organization?
Yes, from Settings → Organization → Danger Zone. This permanently deletes all data — workspaces, artifacts, memory, chat history, and integrations. This action is irreversible.
Billing & Plans
What plans does Cosmo offer?
| Plan | Price | Members | MCP Connections | Tokens/Day |
|---|---|---|---|---|
| Free | $0 | 1 | 3 | 1M/user |
| Standard | $19/user/month | 1 | 10 | 2M/user |
| Premium | $39/user/month | Unlimited | 25 | 10M/user |
| Enterprise | Custom | Unlimited | Unlimited | 10M/user |
All paid plans include cloud sync, collaboration, and artifact versioning. Premium adds audit logs. Enterprise adds SSO, BYO API keys, and custom billing.
How does the free trial work?
Every new organization gets a 14-day free trial of the Standard plan with no credit card required. All Standard features are fully available during the trial. When the trial ends:
- If a payment method is on file, the org converts to a paid Standard subscription
- If no payment method is on file, the org reverts to the Free plan
You can downgrade to Free at any time during the trial from Settings → Billing.
What counts as a seat?
Every active organization member counts as one seat, regardless of role (Owner, Admin, Member, or Viewer). Pending invitations also count as seats — they reserve capacity before the invitee accepts. Revoking an invitation frees the seat immediately.
When am I charged for adding a new member?
For Standard and Premium plans, adding a member (or sending an invitation that reserves a seat) triggers a prorated charge for the remainder of the current billing period. For example, if you add a member halfway through the month, you'll be charged half the monthly seat rate immediately.
How do I upgrade or downgrade?
Go to Settings → Billing in the web app (not the desktop app). Upgrades are immediate with prorated billing. Downgrades take effect at the end of the current billing period — you keep access to the higher-tier plan until then.
What happens to my data if I downgrade to Free?
All your data is preserved — workspaces, artifacts, chat history, and MCP configs. Feature access adjusts to the Free plan limits (1 member, 3 MCP connections, 1M tokens/day, no cloud sync). Nothing is deleted. If you re-upgrade later, everything is exactly where you left it.
How do AI tokens work?
Token limits are per user, per day, resetting at midnight UTC. Each member has their own daily budget — heavy usage by one person doesn't affect others' limits.
A rough sense of scale:
- Short back-and-forth message: ~1,000–5,000 tokens
- Drafting a long document: ~10,000–50,000 tokens
- Deep research session with large context: 100,000–500,000 tokens
On the Free plan (1M/day), you can do meaningful work but may hit limits in intensive sessions. On Standard (2M/day) or above, limits are rarely a concern for typical usage.
What payment methods are accepted?
Cosmo accepts major credit and debit cards via Stripe. In India, payments are processed via Razorpay and support UPI, netbanking, and cards.
How do I view or download invoices?
Go to Settings → Billing in the web app and click Billing portal. This opens the Stripe customer portal where you can view all past invoices and download PDFs.
Why does the desktop app redirect to the web app for billing?
Billing management (upgrades, downgrades, payment methods, invoices) is handled in the browser for security and compliance reasons. Sensitive payment flows should be in a browser context with full certificate validation. The desktop app's sidebar shows your current plan and links to the web app for management.
Enterprise
How is Enterprise billing managed?
Enterprise plans are managed directly by the Cosmo team — they are not processed through Stripe. Seat counts, billing terms, and plan changes are agreed upon contractually and applied by Cosmo operations. Your Billing tab shows the current seat allocation and usage.
How do I request more seats or plan changes?
Email support@getcosmo.app with your organization name, the requested change, and any relevant context (new team joining, contract reference, etc.). Changes are typically applied within one business day and reflected in the Billing tab immediately.
What happens when we hit the seat limit?
New member invitations are blocked when your purchased seat count is reached. Existing members are unaffected. To invite new people:
- Remove a member or revoke a pending invitation to free a seat, or
- Contact support@getcosmo.app to increase your seat allocation
Can Enterprise use their own AI API keys?
Yes. BYO API keys (Bring Your Own Key) is an Enterprise-only feature. You can supply your own Anthropic or OpenAI API keys so AI usage is billed directly to your accounts rather than against Cosmo's token quotas. Contact sales@getcosmo.app to configure this.
Does Enterprise support SSO?
Yes. Enterprise plans support SAML-based SSO. Contact sales@getcosmo.app to get SSO configured for your organization.
Workspaces & Artifacts
How many workspaces can I create?
There's no hard limit on workspaces for paid plans. Free plans are limited to a small number. Practically, we recommend keeping workspaces focused — one per initiative or project — rather than creating dozens.
Can I share a workspace with specific teammates?
Yes. Workspaces belong to a team. Members of that team can access all workspaces in it. If you want a workspace only visible to a subset of your org, create a team with just those members and create the workspace there.
Can artifacts be exported?
Yes. Artifacts can be exported from the Hub panel. Export formats vary by artifact type (Markdown, HTML, PDF for document artifacts).
Are artifacts versioned?
Yes. Every modification to an artifact is tracked. You can review the version history and restore a previous version from the Hub panel.
What's the difference between an artifact and a chat response?
A chat response is ephemeral — it lives in the conversation thread. An artifact is a named, persistent document in your workspace. Artifacts appear in the Hub, have version history, are searchable, and can be shared with your team. AI decides when to produce an artifact based on the complexity and nature of the output, but you can always ask explicitly: "Make this an artifact".
Integrations (MCP)
What integrations are available?
Cosmo has integrations in these categories:
- Productivity: Google Drive, Notion, ClickUp, Atlassian (Jira/Confluence), Asana, Microsoft 365
- Communication: Slack (coming soon), Microsoft Teams (via M365)
- Support: Pylon
- More are added regularly
See the Available Integrations page for the full list with details.
How many integrations can I connect?
This depends on your plan: Free (3), Standard (10), Premium (25), Enterprise (unlimited).
Can I connect the same integration multiple times?
Yes. Most integrations support multiple instances — for example, connecting two different Google Drive accounts, or two Slack workspaces. Each instance is configured independently.
My OAuth integration expired — what happens?
If an OAuth token expires (typically after 60–90 days depending on the service), the integration shows as disconnected. Go to Settings → Integrations, click the integration, and click Reconnect to re-authorize. Your configuration is preserved — you just need to re-authenticate.
Can integrations see all my data in the connected service?
Integrations request the minimum permissions needed for their tools. For example, Google Drive integration requests read/write access to files — it doesn't access your Gmail or Calendar. You can review the exact permissions requested during the OAuth flow.
Is an API key stored securely?
Yes. API keys (for integrations that use them instead of OAuth) are stored encrypted at rest. They are never exposed in logs or returned in API responses.
AI & Memory
How does AI memory work?
Memory is stored as plain files in your workspace's cloud storage (not in a vector database). When you start a conversation, relevant memory files are loaded as context. AI can read, update, and create memory files during conversations. You can also read and edit them directly from the Hub.
Can I view and edit my memory files?
Yes. In the Hub panel, navigate to your workspace and look for the memory section. Memory files are Markdown — you can read and edit them directly.
How do I tell AI to remember something?
Just say it: "Remember that our users are called 'members', not 'customers'." AI will update the appropriate memory file. You can also ask: "What do you currently remember about this workspace?"
Can I delete memory?
Yes. Navigate to the memory files in the Hub and delete or edit them. AI will stop referencing deleted content. You can also ask: "Forget what you know about X" and AI will clear the relevant memory entry.
Does AI remember things across sessions?
Yes — through memory files. If AI learned something during a session and stored it in memory, that context is available in all future sessions for that workspace (or team/org, depending on the memory level). The session transcript itself isn't reloaded, but learned context persists.
Can I switch AI models mid-conversation?
Yes. Use the model selector in the chat panel. The new model takes over from your next message — the conversation history is carried over (subject to the new model's context window limits).
Desktop App
Which operating systems are supported?
macOS (Intel and Apple Silicon, macOS 11+) and Windows (Windows 10 and 11, 64-bit). Linux support is planned.
How do I update the desktop app?
The app checks for updates automatically on launch. When an update is available, you'll see a notification in the sidebar. Click Update to download and install. The update applies on the next launch. You can also check manually in Settings → About.
Does the desktop app work offline?
The core chat and AI features require an internet connection (for LLM API calls). MCP integrations also require connectivity to the external services. Viewing previously-loaded artifacts and chat history is available offline.
How do I clear the app cache?
Go to Settings → About → Clear Cache. This clears the local cache but does not delete your cloud data (workspaces, artifacts, memory).
Can I run multiple accounts in the desktop app?
Not simultaneously. You can sign out and sign back in with a different account, or use multiple organizations under the same account (recommended for most use cases).
Security & Privacy
Where is my data stored?
Workspace data (artifacts, memory files) is stored in Cloudflare R2 (cloud object storage). Metadata (workspace names, member records, billing info) is stored in PostgreSQL. All storage is encrypted at rest and in transit.
Can Cosmo employees access my data?
Cosmo employees do not access customer data except as strictly required for support, operations, or legal compliance. Access is logged and audited. Enterprise plans can request data access audit logs.
How are MCP integration credentials stored?
OAuth tokens and API keys are stored encrypted. They are tenant-scoped — credentials for one organization are never accessible to another.
Does Cosmo use my data to train AI models?
Cosmo does not use your conversations or workspace data to train AI models. All AI processing is done through the respective provider APIs (Anthropic, OpenAI) under their standard terms. On Enterprise plans with BYO keys, all AI calls go directly to your accounts under your own agreements.
Support
How do I get help?
- Documentation: docs.getcosmo.app
- Email support: support@getcosmo.app
- Enterprise: Your dedicated account manager
How do I report a bug?
Email support@getcosmo.app with a description of what happened, what you expected to happen, and steps to reproduce. Include your OS version, app version (from Settings → About), and any error messages you saw.
I found a security vulnerability — what should I do?
Please disclose security vulnerabilities responsibly to security@getcosmo.app. Do not open a public issue. We aim to respond within 24 hours and address critical issues within 72 hours.