Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mistle.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Self-hosted Mistle uses integration targets to expose built-in providers to the dashboard and runtime. Operators define those targets in integration-targets.json, then sync them into the control-plane database: 
pnpm --filter @mistle/control-plane-api integration-targets:sync
If you are running this via the Docker Compose stack, this is automatically done as part of the start up script.

​
Start From The Example File

Use the repository example file as the starting point:
  • integration-targets.json
Copy the targets you want, remove the ones you do not want, and commit the operator-managed manifest your deployment uses.

​
Required Workflow

For every manifest change:
  1. Edit integration-targets.json
  2. Run pnpm --filter @mistle/control-plane-api integration-targets:sync

​
Target Config Reference

These are the target-level fields operators own.

​
Empty-config targets

These targets only need to be enabled:
  • aws-cli-default
  • datadog-default
  • jira-default
  • linear-default
  • planetscale-mcp
  • signoz-mcp
Example: 
{
  "targetKey": "linear-default",
  "enabled": true,
  "config": {}
}

​
Slack

slack-default requires an API base URL: 
{
  "targetKey": "slack-default",
  "enabled": true,
  "config": {
    "api_base_url": "https://slack.com/api"
  }
}

​
GitHub

github-cloud and github-enterprise-server require API and web base URLs: 
{
  "targetKey": "github-cloud",
  "enabled": true,
  "config": {
    "api_base_url": "https://api.github.com",
    "web_base_url": "https://github.com"
  }
}

{
  "targetKey": "github-enterprise-server",
  "enabled": false,
  "config": {
    "api_base_url": "https://ghe.example.com/api/v3",
    "web_base_url": "https://ghe.example.com"
  }
}
github-cloud is the default enabled GitHub target in the example manifest. github-enterprise-server is supported, but disabled by default until you explicitly turn it on for a GHES deployment. At this point, github-enterprise-server is only supported for self-hosted deployments.

​
OpenAI

openai-default requires the API base URL. Use the openai-default block from integration-targets.json as your starting point. That block defines:
  • api_base_url

​
Scope Boundary

This page covers target provisioning only. It does not cover:
  • creating GitHub Apps
  • choosing Slack bot scopes
  • creating Jira credentials
  • approving provider OAuth flows
Those tasks belong in the provider-specific connection guides.