slack-notify

# slack-notify

Bridge your Anvil sessions to Slack with rich, contextual notifications. Send session summaries, code review results, security audit findings, deployment statuses, and custom messages to any Slack channel — formatted as beautiful Block Kit messages with full context preserved.

## What It Does

slack-notify provides a seamless Slack integration layer for Anvil outputs:

- **Session summaries**: Auto-format and post a summary of what was accomplished in an Anvil session
- **Code review notifications**: Send diff summaries, review comments, and approval status to team channels
- **Security findings**: Push security audit results with severity badges and remediation links
- **Deployment alerts**: Notify deployment channels with build status, version, environment, and diff link
- **Custom messages**: Send any text, markdown, or structured data to Slack from Anvil conversations
- **Thread replies**: Post follow-up messages in threads for ongoing work items
- **Scheduled summaries**: Configure daily digests of Anvil activity
- **Mention support**: Tag users or groups in notifications (@here, @channel, @username)

## Installation

```bash
anvil plugin install slack-notify
```

## Setup

1. Create a Slack App and add an Incoming Webhook for your workspace
2. Copy the webhook URL
3. Configure the plugin:

```
/slack configure --webhook https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXX
```

Or set the environment variable:
```bash
export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
```

## Usage

### Notify After Deployment
```
/slack notify --event deployment --version 1.2.3 --env production --status success
```

### Send Session Summary
```
/slack summary --channel #engineering
```

### Send Code Review Result
```
/slack review --pr 42 --status approved --channel #code-review
```

### Send Custom Message
```
/slack send --channel #alerts --message "Database migration complete on prod"
```

### Send Security Audit Results
```
/slack audit --file ./security-report.json --channel #security
```

## Configuration Options

| Option | Description | Default |
|--------|-------------|---------|
| `--webhook` | Slack incoming webhook URL | env: SLACK_WEBHOOK_URL |
| `--channel` | Default channel | set during configure |
| `--username` | Bot display name | Anvil |
| `--icon` | Bot icon emoji | :hammer: |
| `--thread-ts` | Reply in thread | none |

## Requirements

- Slack workspace with Incoming Webhooks app installed
- Webhook URL configured via `/slack configure` or SLACK_WEBHOOK_URL environment variable