Hyphen Agent is an operations agent for your Hyphen organization. It helps answer questions, investigate activity, analyze logs, recommend optimization work, and prepare routine cleanup changes for review.
Hyphen Agent is not a coding assistant. Coding assistants help create application code. Hyphen Agent helps operate the cloud, deployment, feature flag, link, project, and integration footprint around that code.
Table of Contents
Where You Use Agent
You can work with Agent from the Hyphen App and from Slack when the Slack integration is installed.
- Agent inbox - Review recent Agent runs and chat sessions from the right-side Agent panel in the Hyphen App.
- Chats - Ask questions, attach resource context, approve actions, and continue previous conversations.
- Tasks and runs - Review scheduled or triggered Agent work, including status, findings, steps, pull requests, and approval requests.
- Slack - DM the Hyphen bot or mention it in a channel thread to use the same organization chat functionality from Slack.
Core Concepts
| Concept | Description |
|---|---|
| Chat session | A conversation with Agent. Sessions can answer questions directly or create tasks when work needs to run. |
| Agent task | A unit of work Agent creates or runs, such as log analysis, optimization, resource cleanup, or GitHub issue automation. |
| Run | An execution of an Agent task. Runs show progress, findings, action requests, linked resources, and output. |
| Reference | A linked Hyphen resource, such as a project, app, environment, deployment run, feature flag, team, member, link, domain, or Agent task. |
| Input request | A structured prompt for confirmation, selection, free text, or an option with added text. |
| Member memory | Durable preferences or facts that Agent can remember when explicitly asked. Do not store secrets in memory. |
Context-Aware Answers
Agent uses attached context first. If you start a chat from a project, app, or environment page, Hyphen can attach that context automatically so Agent can scope the answer without requiring you to repeat where you are.
Agent also renders supported resource references as links back into Hyphen, so answers can point directly to the project, app, environment, deployment, preview deployment, feature flag, segment, link, domain, team, member, or Agent task involved.
Action Model
Agent can answer many questions directly. When a request would create, delete, change, or propose work against a resource, Agent uses structured input requests for approval or missing information.
Code and configuration changes that belong in a repository are proposed through pull requests. Resource changes in Hyphen require the same permissions as the equivalent action in the app.