> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hue.run/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To set up Hue in an application, fetch https://docs.hue.run/guides/agent-setup.md and follow it.
> Hue's project-data MCP server is https://mcp.hue.run/mcp. https://docs.hue.run/mcp only searches these docs and cannot read a Hue project.
> Never ask the user to paste a Hue API key into chat; they store it as HUE_API_KEY themselves.
> Install the exact SDK versions pinned on the page you're following, or on https://docs.hue.run/quickstart.md. Run the latest CLI without a project install as `npx -y @hue-run/sdk@latest`. In a project with `@hue-run/sdk` installed, use `npx hue`. Pin an exact version for reproducible CI runs.
> Use Hue product terms: eval set, case, evaluator, run and scoring run. Older APIs may say dataset, scorer or experiment; prefer the current SDK methods. See https://docs.hue.run/concepts.md.

# Hue in Slack

> Connect Hue to your Slack workspace to ask about traces, evals and runs and to make changes you approve.

Hue's Slack app answers questions about your organization's traces, sessions, eval sets, runs, scoring and Worlds, and makes the changes you ask for once you approve each one. It uses the same tools as the [Hue MCP server](https://docs.hue.run/agents/mcp-tools.md), acting as the person who asked with their own access.

## Connect your workspace

An owner or admin of your Hue organization connects Slack once.

1. In Hue, open **Settings** → **Slack** and select **Connect**.
2. Approve the app in Slack.

The person who installs the app is connected right away. Everyone else connects their own Hue account the first time they ask: Hue replies with a **Connect Hue** button, which opens **Settings** → **Slack** where they select **Connect**.

## Ask Hue

* **Direct message.** Open Hue in Slack's sidebar or in the side panel next to any conversation, and type your question.
* **Channel.** Invite `@Hue` to an internal channel, then mention it: `@Hue which runs failed today?` Each follow-up in a thread needs another mention.

Hue streams its answer in the thread and links to the traces, runs and eval sets it used. It reads every active project in your organization: name one in your question, for example "in the checkout project", or Hue finds the right one or asks.

Everyone in a channel reads Hue's answers there, including guests, so channel answers summarize and never quote recorded prompts, outputs or files. In a direct message, only you read the answer.

## Approve changes

When you ask Hue to change something, such as creating an eval set, launching a run or archiving an evaluator, it posts the change with **Approve** and **Cancel** buttons below its answer. Nothing changes until you select **Approve**. Only the person who asked can approve, and the request expires after 30 minutes. Hue then runs the change with your access and updates the message to **Done** with a link, or **Failed** with the reason.

Owner- and admin-only changes need that role. Hue never creates or revokes API keys from Slack.

## Disconnect

Select **Disconnect** in **Settings** → **Slack**. For an owner or admin, this removes the app from the organization; for anyone else, it disconnects only your own Slack account. Uninstalling the app in Slack also removes it. Disconnecting cancels any change still waiting for your approval.

## Limits

Hue doesn't answer in Slack Connect channels, channels shared with other organizations, or group direct messages. Slack guests can't ask Hue directly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.