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:
- Create a Slack app at api.slack.com/apps with
chat:writescope - Install to your workspace; copy the Bot User OAuth Token (
xoxb-...) - In Escher's Integrations settings, connect Slack and paste the token
- 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):
- In Atlassian, generate an API token at id.atlassian.com → Security → API tokens
- 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:
- In Linear → Settings → API → Personal API keys → create a key
- 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:
- Set
GITHUB_TOKENin your environment (a personal access token with the scopes your scripts will need), or use a logged-inghCLI 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.