# Send Bark Completion Alerts

Long AI agent runs can finish while the user is away from the terminal. This skill sends Bark mobile alerts with task status, project context, and a short completion summary.

## Install

```bash
npx skillstore add caopulan/bark-notify
```

## Metadata

- - Slug: caopulan-bark-notify
- - Version: 1.0.0
- - Author: caopulan
- - GitHub username: caopulan
- - License: MIT
- - Repository: https://github.com/caopulan/Notification-Skill/tree/main/bark-notify
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: medium
- - Risk factors: scripts, network, env\_access, external\_commands, filesystem
- - Quality score: 50
- - Quality tier: warning
- - Public page: https://skillstore.pages.dev/skills/caopulan-bark-notify
- - Manifest: https://skillstore.pages.dev/api/skills/caopulan-bark-notify/manifest

## Capabilities

- Sends a Bark push notification after an AI agent task finishes.
- Includes device name, project name, status, and summary in the notification body.
- Reads Bark key, device name, and base URL from environment variables.
- Detects a project name from AGENTS.md frontmatter or labeled project lines.
- Supports dry-run mode and configurable request timeout for testing.

## Use Cases

- Monitor Long Coding Runs: Receive a mobile alert when a Codex implementation or test run completes.
- Track Remote Agent Work: Send task status from a remote workstation to a phone through Bark.
- Coordinate Review Handoffs: Notify a teammate when an AI-assisted analysis is done and ready for review.

## Prompt Templates

### Basic Completion Alert

```
Use bark-notify when this task is complete. Send status success if all requested work is finished, and include a short summary.
```

### Failure-Aware Alert

```
After the task ends, use bark-notify with status success, partial, failed, or blocked. Keep the summary brief and do not include secrets.
```

### Project-Specific Alert

```
Use bark-notify after this run. Set the project name to the current repository name unless AGENTS.md defines a project name.
```

### Operational Run Notification

```
When the full workflow completes, send a Bark notification with the final status, project name, and a concise summary of implementation, tests, and remaining blockers.
```

## Limitations

- Requires a valid Bark key and network access to the configured Bark service.
- Notification summaries are sent to an external service and should not contain secrets.
- Does not include retry logic, delivery confirmation, or offline queueing.
- Project name detection is limited to supported AGENTS.md patterns.

## Best Practices

- Keep notification summaries short and free of tokens, passwords, customer data, or private logs.
- Set CODEX\_BARK\_BASE\_URL only to a trusted Bark endpoint before enabling automatic alerts.
- Use dry-run mode during setup, then avoid sharing terminal output that contains the Bark URL.

## Anti Patterns

- Do not include raw error logs, access tokens, or private repository details in summaries.
- Do not point the base URL to an untrusted server or shared test endpoint.
- Do not treat Bark delivery as proof that a task succeeded; verify critical results separately.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T20:16:07.889\+00:00
- - Summary: AI review did not confirm malicious intent or prompt injection. The critical static heuristic is explained by the skill purpose: it runs a local helper, reads notification configuration, and sends a Bark push request. Publish with a warning because task summaries and the Bark key can leave the local environment.

## Stats

- - Views: 189
- - Downloads: 7
- - Favorites: 0
- - Popularity score: 0