> ## Documentation Index
> Fetch the complete documentation index at: https://modem.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> The key entities in Modem and how they fit together

export const Prompt = ({text, variant = 'accent'}) => {
  const [copied, setCopied] = useState(false);
  const handleCopy = async () => {
    try {
      await navigator.clipboard.writeText(text);
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    } catch {}
  };
  const clipboardIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copy</title>
            <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
            <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
        </svg>;
  const checkIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copied</title>
            <polyline points="20 6 9 17 4 12" />
        </svg>;
  const promptIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style={{
    flexShrink: 0,
    opacity: 0.4
  }}>
            <title>Prompt</title>
            <path d="M20 2H2v20h2V4h16v12H6v2H4v2h2v-2h16V2zM6 7h12v2H6zm8 4H6v2h8z" />
        </svg>;
  return <div className={`prompt prompt-${variant}`} style={{
    marginTop: '12px',
    marginBottom: '12px'
  }}>
            {promptIcon}
            <span className="prompt-text">{text}</span>
            <button className="prompt-copy" onClick={handleCopy} title="Copy to clipboard" type="button">
                {copied ? checkIcon : clipboardIcon}
            </button>
        </div>;
};

Modem ingests messages from your connected sources and uses AI to organize them into a few key entities. Here's a quick overview of each.

<Frame>
  <img src="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/images/how-modem-works.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=c428bb82535d68ae73bd526e0debb23f" alt="How Modem works: messages from Slack, Discord, GitHub, and Email are grouped into discussions, which roll up into topics." width="700" height="290" data-path="images/how-modem-works.svg" />
</Frame>

## Topics

**Topics** are AI-discovered conversation themes. When users discuss similar subjects across different channels or time periods, Modem groups those conversations into a topic.

A topic might be:

* "Users struggling with OAuth setup" (spanning Slack support questions and GitHub issues)
* "Feature request: Dark mode" (collected from Discord suggestions and email feedback)
* "Performance issues on mobile" (bug reports across multiple channels)

Each topic has an AI-generated title, summary, feedback classification (bug report, feature request, complaint, or praise), and a priority level. Topics are created automatically as messages arrive.

[Learn more about Topics →](/guides/topics)

## Discussions

**Discussions** are distinct conversations within a topic. A single topic might contain several discussions that happened at different times or in different channels.

For example, a "Dark mode" topic might have one discussion from March when it was first requested, another in June with follow-up questions, and a third in August about contrast issues.

## People

**People** are unified profiles that represent real humans across your connected platforms. When someone is active on Slack, GitHub, and Discord, Modem can recognize them as the same person and consolidate their activity into one profile.

Each person tracks their messages, topics they've contributed to, platform identities, and company association.

[Learn more about People →](/guides/people)

## Companies

**Companies** group people by organization, giving you an account-level view of engagement. Each company tracks its associated people, their roles, and employment history. Companies can be created automatically from organizational signals in your data or manually from the dashboard.

[Learn more about Companies →](/guides/people#companies)

## Channels

**Channels** are the specific places where conversations happen: a Slack channel, a Discord server channel, a GitHub repository, or an email inbox. Modem tracks where messages come from so you can filter and analyze by source.

## The Agent

The **Modem Agent** is an AI assistant that can answer questions about your data, find patterns, and take action. Instead of manually browsing and filtering, you ask questions in plain language.

You can talk to the agent from the Modem dashboard or directly in Slack (via DM or @mention). It has access to all your topics, messages, people, and connected integrations, and can do things like create Linear issues, post to Slack, query GitHub, or [delegate coding tasks](/integrations/coding-agents) to Claude Code, Cursor, and Devin.

A few examples:

<Prompt text="What are users complaining about this week?" />

<Prompt text="Summarize feedback from the last sprint" />

<Prompt text="Create a Linear ticket for the OAuth bug reports" />

The agent also powers [automations](/features/automations), where you can run prompts on a schedule or when specific events happen.

[Learn more about the Agent →](/features/agent)

## Next Steps

<CardGroup cols={2}>
  <Card title="Topics" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/label-alt-multiple.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=e7fbaf23c28396ac670b89cf38e1e4a6" href="/guides/topics" width="24" height="24" data-path="icons/label-alt-multiple.svg">
    How topics are discovered and how to work with them.
  </Card>

  <Card title="Companies & People" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/users.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=32a2de5620a3659206db1c3d1aff5a06" href="/guides/people" width="24" height="24" data-path="icons/users.svg">
    Unified profiles for users and organizations.
  </Card>

  <Card title="Integrations" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/link.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=e774d33588635d44c6c935b78ed55f13" href="/integrations/overview" width="24" height="24" data-path="icons/link.svg">
    Connect your data sources.
  </Card>

  <Card title="The Modem Agent" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/bot.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=2496f9106cb54fa9f4e27ad1f8f3a171" href="/features/agent" width="22" height="22" data-path="icons/bot.svg">
    Ask questions and take action with natural language.
  </Card>
</CardGroup>
