supermemory/apps/docs/company-brain/use-cases/acting-in-tools.mdx
Prasanna721 434c86e2c3 fix docs image pipeline (#1411)
Keep docs asset URLs repo-root-relative and pass images as literal MDX children so Mintlify can compile them through OptimizedImage under the /docs mount.

Mintlify's official guidance says: “Image paths are root-relative from your docs repository.” It also says relative paths such as `./screenshot.png` are unsupported. See [Image embeds](https://www.mintlify.com/docs/create/image-embeds).

The existing `/images/...` paths were correct. The failure came from passing them through custom-component string props, which kept Mintlify from seeing those images during its MDX transform.

- fix hero, building-block, and Slack avatar images
- preserve Slack avatar clipping
- normalize Hermes and Company Brain icon sizing

Tested with Mintlify validation, broken-link checks, and browser checks across every changed route.
2026-08-04 04:55:50 +00:00

58 lines
2.4 KiB
Text

---
title: "Acting in Tools"
sidebarTitle: "Acting in Tools"
description: "List open PRs, create Linear issues — actions run under your own account"
icon: "wrench"
---
import { SlackThread, SlackMessage, Mention, AgentLink } from "/snippets/slack-message.mdx";
## The scenario
You don't just want to *know* something — you want Company Brain to do the next step in GitHub or Linear for you.
## What happens
### Read from a tool
<SlackThread channel="#eng">
<SlackMessage self hasAvatar time="3:22 PM">
<img src="/images/company-brain/dhravya-slack-icon.jpg" alt="" />
<Mention>supermemory</Mention> what are my open PRs in the web repo?
</SlackMessage>
<SlackMessage bot hasAvatar time="3:22 PM">
<img src="/images/company-brain/supermemory-slack-icon.png" alt="" />
You have **3 open PRs** on `supermemory/web`:
- `#1199` staff custom MCP connection cards — review requested
- `#1197` company brain onboarding research UI — changes requested
- `#1181` brain connections board — approved, not merged
</SlackMessage>
</SlackThread>
### Write to a tool
<SlackThread channel="#eng">
<SlackMessage self hasAvatar time="3:24 PM">
<img src="/images/company-brain/dhravya-slack-icon.jpg" alt="" />
<Mention>supermemory</Mention> create a Linear issue: fix the onboarding redirect
</SlackMessage>
<SlackMessage bot hasAvatar time="3:24 PM">
<img src="/images/company-brain/supermemory-slack-icon.png" alt="" />
Created **ENG-842** — *Fix the onboarding redirect* in Engineering, assigned to you. <AgentLink href="https://linear.app">Open in Linear</AgentLink>
</SlackMessage>
</SlackThread>
## What's really going on
Both turns use [tool connectors](/company-brain/connectors) (GitHub, Linear). Reads try your **personal** connection first and fall back to the org-shared one. **Writes always run under your own account** — so the Linear issue is attributed to you, never silently as "the org."
If you haven't connected the tool and neither has the org, Company Brain can ask a teammate to [lease](/company-brain/permissions#leasing-borrowing-access-for-one-request) temporary access for that one request.
<CardGroup cols={2}>
<Card title="Permissions" icon="shield-check" href="/company-brain/permissions">
Personal vs org tools, and how leasing works.
</Card>
<Card title="Connectors" icon="plug" href="/company-brain/connectors">
Connect GitHub, Linear, and the rest.
</Card>
</CardGroup>