Skip to main content

Managing Integrations

Integrations connect Obi to external services so your agents and workflows can interact with tools you already use. Obi supports several types of integrations, each providing different capabilities.

Supported Integrations​

Obi connects to the following services:

  • GitHub provides access to repositories, pull requests, issues, and code. It is required for linking projects to codebases.
  • Linear provides access to issues, projects, and team workflows. It also enables delegation triggers that let Linear assign work directly to Obi.
  • Composio provides access to hundreds of third-party tools that your agents can use during executions.
  • Exa provides web search capabilities for your agents.
  • AlphaVantage provides financial market data for agents that need stock or economic information.

Adding an Integration​

  1. Open Settings from the sidebar.
  2. Select the Integrations tab. This page shows all available integrations and their current status.
  3. Find the service you want to connect and click Connect or Add.

OAuth Integrations (GitHub, Linear)​

For services that use OAuth, Obi redirects you to the service's authorization page.

  1. Review the permissions Obi is requesting.
  2. Click Authorize or Approve to grant access.
  3. You are redirected back to Obi. The integration now appears as connected.

Token-Based Integrations (Composio, Exa, AlphaVantage)​

For services that use API keys or tokens:

  1. Enter the required token or API key in the form.
  2. Obi validates the token with the provider to confirm it works.
  3. Once validated, the integration is saved and available for use.

Integration Capabilities​

Each integration provides specific capabilities that determine how Obi can use it:

  • Git allows Obi to access repositories and code.
  • Task allows Obi to read and manage issues or tasks.
  • Tool allows agents to perform actions through the service during executions.
  • OAuth provides authenticated access to the service.

When you add tools to an agent, the available tools depend on which integrations you have connected and what capabilities they offer.

Viewing Connection Status​

The Integrations tab in Settings shows the status of each connection at a glance. Connected integrations display a confirmation indicator. If a connection has expired or encountered a problem, you may see an option to reconnect.

Disconnecting an Integration​

If you no longer want Obi to access a service:

  1. Go to Settings and select the Integrations tab.
  2. Find the integration you want to remove.
  3. Click Disconnect or Remove.

Disconnecting revokes access and removes the stored credentials. Any agents or triggers that depend on that integration will stop working until you reconnect it.