Skip to content

Integration Settings

Where to find and configure Slack, Jira, Linear, and GitHub integrations inside the app.

INFO

PagerDuty is not currently shipped. The integrations agent supports Slack, Jira, Linear, and GitHub today (each described below). PagerDuty is on the roadmap.


Where integrations live

Integrations are managed from the Integrations area of Escher's Settings. Each integration shows its connection status, a short description, and the action needed (connect, reconnect, or disconnect).

INFO

The exact menu path to Integrations and the per-integration card layout may differ in your build. The four supported integrations and how to authenticate each are described below — that part is stable.


Slack

What it does: when you ask Escher to post something to Slack, Escher formats the message as Slack Block Kit JSON and posts it via your stored bot token. There is no notification-rule engine — you trigger sends per-prompt.

To connect:

  1. Create a Slack app at api.slack.com/apps with chat:write scope
  2. Install to your workspace; copy the Bot User OAuth Token (xoxb-...)
  3. In Escher's Integrations settings, connect Slack and paste the token
  4. Invite the bot to the channels you want to post in: /invite @escher-bot

See Slack integration for full details.


Jira

What it does: when you ask Escher to do something in Jira, Escher generates the Python script for that operation and runs it from your machine using your Jira credentials. There is no stored field-mapping engine and no two-way status sync — each request produces a fresh script.

To connect (so generated scripts can authenticate):

  1. In Atlassian, generate an API token at id.atlassian.com → Security → API tokens
  2. Set environment variables on your machine:
    bash
    export JIRA_BASE_URL="https://your-org.atlassian.net"
    export JIRA_EMAIL="you@company.com"
    export JIRA_API_TOKEN="..."

See Jira integration.


Linear

What it does: same model as Jira — Escher generates Python scripts that talk to Linear's GraphQL API.

To connect:

  1. In Linear → Settings → API → Personal API keys → create a key
  2. Set the env var: export LINEAR_API_KEY="lin_api_..."

See Linear integration.


GitHub

What it does: same model as Jira and Linear — Escher generates Python scripts that talk to GitHub's REST/GraphQL APIs. Not a deploy-correlation engine; not a pre-merge risk scorer.

To connect:

  1. Set GITHUB_TOKEN in your environment (a personal access token with the scopes your scripts will need), or use a logged-in gh CLI session

See GitHub integration.


PagerDuty (roadmap)

PagerDuty is not currently shipped. When it's available, it will appear alongside the four integrations above.


Removing or rotating an integration

Disconnecting an integration removes the stored credential immediately. To rotate, disconnect and then reconnect with the new credential.


What's next

Escher — Agentic CloudOps by Tessell