sections integrations

Integrations

Active contributors: Andy Taylor, Eno Reyes

Purpose

docs/integrations/ documents the third-party surfaces Factory plugs into — IDE extensions, source control apps, and team chat/issue trackers. Each integration is a single MDX file with install + usage instructions.

Directory layout

docs/integrations/
├── github-app.mdx          # Install and configure the Factory GitHub App
├── ide-integrations.mdx    # General IDE integrations overview
├── jetbrains.mdx           # JetBrains-specific via ACP
├── zed.mdx                 # Zed-specific via ACP
├── linear.mdx              # Linear (issues / project tracking)
└── slack.mdx               # Slack (chat-based droid interaction)

The VS Code extension is documented externally (linked from README.md and docs/cli/getting-started/overview.mdx to the VS Code marketplace listing) rather than in this directory. JetBrains and Zed use ACP (Agent Communication Protocol) and have their own per-IDE pages.

What each page covers

Page	Highlights
github-app.mdx	Largest of the integration pages (~9 KB). Covers the Factory GitHub App: org-level install, per-repo permissions, the /install-github-app slash command, and how the app powers code review and missions.
ide-integrations.mdx	General orientation for IDE setups; routes readers to the per-IDE pages.
jetbrains.mdx	JetBrains setup via ACP — how to install the bridge and connect from IntelliJ/PyCharm/etc.
zed.mdx	Zed setup via ACP. The longest IDE-specific page (~6 KB).
linear.mdx	Connecting Linear so droid can read tickets and post updates.
slack.mdx	Connecting Slack so droid can be invoked from chat threads.

Related, but elsewhere

• The GitHub App's enterprise/security profile lives in docs/enterprise/github-integration-security.mdx.
• MCP servers — broader than these single-purpose integrations — are documented at docs/cli/configuration/mcp.mdx.
• Plugins (which can wrap third-party services) are at docs/cli/configuration/plugins.mdx and docs/guides/building/building-plugins.mdx.
• Changelog automations to Discord and Linear are CI workflows (.github/workflows/changelog-to-{discord,linear}.yml), not user-facing integrations.

Entry points for modification

• New integration → add docs/integrations/<name>.mdx, add to the "Integrations" group in docs/docs.json, and link from the most relevant getting-started page.
• IDE integration → if it uses ACP, follow the jetbrains.mdx / zed.mdx pattern. If it ships as a marketplace extension, link out to the marketplace from ide-integrations.mdx and README.md.