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

# Stack Selection

> How to configure your tool stack and manage app connections.

## What is a stack?

Your stack is the collection of business tools you use day-to-day. Pinksheep uses your stack to:

* **Scope the builder** so it only discovers tools from apps you actually use
* **Filter templates** to show agents compatible with your connected apps
* **Recommend agents** during onboarding based on your tool combination

## Selecting your stack

### During onboarding

After signing up, you'll see a grid of popular business tools. Select every app your business uses. You don't need to connect them all immediately; selecting them tells Pinksheep what's relevant.

### Updating later

Go to **Settings > Stack** to add or remove apps at any time. Changes take effect immediately for the builder and template library.

## Supported integrations

Pinksheep supports 20+ integrations via Composio, including:

| Category          | Apps                            |
| ----------------- | ------------------------------- |
| **CRM**           | HubSpot, Salesforce             |
| **Email**         | Gmail, Outlook                  |
| **Communication** | Slack, Microsoft Teams          |
| **Productivity**  | Google Sheets, Notion, Airtable |
| **Finance**       | Xero, QuickBooks, Stripe        |
| **Development**   | GitHub, Linear, Jira            |
| **Storage**       | Google Drive, Dropbox           |
| **Marketing**     | Mailchimp, ActiveCampaign       |

<Info>
  New integrations are added regularly. If your tool isn't listed, it may still be available through Composio's extended catalog.
</Info>

## Connecting apps

When you build an agent that uses an app, the builder prompts you to connect it via OAuth. The connection flow:

1. Click **Connect** on the app card
2. A popup opens to the provider's OAuth consent screen
3. Authorize Pinksheep to access the required scopes
4. The popup closes and Pinksheep verifies the connection server-side
5. The app is marked as connected

### Connection security

* Pinksheep never stores your passwords
* OAuth tokens are managed by Composio's secure infrastructure
* Connect URLs are minted server-side and validated against an allowlist
* Connection status is verified server-side after every OAuth flow (not inferred from popup close)

### Connection health

Before every agent run, Pinksheep checks that all required connections are still active. If a connection has expired:

* The run is skipped
* You receive a notification to reconnect
* Scheduled agents are paused until the connection is restored

You can also reconnect apps manually from the agent detail page or from the builder's manifest view.

## Multi-account support

If you have multiple accounts for the same app (e.g. two Gmail addresses), Pinksheep uses the most recently authorized connection. Support for explicit account selection per agent is on the roadmap.