Managing integrations

You can manage an agent’s integrations from three places: the dashboard, the CLI, and the agent itself. They act on the same underlying state, so an integration you add in one place shows up in the others.

From the dashboard

The dashboard is the easiest place to browse and connect integrations:

• Browse the available channels and apps and add one to an agent.
• Connect an account through a guided OAuth pop-up — sign in to the provider, approve access, and the window closes itself when it’s done.
• Configure an integration’s settings after it’s connected.
• Check status — see which integrations are active on each agent.
• Remove an integration when you no longer need it.

From the CLI

The alfe integration command manages integrations for the agent connected on the current machine. Its alias is alfe int.

# See what's installed on this agent
alfe integration list

# Search the registry for something to add
alfe integration search notion

# Install an integration (optionally pin a version)
alfe integration install notion

# Configure an installed integration interactively
alfe integration configure notion

# Health-check one integration, or all of them
alfe integration status notion
alfe integration status

# Remove an integration
alfe integration remove notion

Installing an integration that needs an account will prompt you to complete the connection — typically by opening a browser to authorize the provider. Once the connection is in place, the integration becomes active on its own.

From the agent

Agents can manage their own integrations over MCP or the Agent API. This lets an agent install and configure the tools it needs as part of setting itself up, without a person driving the dashboard. The same install → connect → active lifecycle applies; see How integrations work.

Connecting an account

Most apps and channels need a one-time OAuth authorization before they turn on. That step is the same regardless of where you start it — dashboard, CLI, or agent. For the details of the connect flow, see How connecting works.

Many providers let you connect more than one account — for example a personal account and an organization account side by side — so an agent can act as whichever one you point it at.