# AGENTS
Source: https://docs.dimension.dev/AGENTS



> **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project.
> For Mintlify product knowledge (components, configuration, writing standards),
> install the Mintlify skill: `npx skills add https://mintlify.com/docs`

# Documentation project instructions

## About this project

* This is a documentation site built on [Mintlify](https://mintlify.com)
* Pages are MDX files with YAML frontmatter
* Configuration lives in `docs.json`
* Run `mint dev` to preview locally
* Run `mint broken-links` to check links

## Terminology

## Style preferences

* Use active voice and second person ("you")
* Keep sentences concise — one idea per sentence
* Use sentence case for headings
* Bold for UI elements: Click **Settings**
* Code formatting for file names, commands, paths, and code references

## Content boundaries


# Artifacts
Source: https://docs.dimension.dev/artifacts

Generate presentations, spreadsheets, documents, and PDFs directly from chat.

Artifacts are rich documents that Dimension creates during chat. Ask for what you need, and Dimension generates it — ready to export, edit, or share.

## Types

| Type              | Export format |
| ----------------- | ------------- |
| **Presentations** | PPTX, PDF     |
| **Spreadsheets**  | XLSX          |
| **Documents**     | Rich text     |
| **PDF Documents** | PDF           |

## Creating artifacts

<Steps>
  <Step title="Ask Dimension">
    Describe what you need in chat:

    * "Create a presentation about our Q4 results"
    * "Build a spreadsheet comparing competitor pricing"
    * "Write a project brief for the mobile app redesign"
    * "Generate a PDF report of our quarterly metrics"
  </Step>

  <Step title="Review the outline">
    For presentations and PDFs, Dimension proposes an outline first for your approval before generating the full content. You can request changes to the outline before proceeding.

    <Tip>Take a moment to review the outline — it's much easier to restructure content at this stage than after the full artifact is generated.</Tip>
  </Step>

  <Step title="Get your result">
    Dimension generates the full artifact. You can preview it directly in chat and export it in the supported format.
  </Step>

  <Step title="Iterate">
    Ask Dimension to revise any artifact after it's been created:

    * "Change slide 3 to focus more on revenue growth"
    * "Add a new sheet with monthly totals"
    * "Rewrite the introduction to be more concise"
  </Step>
</Steps>

## Sharing

You can share any artifact via a public link. Anyone with the link can view the full content without needing a Dimension account.

<Note>You can also share an entire conversation's artifacts at once via a shared thread link.</Note>

## Library

All artifacts are saved to your **Library** automatically. You can browse, search, favorite, and manage your artifacts from the Library page.


# Chat
Source: https://docs.dimension.dev/chat

Chat with Dimension to ask questions, take actions, and get things done across your tools.

Chat is the main way you interact with Dimension. Ask questions, give instructions, and Dimension takes action across your connected tools.

## What you can do

### Ask questions

* "What meetings do I have today?"
* "What's the status of the authentication issue in Linear?"
* "Find the design doc for the new onboarding flow"

### Take actions

* "Send an email to Sarah about the project update"
* "Create a Linear issue for the login bug"
* "Post a message in #engineering on Slack"

### Create content

* "Draft a presentation about our Q4 results"
* "Create a spreadsheet comparing our pricing tiers"
* "Write a project brief for the mobile app redesign"

### Multi-step tasks

* "Go through my unread emails and create Linear issues for any action items"
* "Check my calendar for tomorrow and prepare briefing notes for each meeting"
* "Analyze our GitHub PRs from last week and write a summary for the team"

Dimension automatically figures out the best way to handle your request — simple tasks run directly, complex ones get broken into steps.

## Approvals

For sensitive actions like sending emails, creating issues, or posting messages, Dimension pauses and asks for your approval before proceeding.

When this happens, you can:

* **Accept** — run the action as proposed
* **Reject** — cancel it
* **Edit** — modify the details before approving (e.g., tweak an email draft)
* **Respond** — give Dimension more context to adjust its approach

You can configure which actions need approval in your settings, or turn off approvals entirely for tools you trust.

<Tip>You can also ask Dimension in chat to adjust your approval preferences — e.g., "stop asking for approval before sending Slack messages."</Tip>

## Execution modes

<Tabs>
  <Tab title="Standard">
    Fast and lightweight. Best for simple questions, quick lookups, and straightforward actions like sending an email or creating an issue.
  </Tab>

  <Tab title="Pro">
    Deeper reasoning and multi-step planning. Best for complex tasks that span multiple tools — like triaging a bug across Sentry, Linear, and Slack, or analyzing a week's worth of GitHub activity.
  </Tab>
</Tabs>

You can switch between modes at any time using the selector in the chat input.

## Voice input

Click the microphone button in the chat input to dictate your message instead of typing.

## File attachments

You can drag and drop files into chat or use the attachment button. Attach a file and ask Dimension to summarize it, analyze it, or use it as context for a task.

<Note>
  **Supported file formats:** images, PDF, DOCX, TXT, XLSX, CSV, PPTX, audio, and video.
</Note>

## Threads

Each conversation is a thread. You can search past threads with **Cmd+K**, rename them, or delete them. Dimension remembers the full context of each thread.

<Note>Have more questions? Check the [FAQ](/faq#chat) for detailed answers about chat, approvals, voice input, and more.</Note>


# Custom MCP integrations
Source: https://docs.dimension.dev/custom-mcp

Connect any tool to Dimension using the Model Context Protocol.

If you use a tool that Dimension doesn't natively support, you can connect it yourself using a custom MCP (Model Context Protocol) server.

<Note>Before setting up a custom integration, check the [Integrations](/integrations) page — Dimension already has native support for tools like Linear, Notion, GitHub, Sentry, and Stripe, which offer a smoother experience out of the box.</Note>

## Adding a custom integration

<Steps>
  <Step title="Open Integrations">
    Navigate to the **Integrations** page in the app.
  </Step>

  <Step title="Create a new integration">
    Click **New Integration** and provide:

    * **Name** — What you want to call this integration
    * **Description** — What the integration does (this helps Dimension understand when to use it)
  </Step>

  <Step title="Authenticate">
    Provide the server URL and authenticate:

    <CodeGroup>
      ```bash Streamable HTTP theme={null}
      https://mcp.example.com/mcp
      ```

      ```bash SSE (Legacy) theme={null}
      https://mcp.example.com/sse
      ```
    </CodeGroup>

    If the server supports OAuth, you'll be taken through an OAuth flow. Otherwise, provide an API key.
  </Step>

  <Step title="Confirm capabilities">
    Dimension auto-discovers the server's capabilities when you enter the URL. Review the available tools and confirm the integration.
  </Step>
</Steps>

<Warning>Only connect MCP servers you trust. A custom integration can read and act on your data just like a native one — make sure you understand what the server has access to.</Warning>

## What you can do with it

Once connected, Dimension can use your custom integration just like any built-in one — reading data, taking actions, and using it in chat, workflows, and skills.


# FAQ
Source: https://docs.dimension.dev/faq

Answers to frequently asked questions about Dimension AI.

## Account & setup

<AccordionGroup>
  <Accordion title="How do I create an account?">
    Go to [dimension.dev](https://dimension.dev) and sign up with Google or SSO.
  </Accordion>

  <Accordion title="What platforms is Dimension available on?">
    Dimension is available on the **Web** today, with native apps on the way.

    * **Web** — [dimension.dev](https://dimension.dev), no install needed.
    * **Mac & Windows** — Coming soon.
    * **iOS** — Coming soon.
  </Accordion>

  <Accordion title="How do I change my username?">
    Go to **Settings > User > Username** and update your name. It saves automatically when you click out of the field.
  </Accordion>

  <Accordion title="How do I set my background/bio?">
    Go to **Settings > User > Background** and describe yourself. Dimension uses this to personalize responses — for example, the Evening Recap can recommend restaurants in your city if it knows where you live.
  </Accordion>

  <Accordion title="Can I change my email address?">
    Your email is tied to your sign-in method (Google or SSO) and cannot be changed from Settings.
  </Accordion>

  <Accordion title="How do I log out?">
    Go to **Settings > User** and click **Logout**.
  </Accordion>

  <Accordion title="How do I delete my account?">
    Go to **Settings > User** and click **Delete Account**. This permanently removes all your data, integrations, conversations, and cancels any active subscription. This action is irreversible.
  </Accordion>
</AccordionGroup>

## Plans & billing

<AccordionGroup>
  <Accordion title="What plans are available?">
    | Plan      | Price        | Credits           |
    | --------- | ------------ | ----------------- |
    | **Free**  | \$0/mo       | 50,000            |
    | **Trial** | \$4 one-time | 200,000 (30 days) |
    | **Plus**  | \$49/mo      | 500,000           |
    | **Pro**   | \$199/mo     | 2,000,000         |
    | **Max**   | \$499/mo     | 5,000,000         |

    All paid plans include unlimited integrations, workflows, and skills.
  </Accordion>

  <Accordion title="How do I check my current plan and usage?">
    Go to **Settings > Billing** to see your current plan and a credit usage progress bar.
  </Accordion>

  <Accordion title="How do I upgrade or change my plan?">
    Go to **Settings > Plan** to view available plans and switch.
  </Accordion>

  <Accordion title="How do I cancel my subscription?">
    Go to **Settings > Billing** and click **Cancel**.
  </Accordion>

  <Accordion title="Can I subscribe via the iOS app?">
    Not yet. In-app purchases will be available once the iOS app launches. Pricing will remain the same across all platforms (Plus $49, Pro $199, Max \$499).
  </Accordion>

  <Accordion title="How does credit-based billing work?">
    Each action Dimension takes consumes credits. Your plan includes a monthly credit allotment that resets each billing cycle.
  </Accordion>
</AccordionGroup>

## Integrations

<AccordionGroup>
  <Accordion title="What integrations does Dimension support?">
    Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Slides, Slack, GitHub, Linear, Notion, Vercel, Railway, Sentry, Stripe, Airtable, Dropbox, and Granola.

    You can also interact with Dimension via **iMessage** and **Slack Bot**.

    More integrations are coming soon, including Figma, HubSpot, PostHog, Intercom, and others.
  </Accordion>

  <Accordion title="How do I connect an integration?">
    Go to the **Integrations** page and click on the integration you want to connect. For Google Workspace, one connection unlocks Gmail, Calendar, Drive, Docs, Sheets, and Slides.
  </Accordion>

  <Accordion title="What does indexing mean?">
    Some integrations (Gmail, Google Drive, Slack, Linear, Notion, GitHub, Airtable, Dropbox, etc.) support indexing — Dimension processes your data in the background to make it searchable across all your tools at once. You can see indexing progress on each integration's detail page.
  </Accordion>

  <Accordion title="How do I disconnect an integration?">
    Go to the **Integrations** page, select the integration, and disconnect it. All associated data is permanently deleted.
  </Accordion>

  <Accordion title="Can I connect tools that aren't natively supported?">
    Yes. You can connect any MCP-compatible tool. Go to **Integrations**, click **New Integration**, provide a name, description, and the MCP server URL (Streamable HTTP or SSE). If the server supports OAuth, you'll go through an OAuth flow; otherwise, provide an API key. See [Custom MCP integrations](/custom-mcp) for details.
  </Accordion>

  <Accordion title="Can I use Dimension via iMessage or Slack?">
    Yes. Connect **iMessage** (requires phone number verification) or the **Slack Bot** integration, and you can message Dimension directly from those apps.
  </Accordion>

  <Accordion title="What can each integration do?">
    Each integration shows capability tags on the Integrations page. The four capability types are:

    * **Read** — Pull in your data (emails, issues, messages, files, etc.)
    * **Act** — Take actions on your behalf (send emails, create issues, post messages)
    * **Search** — Your data is indexed and searchable across all tools
    * **Trigger** — Unlock [workflow triggers](/workflows) (e.g., "when a new email arrives")
  </Accordion>
</AccordionGroup>

## Chat

<AccordionGroup>
  <Accordion title="What can I do in chat?">
    Ask questions across your tools, take actions (send emails, create issues, post messages), create artifacts (presentations, spreadsheets, documents, PDFs), and handle complex multi-step tasks that span multiple tools.
  </Accordion>

  <Accordion title="What is the approval system?">
    For sensitive actions like sending emails, creating issues, or posting messages, Dimension pauses and asks for your approval. You can:

    * **Accept** — run the action as proposed
    * **Reject** — cancel it
    * **Edit** — modify the details before approving
    * **Respond** — give Dimension more context to adjust its approach
  </Accordion>

  <Accordion title="How do I turn off approvals?">
    Go to **Settings > User** and enable the **Auto Approve** toggle. This makes all actions execute without asking first. You can also ask Dimension in chat to adjust your approval preferences.
  </Accordion>

  <Accordion title="Can I use voice input?">
    Yes. Click the microphone button in the chat input to dictate your message. Voice is transcribed using Whisper. Available on web and desktop.
  </Accordion>

  <Accordion title="What file types can I attach?">
    You can attach images (PNG, JPEG, WebP), PDF, DOCX, TXT, XLSX, CSV, PPTX, audio (AAC, FLAC, MP3, M4A, WAV), and video (MP4, WebM, MOV). Drag and drop files into chat or use the attachment button.
  </Accordion>

  <Accordion title="How do I search past conversations?">
    Press **Cmd+K** (Mac) or **Ctrl+K** (Windows) to search your threads by keyword.
  </Accordion>

  <Accordion title="How do I start a new chat?">
    Press **Shift+Cmd+O** (Mac) or **Shift+Ctrl+O** (Windows), or click the new chat button in the sidebar.
  </Accordion>

  <Accordion title="Does Dimension remember previous conversations?">
    Dimension remembers everything within a thread. Across threads, it can search your past conversations and connected tools to find relevant context.
  </Accordion>

  <Accordion title="Can Dimension change my settings?">
    Yes. You can ask Dimension to change settings directly in chat — things like notification preferences, approval settings, and proactive features.
  </Accordion>
</AccordionGroup>

## Artifacts

<AccordionGroup>
  <Accordion title="What types of artifacts can Dimension create?">
    Presentations, Spreadsheets, Documents, and PDF Documents.
  </Accordion>

  <Accordion title="What export formats are supported?">
    | Artifact type     | Export formats                    |
    | ----------------- | --------------------------------- |
    | **Presentations** | PPTX, PDF, Google Slides, Dropbox |
    | **Spreadsheets**  | XLSX, Google Sheets, Dropbox      |
    | **Documents**     | PDF, DOCX, Google Docs, Dropbox   |
    | **PDF Documents** | PDF                               |
  </Accordion>

  <Accordion title="Can I edit an artifact after it's created?">
    Yes. Ask Dimension to revise it in the same thread — e.g., "Change slide 3 to focus on revenue growth" or "Add a new sheet with monthly totals."
  </Accordion>

  <Accordion title="Can I share an artifact?">
    Yes. You can share any artifact via a public link. Anyone with the link can view it without a Dimension account. You can also share an entire thread's artifacts at once via a shared thread link.
  </Accordion>

  <Accordion title="Where are my artifacts saved?">
    All artifacts are saved to your **Library** automatically, where you can browse, search, and favorite them.
  </Accordion>
</AccordionGroup>

## Workflows

<AccordionGroup>
  <Accordion title="How do I create a workflow?">
    Go to the **Workflows** page and create one, or ask Dimension in chat — e.g., "Create a workflow that summarizes my emails every morning."
  </Accordion>

  <Accordion title="What are the workflow types?">
    * **Scheduled** — Run at set times (daily, weekdays, weekly, or custom cron schedule)
    * **Triggered** — Run automatically when an event happens in a connected tool
  </Accordion>

  <Accordion title="What triggers are available?">
    | Integration         | Triggers                                                                     |
    | ------------------- | ---------------------------------------------------------------------------- |
    | **Gmail**           | New email (filterable by label)                                              |
    | **Slack**           | New DM, new message in a channel                                             |
    | **Google Calendar** | Before or after a calendar event                                             |
    | **Vercel**          | Deployment succeeded/failed (filterable by project and environment)          |
    | **Linear**          | Cycle started/ended, issue created (filterable by team)                      |
    | **GitHub**          | PR opened (filterable by repo)                                               |
    | **Airtable**        | New records added (filterable by base and table)                             |
    | **Google Sheets**   | New rows added (filterable by spreadsheet and sheet)                         |
    | **Stripe**          | Customer created, invoice paid/failed, payment succeeded, checkout completed |
  </Accordion>

  <Accordion title="How do approvals work in workflows?">
    Each workflow has an approval toggle. When set to **Ask for approval**, Dimension pauses before taking sensitive actions. When set to **Auto approve**, the workflow runs fully automatically without asking.
  </Accordion>

  <Accordion title="How do I get notified when a workflow finishes?">
    Results are delivered via your preferred communication channel (Gmail, Slack, iMessage, or Mobile Notifications). Change this in **Settings > User > Preferred Mode of Communication**. You can also specify a destination in the workflow prompt — e.g., "...and post the summary in #general on Slack."
  </Accordion>

  <Accordion title="What is the Workflow Marketplace?">
    A library of pre-built workflows organized by role (Engineering, Product, Marketing, Sales, etc.). You can install and customize them, or publish your own workflows for others to use.
  </Accordion>

  <Accordion title="Can I share a workflow without publishing it?">
    Yes. You can share a workflow via a unique link without submitting it to the public Marketplace.
  </Accordion>
</AccordionGroup>

## Skills

<AccordionGroup>
  <Accordion title="What are skills?">
    Skills are reusable instructions that teach Dimension how to handle tasks your way. They can be simple rules (e.g., "always sign off emails with just my first name") or deep knowledge learned by researching your data. Unlike [workflows](/workflows), skills are used on-demand during chat.
  </Accordion>

  <Accordion title="How do skills learn?">
    When you create a skill with a learning prompt (e.g., "Learn how our fund evaluates investments from our Google Drive memos"), Dimension researches your data, builds knowledge, and saves a summary. After each run, use the **Learn** section to give feedback and refine the skill's behavior over time.
  </Accordion>

  <Accordion title="How does Dimension know when to use a skill?">
    Dimension automatically selects the most relevant skill based on your request. You can also ask for a specific skill directly in chat.
  </Accordion>

  <Accordion title="Can I install pre-built skills?">
    Yes. Browse the **Skills Marketplace** for pre-built skills organized by role. You can install them directly, or install and trigger learning immediately.
  </Accordion>

  <Accordion title="Can I publish my own skills?">
    Yes. You can submit a skill for review. Once approved, it appears in the Marketplace for others to install.
  </Accordion>
</AccordionGroup>

## Proactive features

<AccordionGroup>
  <Accordion title="What are background agents?">
    Automated features that work behind the scenes without you having to ask. There are six, and you can toggle each one individually in **Settings > Preference > Background Agents**:

    * **Action Items** — Detects urgent tasks from your tools
    * **Evening Recap** — End-of-day summary
    * **Morning Briefing** — Start-of-day overview
    * **Email Tagging** — Auto-categorizes your Gmail
    * **Email Auto-Drafting** — Generates draft replies
    * **Meeting Prep** — Briefing notes before meetings
  </Accordion>

  <Accordion title="When does the Morning Briefing arrive?">
    Dimension prepares it around 5 AM your local time and notifies you around 8 AM. It appears on your home screen when you open the app.
  </Accordion>

  <Accordion title="What's in the Morning Briefing?">
    Your schedule for the day, weather, emails and Slack messages needing attention, GitHub PR activity, and Linear status. It also includes suggested replies for emails and Slack messages you can send directly.
  </Accordion>

  <Accordion title="What is Catch Up?">
    Part of the Morning Briefing with three tabs:

    * **Slack** — Unread DMs with suggested replies
    * **Gmail** — Unread emails with draft replies
    * **Meetings** — Upcoming meetings with prep notes

    Each tab shows a dot indicator when there are items to review.
  </Accordion>

  <Accordion title="How does AI Inbox / Email Tagging work?">
    Dimension automatically labels your emails in Gmail with 10 categories: **Urgent**, **Action Needed**, **Follow Up**, **Awaiting Reply**, **Meeting**, **FYI**, **Done**, **Payment**, **Newsletter**, and **Marketing**. Labels appear numbered in Gmail (e.g., "1: urgent") for easy ordering. When you reply to an email, it gets re-tagged automatically.
  </Accordion>

  <Accordion title="How do I turn off email tagging?">
    Go to **Settings > Preference > Background Agents** and toggle off **Email Tagging**.
  </Accordion>

  <Accordion title="How do I turn off auto-drafted replies?">
    Go to **Settings > Preference > Background Agents** and toggle off **Email Auto-Drafting**.
  </Accordion>

  <Accordion title="How do I turn off morning briefings?">
    Go to **Settings > Preference > Background Agents** and toggle off **Morning Briefing**.
  </Accordion>

  <Accordion title="When does Meeting Prep run?">
    Dimension generates prep notes when your calendar syncs and refreshes them approximately 20 minutes before each meeting.
  </Accordion>

  <Accordion title="When does the Evening Recap arrive?">
    Around 7 PM your local time. It summarizes your day — meetings, emails, code changes, and tickets. If Dimension knows your personal context (partner, hobbies, city from your **Background**), it may include personalized recommendations like nearby restaurants or events.
  </Accordion>

  <Accordion title="What triggers Action Items?">
    New calendar invites, incoming emails, GitHub PR review requests, Linear issue assignments, priority escalations, and mentions in Linear comments.
  </Accordion>

  <Accordion title="How does Dimension know my writing tone?">
    You can teach Dimension your tone by creating a [skill](/skills) that describes how you write. You can also set your background in **Settings > User > Background** to give Dimension more context about you.
  </Accordion>

  <Accordion title="What happens when I assign a todo to Dimension?">
    Dimension creates a background thread and works through the task on its own. You'll get notified when it's done, or if it needs your input to continue.
  </Accordion>
</AccordionGroup>

## Notifications

<AccordionGroup>
  <Accordion title="How do I change how Dimension contacts me?">
    Go to **Settings > User > Preferred Mode of Communication** and choose **Gmail**, **Slack**, **iMessage**, or **Mobile Notifications**.
  </Accordion>

  <Accordion title="Why can't I select Slack or iMessage as my communication channel?">
    You need to connect the **Slack Bot** integration first (for Slack) or verify your phone number via the **iMessage** integration (for iMessage). **Mobile Notifications** will be available once the iOS app launches.
  </Accordion>

  <Accordion title="Can I get push notifications on my phone?">
    Not yet. Push notifications will be available once the iOS app launches. In the meantime, you can use **Gmail**, **Slack**, or **iMessage** as your preferred communication channel.
  </Accordion>

  <Accordion title="How do I control notification sounds?">
    Go to **Settings > Preference > Sound** and choose **Always play sound**, **Only when tab is not focused**, or **Mute**.
  </Accordion>

  <Accordion title="How do I stop Dimension from sending me emails?">
    Go to **Settings > User > Preferred Mode of Communication** and switch to Slack, iMessage, or Mobile Notifications instead of Gmail.
  </Accordion>
</AccordionGroup>

## Privacy & security

<AccordionGroup>
  <Accordion title="Does Dimension train AI models on my data?">
    No. Dimension never trains AI models on your data, never sells your information, and never shares it with third parties.
  </Accordion>

  <Accordion title="What happens when I disconnect an integration?">
    All data associated with that integration is permanently and completely deleted, including indexed content.
  </Accordion>

  <Accordion title="What happens when I delete my account?">
    Dimension cancels your subscription, removes all billing records, disconnects all integrations, deletes all indexed data, conversations, and user records. This is permanent and irreversible.
  </Accordion>

  <Accordion title="What compliance certifications does Dimension have?">
    Dimension is **CASA Tier 2** certified and has been **third-party penetration tested** by independent security researchers. **SOC 2** and **GDPR** certifications are underway.
  </Accordion>

  <Accordion title="Does Dimension store my payment information?">
    No. Payments are handled entirely by **Stripe**. Dimension never stores payment information.
  </Accordion>

  <Accordion title="Is my data encrypted?">
    Yes. All data is protected with enterprise-grade encryption in transit and at rest. OAuth tokens are stored securely and are not accessible to Dimension personnel.
  </Accordion>
</AccordionGroup>

## Email preferences

<AccordionGroup>
  <Accordion title="How do I stop receiving marketing emails from Dimension?">
    Go to **Settings > Preference > Email Preferences** and toggle off **Promotional Emails**.
  </Accordion>

  <Accordion title="How do I stop receiving product update emails?">
    Go to **Settings > Preference > Email Preferences** and toggle off **Product Updates**.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Why is my data not searchable yet?">
    Indexing happens in the background and can take time depending on the volume of data. Check progress on the integration's detail page on the **Integrations** page.
  </Accordion>

  <Accordion title="Why isn't Dimension using my connected tool?">
    Make sure the integration is connected and active on the **Integrations** page. For workflows, ensure the relevant integration is selected in the workflow's integrations list.
  </Accordion>

  <Accordion title="What happens if I'm inactive for a while?">
    After 14 days of inactivity, Dimension sends a warning email with a 3-day grace period. If you don't return, your workflows are paused. They automatically resume when you come back.
  </Accordion>

  <Accordion title="How do I contact support?">
    Email [support@dimension.dev](mailto:support@dimension.dev), or ask Dimension in chat to file a support ticket for you.
  </Accordion>
</AccordionGroup>


# What is Dimension AI?
Source: https://docs.dimension.dev/index

Dimension is an AI-powered personal assistant that connects to your work tools and proactively manages your day.

Dimension is an AI assistant that connects to the tools you already use — Gmail, Slack, Linear, Notion, GitHub, Google Calendar, and more — to handle tasks, surface what matters, and keep you on top of your work.

<Note>Dimension is available on the web today, with Mac, Windows, and iOS apps coming soon. [Get started in under 5 minutes →](/quickstart)</Note>

## What Dimension does

<CardGroup>
  <Card title="Chat" icon="message-bot" href="/chat">
    Chat with Dimension to take actions across your tools — send emails, create issues, schedule meetings, and more.
  </Card>

  <Card title="Workflows" icon="arrow-progress" href="/workflows">
    Automate recurring tasks with scheduled or event-triggered workflows that run in the background.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/skills">
    Teach Dimension how to handle specific tasks your way, and it gets better over time.
  </Card>

  <Card title="Artifacts" icon="file-lines" href="/artifacts">
    Generate presentations, spreadsheets, documents, and PDFs directly from chat.
  </Card>
</CardGroup>

## Productivity features

<CardGroup>
  <Card title="Morning Briefing" icon="sun" href="/proactive-features#morning-briefing">
    Start each day with a summary of what needs your attention across Slack, Gmail, and your calendar.
  </Card>

  <Card title="Todos" icon="list-check" href="/proactive-features#todos">
    Task lists that Dimension can help you work through and complete.
  </Card>

  <Card title="Meeting Prep" icon="calendar-check" href="/proactive-features#meeting-prep">
    Get briefings with context pulled from your tools before every meeting.
  </Card>

  <Card title="Catch Up" icon="lightbulb" href="/proactive-features#catch-up">
    Get suggested replies and actions based on your incoming messages.
  </Card>

  <Card title="AI Inbox" icon="inbox" href="/proactive-features#ai-inbox">
    Your emails are automatically tagged and organized, with draft responses written in your tone.
  </Card>

  <Card title="Meeting Notes" icon="microphone" href="/proactive-features#meeting-notes">
    AI note-taker that captures your meetings and gets the action items done. *Coming soon.*
  </Card>
</CardGroup>

## Extend Dimension

<CardGroup>
  <Card title="See all integrations" icon="plug" href="/integrations">
    Browse all supported tools and their capabilities.
  </Card>

  <Card title="Custom MCP integrations" icon="puzzle-piece" href="/custom-mcp">
    Connect any tool to Dimension using the Model Context Protocol.
  </Card>
</CardGroup>

## Get started

<Card title="Quickstart" icon="rocket" href="/quickstart">
  Create your account, connect your first integration, and start chatting with Dimension in under 5 minutes.
</Card>


# Integrations
Source: https://docs.dimension.dev/integrations

Connect your favorite tools and let Dimension work across all of them.

Integrations connect Dimension to the tools you use every day. Once connected, Dimension can read your data, take actions on your behalf, and search across everything at once.

You can browse and connect integrations from the **Integrations** page in the app.

<Tip>Connecting **Google Workspace** unlocks Gmail, Calendar, Drive, Docs, Sheets, and Slides — all in one step. It's the best place to start.</Tip>

## What happens when you connect a tool

When you connect an integration, Dimension gets three capabilities:

* **Read** — Pull in your emails, calendar events, issues, messages, files, and more
* **Act** — Send emails, create issues, post messages, schedule events, and take other actions
* **Search** — Dimension indexes your data in the background so it can search across all your tools when answering questions
* **Trigger** — Some integrations unlock [workflow triggers](/workflows#triggered-workflows) — for example, connecting Gmail lets you trigger a workflow when a new email arrives, and connecting GitHub lets you trigger one when a PR is opened

Each integration shows its specific capabilities as tags so you know exactly what Dimension can do with it.

## Indexing

Dimension can index data from your connected tools. Your data is securely stored in Dimension's encrypted databases, making it searchable across every integration at once.

Ask "what did the team discuss about the redesign?" and Dimension searches your Slack messages, Linear issues, Notion pages, and Google Docs to find the answer.

Supported tools include Gmail, Google Drive, Docs, Sheets, Slack, Linear, Notion, GitHub, Airtable, Dropbox, and more. Track indexing progress on each integration's detail page.

If you disconnect an integration, all indexed data is permanently deleted. See [Security](/security) for details.

## Bundled integrations

Some integrations are bundled together for convenience:

* **Google Workspace** — Connecting Google unlocks Gmail, Calendar, Drive, Docs, Sheets, and Slides. You can choose which services to enable.
* **Notion** — You can separately enable capabilities (create and edit pages) and indexing (search across your Notion workspace).

## Custom integrations

If you use a tool that isn't natively supported, you can connect it via MCP.

<Info>See [Custom MCP integrations](/custom-mcp) for a step-by-step guide on connecting any tool using the Model Context Protocol.</Info>

## Security

Your data is encrypted and stored securely. Dimension never trains AI models on your data or shares it with third parties. See [Security](/security) for more details.


# Proactive Features
Source: https://docs.dimension.dev/proactive-features

Things Dimension does for you automatically, before you even ask.

Dimension doesn't just wait for you to ask — it works in the background across your connected tools to surface what matters, draft responses, and prepare you for your day.

<Note>You can toggle each proactive feature on or off individually in **Settings > Preference > Background Agents**.</Note>

## Morning Briefing

Every morning, Dimension prepares a personalized briefing with:

* **Weather** for your location
* **Your schedule** — meetings, deep work windows, and personal plans at a glance
* **What needs your attention** across email, Slack, and calendar

The briefing appears on your home screen when you open Dimension.

## Catch Up

Dimension summarizes what you missed across three tabs:

* **Email** — Unread emails with AI-generated thread summaries and draft replies ready to send
* **Slack** — Unread messages with thread summaries and suggested responses
* **Meetings** — Upcoming meetings with attendee details and prep notes

Each item comes with a pre-drafted reply that you can edit and send directly.

## AI Inbox

Dimension automatically manages your email in the background:

* **Auto-tagging** — Emails are categorized and labeled automatically
* **Auto-drafting** — Responses are drafted in your tone, ready for you to review and send

## Meeting Prep

Before each meeting, Dimension pulls context from your connected tools and generates prep notes — what the meeting is about, relevant documents, and key context from previous conversations. You can share prep notes with attendees directly.

## Action Items

Dimension scans your email, Slack, and calendar for urgent items and notifies you so nothing falls through the cracks.

## Evening Recap

A summary of your day — what happened, what got done, and what's left.

## Todos

Dimension suggests action items by scanning your email, Slack, calendar, Linear, and GitHub. You can:

* **Add** a suggestion as a todo
* **Dismiss** suggestions you don't need
* **Assign a todo to Dimension** — it creates a background thread and works through the task autonomously, notifying you when it's done or if it needs your input

## Meeting Notes

<Info>Coming soon — an AI note-taker that joins your meetings, captures what was discussed, and follows up on action items.</Info>

## Managing these features

You can turn each background agent on or off individually in **Settings > Preference > Background Agents**. The available toggles are:

* Action Items
* Evening Recap
* Morning Briefing
* Email Tagging
* Email Auto-Drafting
* Meeting Prep

<Note>Have more questions? Check the [FAQ](/faq#proactive-features) for detailed answers about background agents, notifications, and more.</Note>


# Quickstart
Source: https://docs.dimension.dev/quickstart

Get up and running with Dimension in under 5 minutes.

<Steps>
  <Step title="Create your account">
    Go to [dimension.dev](https://dimension.dev) and sign up with Google or SSO.
  </Step>

  <Step title="Connect Google Workspace">
    The first thing Dimension asks you to do is connect Google Workspace. Most core features depend on it:

    * **Dimension in chat** can read and send emails, manage your calendar, search your Drive, and edit Docs and Sheets
    * **Morning Briefing** pulls from your calendar and email
    * **AI Inbox** auto-tags and drafts replies from Gmail
    * **Meeting Prep** uses your calendar events and related docs

    <Tip>Connecting Google unlocks Gmail, Calendar, Drive, Docs, Sheets, and Slides — all in one step.</Tip>
  </Step>

  <Step title="Connect your other tools">
    You'll then have the option to connect tools like Slack, Linear, Notion, GitHub, Vercel, and more. You can skip this and connect them later from the **Integrations** page.
  </Step>

  <Step title="Get the apps">
    Dimension is available on the web today, with native apps on the way.

    <Tabs>
      <Tab title="Web">
        Head to [dimension.dev](https://dimension.dev) — no install needed.
      </Tab>

      <Tab title="Mac & Windows">
        *Coming soon.* The desktop app for Mac and Windows is currently in development.
      </Tab>

      <Tab title="iOS">
        *Coming soon.* The iOS app will be available on the App Store soon.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Start chatting">
    Send your first message. Try something like:

    * "What's on my calendar today?"
    * "Summarize my unread emails"
    * "Create a Linear issue for the login bug we discussed in Slack"
    * "Draft a presentation about our Q4 results"
  </Step>
</Steps>

## What's next

<CardGroup>
  <Card title="Set up a workflow" icon="arrow-progress" href="/workflows">
    Automate a recurring task on a schedule or trigger.
  </Card>

  <Card title="Create an artifact" icon="file-lines" href="/artifacts">
    Generate a presentation, spreadsheet, or document from chat.
  </Card>

  <Card title="Check your briefing" icon="sun" href="/proactive-features">
    Get a daily summary of what needs your attention.
  </Card>

  <Card title="Connect more tools" icon="plug" href="/integrations">
    Add Slack, Linear, Notion, GitHub, and more.
  </Card>
</CardGroup>


# Security
Source: https://docs.dimension.dev/security

How Dimension keeps your data safe.

Dimension connects to your most sensitive tools — your email, calendar, code, and documents. We take that responsibility seriously. Security isn't an afterthought — it's built into every layer of how we handle your data.

<Note>Dimension never trains AI models on your data, never sells your information, and never shares it with third parties for advertising. Your data is yours.</Note>

## Encryption

All data is protected with enterprise-grade encryption in transit and at rest. OAuth tokens are stored securely and are not accessible to Dimension personnel.

## Compliance

<CardGroup>
  <Card title="CASA Tier 2" icon="certificate">
    Certified through the Cloud Application Security Assessment.
  </Card>

  <Card title="Penetration tested" icon="shield-check">
    Third-party penetration tested by independent security researchers.
  </Card>

  <Card title="SOC 2" icon="lock">
    Certification underway.
  </Card>

  <Card title="GDPR" icon="globe">
    Certification underway.
  </Card>
</CardGroup>

Payments are handled entirely by **Stripe** — Dimension never stores payment information.

## Your controls

You're always in control of your data:

* **Disconnect an integration** and Dimension permanently and completely deletes all associated data
* **Delete your account** from Settings to permanently remove all your data, integrations, and conversations
* **Revoke access** to any third-party integration through the provider's settings at any time

## Breach notification

In the event of a data breach, Dimension will notify affected users within 72 hours.


# Skills
Source: https://docs.dimension.dev/skills

Teach Dimension how to handle specific tasks your way.

Skills teach Dimension how you work. They can be simple rules ("always sign off emails with just my first name") or deep knowledge that Dimension learns by researching your tools. Unlike [workflows](/workflows) which run automatically, skills are used during chat — Dimension automatically picks the right skill when it's relevant, or you can ask for one directly.

## What makes up a skill

* **Prompt** — Instructions or a learning task for Dimension
* **Integrations** — Which tools the skill can access
* **Memory** — What the skill has learned over time from research and your feedback

## Examples

<Tabs>
  <Tab title="Writing tone">
    Tell Dimension how you communicate:

    ```
    When drafting emails or Slack messages, match my writing tone:
    - Keep it casual and direct
    - Use short sentences, no filler
    - Never use "I hope this email finds you well" or similar
    - Sign off with just my first name
    ```

    Dimension automatically applies this whenever you ask it to write a message.
  </Tab>

  <Tab title="Learning from data">
    Skills can actively learn from your connected tools. For example:

    ```
    Learn how our fund evaluates investments by reading through
    our investment memos and partner meeting notes in Google Drive.
    Understand our thesis, what we look for in founders, and our
    typical deal structure.
    ```

    Dimension researches your data, builds up knowledge, and then uses it whenever you ask about evaluating a deal or drafting investment notes.
  </Tab>

  <Tab title="Bug triage">
    Encode your team's process into a skill:

    ```
    When I ask you to triage a bug:
    - Check Sentry for related errors
    - Look for similar issues in Linear
    - If it's a new bug, create a Linear issue with severity based on error frequency
    - Post a summary in #engineering on Slack
    ```
  </Tab>
</Tabs>

## Learning from feedback

Skills get better over time. After a skill runs, you can give it feedback in the **Learn** section — tell it what to do differently, and it updates its memory. Each correction makes the skill more aligned with how you work.

<Tip>Use the **Learn** section after every skill run to fine-tune Dimension's behavior. The more feedback you give, the better the skill gets.</Tip>

## Skills vs. workflows

|                   | Skills                         | Workflows                              |
| ----------------- | ------------------------------ | -------------------------------------- |
| **When they run** | On-demand in chat              | Automatically on a schedule or trigger |
| **Learning**      | Gets better from your feedback | Static prompt                          |

## Marketplace

Browse and install pre-built skills from the marketplace, organized by role. You can also publish your own skills for others to use.


# Workflows
Source: https://docs.dimension.dev/workflows

Automate recurring tasks with workflows that run on a schedule or in response to events.

Workflows are automated routines that run without you having to do anything. Define a task once, and Dimension runs it for you — on a schedule or when something happens in your tools.

## How to create a workflow

You can create workflows from the **Workflows** page or by asking Dimension in chat:

* "Create a workflow that summarizes my emails every morning"
* "Set up a workflow that posts a Slack message when a Vercel deployment fails"

A workflow has a few parts:

* **Prompt** — What you want Dimension to do, written in plain language
* **Integrations** — Which tools the workflow can use
* **Schedule or trigger** — When it should run

## How workflows execute

```mermaid theme={null}
flowchart LR
    A[Trigger fires] --> B{Approval required?}
    B -->|Yes| C[Wait for approval]
    B -->|No| D[Execute task]
    C --> D
    D --> E[Deliver results]
```

## Workflow types

<Tabs>
  <Tab title="Scheduled">
    Run at set times — daily, weekdays, weekly, or custom.

    **Examples:**

    * Every weekday at 9 AM — summarize unread emails
    * Every Monday at 8 AM — weekly sprint summary
    * Every Friday at 5 PM — weekly accomplishment recap
  </Tab>

  <Tab title="Triggered">
    Run automatically when something happens in your tools.

    | Integration         | Triggers                                                                     |
    | ------------------- | ---------------------------------------------------------------------------- |
    | **Gmail**           | New email (filter by label)                                                  |
    | **Slack**           | New DM, new message in a channel                                             |
    | **Google Calendar** | Before or after a calendar event                                             |
    | **Vercel**          | Deployment failed or succeeded                                               |
    | **Linear**          | Cycle started/ended, issue created                                           |
    | **GitHub**          | PR opened                                                                    |
    | **Airtable**        | New records added                                                            |
    | **Google Sheets**   | New rows added                                                               |
    | **Stripe**          | Customer created, invoice paid/failed, payment succeeded, checkout completed |

    All triggers support filters so you can narrow down when the workflow fires (e.g., only specific Slack channels, repos, or labels).
  </Tab>
</Tabs>

## Example workflows

| Trigger                      | What Dimension does                                     |
| ---------------------------- | ------------------------------------------------------- |
| New email from a client      | Summarize the email and create a todo                   |
| Vercel deployment failed     | Post failure details to Slack and create a Linear issue |
| GitHub PR opened             | Review the changes and post a summary comment           |
| Calendar event in 15 minutes | Prepare meeting briefing notes                          |

## Notifications

When a workflow finishes, Dimension notifies you through your preferred channel — email, Slack, iMessage, or push notification. You can change your preferred channel in **Settings**. Email is the default.

You can also tell Dimension where to send results directly in the workflow prompt — e.g. "...and post the summary in #general on Slack" — as long as that integration is connected.

## Approvals

Workflows can run fully automatically, or you can require approval before Dimension takes sensitive actions — just like approvals in chat.

<Warning>Disabling approvals means workflows will take actions (like sending emails or posting messages) without asking first. Only disable approvals for workflows you've thoroughly tested.</Warning>

## Marketplace

Browse and install pre-built workflows from the marketplace, organized by role (Engineering, Product, Marketing, Sales, etc.). You can also publish your own workflows for others to use.

<Tip>The Marketplace is a great way to get started — find a workflow close to what you need and customize it.</Tip>