sestinj/agentduty
On-call for your AI agents — get notified when they need you, respond from Slack
AgentDuty
On-call for your AI agents — get notified when they need you, respond from Slack.
An autonomous codebase built by the Continue Software Factory
Why?
AI coding agents run autonomously but sometimes need human input — approval, clarification, or a judgment call. AgentDuty bridges that gap: agents notify you through Slack when they need attention, and you respond right there. Think of it as PagerDuty, but for your AI agents instead of your servers.
Table of Contents
Architecture
AgentDuty has two main components:
- CLI (
cli/) — A Go CLI that agents use to send notifications and poll for responses. Integrates with Claude Code via hooks. - Web App (
web/) — A Next.js app with a Slack integration backend. Handles message routing, session management, and the dashboard at agentduty.dev.
CLI
The CLI is how agents communicate through AgentDuty. Key commands:
agentduty notify -m "message"— Send a notification to the useragentduty poll <short-code> --wait— Wait for a response in a sessionagentduty react <short-code> -e <emoji>— React to a messageagentduty login— Authenticate with your accountagentduty install— Set up Claude Code hooks
Build from source:
cd cli && go build -o /tmp/agentduty .Web App
The web app is built with Next.js 14, Drizzle ORM, and Neon (serverless Postgres). It provides:
- Slack Events API integration for message routing
- GraphQL API for the CLI
- Dashboard for managing sessions and settings
Installation
Install the CLI with a single command:
curl -fsSL https://raw.githubusercontent.com/sestinj/agentduty/main/install.sh | shThen:
agentduty login
agentduty installDevelopment
Prerequisites
- Node.js 20+
- Go 1.24+
- A Neon database (or local Postgres)
Web App
cd web
cp .env.example .env.local # Configure your environment
npm install
npm run devCLI
cd cli
go build -o /tmp/agentduty .
go test ./...Tests
# Web tests (Vitest)
cd web && npm test
# CLI tests (Go)
cd cli && go test ./...Deploying
- Web app: Deploys to Vercel. Always deploy from the
web/directory:cd web && npx vercel --prod
- CLI: Releases are built automatically via GoReleaser when a version tag is pushed.
Contributing
See CONTRIBUTING.md for development setup, coding standards, and the PR process.
License
Apache-2.0 — see LICENSE for details.
Copyright (c) 2025 Continue Dev, Inc.