Hyphen

Setup and Requirements

A guide to setting up the Hyphen Agent, detailing the requirements and configurations needed for various capabilities, including New Relic, GitHub, and Slack integrations.

Agent is available from the Hyphen App for your organization. Some capabilities require connected integrations or specific Hyphen permissions.

Table of Contents

Requirements by Capability

Capability Requirements
Activity answers Recorded Hyphen events and permission to view the related resources.
Chat sessions Access to the Hyphen organization.
Slack chat Installed Slack integration and a Slack user/workspace that Hyphen can resolve to a member and organization.
Member memory A signed-in Hyphen member. Memory changes must be requested explicitly.
Log analysis Deployment logs from the connected cloud provider, or New Relic APM when configured.
New Relic-backed log analysis Connected New Relic integration and an app configuration that maps to the Hyphen environment.
GitHub issue automation Connected GitHub integration and repository access.
Pull requests from Agent findings Connected GitHub repository for the affected app.
Stale feature flag cleanup Hyphen Toggle usage data and a connected GitHub repository for the app.
Optimization and signals investigation Deployment/runtime data Agent can inspect and permission to view the related resources.
Resource cleanup Deployment resources created or tracked by Hyphen and permission to approve cleanup when required.
Project tools Organization permissions to list or create projects.
Short link and QR code tools Link domain configuration and permission to manage links or QR codes.

New Relic Configuration

For New Relic-backed log analysis, connect New Relic from the Integrations area first. Hyphen supports two APM connection patterns:

  • Shared by environment attribute - One New Relic APM app uses an environment attribute filter to separate environments.
  • Per environment - Each Hyphen project environment maps to a distinct New Relic APM app name.

If New Relic is not connected for an app, Agent uses available cloud provider container logs instead.

GitHub Configuration

GitHub is required for repository-backed automation, including stale feature flag cleanup, issue automation, and pull requests from log analysis findings.

Agent uses connected repository context for reviewable changes. If a repository is not connected, Agent can still surface findings where supported, but it cannot open repository pull requests.

Slack Configuration

Install the Slack integration before using Agent from Slack. You can DM the Hyphen bot or mention it in a channel thread.

If Hyphen cannot resolve the Slack workspace or user to a Hyphen organization member, the bot returns a blocker message instead of starting a chat.

Permissions

Agent follows Hyphen organization permissions. A member must have permission to view, create, delete, or change the resource involved in an Agent action.

When an action requires approval or more information, Agent asks through a structured input request instead of relying on freeform text.