---
lang: en
---

# Sources

Sources are the code repositories and other inputs a product connects, so Cactus can learn how the product behaves and write its help pages. You set GitHub repositories and flag tools under Settings › Sources, docs and Intercom imports under Settings › Imports, and the pages and answers Cactus keeps as true under What Cactus takes as true.

> Verified against the product on 2026-11-20

## Connect GitHub repositories

1. In [Settings › Sources](https://app.heycactus.ai/settings/sources), select **Connect GitHub**. It opens GitHub, and until a connection is made the GitHub row reads “Not connected.”
2. Select **Pick repositories**. The picker lists the repositories your GitHub account lets Cactus read.
3. Tick the repositories you want and save the selection.

> **Note:** A save needs at least one repository, and it saves only the repositories the team’s own GitHub installations hold. A save that changes the set starts a build, and a save of the same set starts none.

While the picker is open it takes the place of the repository rows, and a save or a Cancel closes it. A product that reads no repository has no Cancel, so the picker stays open.

Each repository row shows its branch, and shows `main` when none is set.

To add someone else’s public repository, fork it into a GitHub account connected to Cactus, then pick the fork.

## Remove a repository

1. In [Settings › Sources](https://app.heycactus.ai/settings/sources), select **Remove** beside the repository.

Cactus stops reading a repository once it is removed. Any member of the product’s team can remove one.

The panel also says published pages stay until the next build, but removing a repository starts a build straight away.

If that build cannot start, the repository stays removed and the message asks you to press **Rebuild**. Each build’s run is shown on [Builds](https://cactus.heycactus.ai/7q7w26-builds).

## Connect a flag tool

Flag tools let Cactus read which flags are on when it writes a page that checks one.

Each tool’s row says how many flags your code checks with it, or that it finds none.

A flag that PostHog leaves out of its answer reads as off.

### Connect PostHog

1. Select **Connect PostHog**. Cactus sends you to PostHog to sign in.

If PostHog’s projects don’t settle which project is yours, the connection waits for the owner’s choice, and it reads no flags until then.

### Connect LaunchDarkly

1. Select **Connect LaunchDarkly**, paste a LaunchDarkly access token with the Reader role into **Reader token**, and select **Find projects**.
2. Pick the project and the environment, then select **Save**. Cactus reads the pick back from LaunchDarkly before it saves it.

Finding projects uses the token once and stores nothing, and saving stores the token encrypted.

### Disconnect a flag tool

1. Select **Disconnect** on the tool’s row.

Any member of the product’s team can disconnect a flag tool. Disconnecting removes the product’s project, and the token too once no product of the team reads through it.

## Import a docs site or Intercom conversations

Imports bring in your old help center or support history, once.

### Import a docs site

1. In [Settings › Imports](https://app.heycactus.ai/settings/imports), paste the address into **Docs site or old help center**, then select **Import**.
2. A running import shows as **Importing** until it ends, then as **Imported** or **Failed**.
3. Select **Show** to see the topics an import read, and **Remove** to delete the import.

Removing an import deletes it and what it read. Only a topic marked obsolete has a **Remove** of its own.

### Import Intercom conversations

1. Select **Connect Intercom**. Where Cactus has its Intercom app set up, the button appears, and elsewhere the row says “Intercom isn’t available yet.”
2. Select **Import conversations**.
3. Select **Disconnect** to remove the Intercom connection. This deletes the Intercom import and the conversations Cactus read.

If Intercom refuses the token, the row says “Intercom refused the token. Connect Intercom again.” and the connection is taken away.

## Pages and answers you attached

[What Cactus takes as true](https://app.heycactus.ai/settings/truth) lists the pages you attached, the answers you kept and the writing rules. These tell Cactus what the code can’t.

A page shows **Holds** or **Unavailable** beside it.

Select **Remove** beside a page or an answer. A member can remove what they attached, and a team owner can remove anyone’s.

Writing rules are not removed on this page. They are kept under [Settings](https://cactus.heycactus.ai/h78hdn-settings).

## If a source change fails

| What you see | What it means | What to do |
| --- | --- | --- |
| “Pick at least one repository.” | The save had no repository ticked. | Tick at least one repository, then save. |
| “Cactus couldn’t start reading these repositories. Try again.” | Cactus refused the save, and the repositories went back to what they were. | Try again. |
| “Cactus couldn’t confirm the build started. Press again: it won’t start a second one.” | The build may or may not have started. | Save again. A repeat sends the same build once. |
| “Cactus couldn’t remove that repository. Nothing changed. Try again.” | The repository is still on the product. | Try again. |
| “… is removed, but Cactus couldn’t start the rebuild that takes its pages down. Press Rebuild to finish.” | The repository is removed, and its build did not start. | Press **Rebuild**. |
| “PostHog refused Cactus’ access. Connect again to fix it.” | The PostHog token was refused. | Select **Connect again**. |
| “LaunchDarkly refused this token. Disconnect, then connect with a new Reader token.” | The LaunchDarkly token was refused. | Disconnect, then connect with a new Reader token. |
| “You didn’t add this source, so only a teamspace owner can remove it.” | A member tried to remove a page or answer another member added. | Ask a team owner to remove it. |
