sre-agents

SRE monitoring agents for Claude Code and Codex CLI. 13 ready-to-use agents for server health, Docker, security, databases, and more.

Installation

Quick Install (Recommended)

# Install all 13 agents to ~/.claude/agents/
curl -fsSL https://raw.githubusercontent.com/merllinsbeard/codex-sre-agents/main/install.sh | bash

# Or install specific agents only
curl -fsSL .../install.sh | bash -s -- server-health docker-monitor security-audit

Via npx (claude-code-templates)

# If our agents are added to the marketplace
npx claude-code-templates --agent sre/server-health
npx claude-code-templates --agent sre/docker-monitor,sre/security-audit

Manual Installation

git clone https://github.com/merllinsbeard/codex-sre-agents
cd codex-sre-agents

# Copy agents to Claude Code
cp -r .claude/agents/* ~/.claude/agents/

Standalone Script (for Codex CLI)

git clone https://github.com/merllinsbeard/codex-sre-agents
cd codex-sre-agents

# Configure Telegram (optional)
cp .env.example .env

# Run agents via Codex CLI
./sre-agents run server-health

Agents

Agent	Description	Category
sre-server-health	CPU, RAM, disk, uptime	Monitoring
sre-docker-monitor	Container status, resources, logs	Monitoring
sre-security-audit	Ports, permissions, SSH, firewall	Security
sre-log-analyzer	Error detection in logs	Monitoring
sre-backup-monitor	Backup freshness and integrity	Maintenance
sre-performance-analyzer	Bottlenecks, database health	Monitoring
sre-cleanup-advisor	Docker cleanup recommendations	Maintenance
sre-kubernetes-health	K8s cluster status	Infrastructure
sre-database-health	PostgreSQL, MySQL, Redis	Infrastructure
sre-ssl-monitor	Certificate expiration	Security
sre-disk-analyzer	Large files, disk usage	Maintenance
sre-network-diagnostics	Connectivity, latency	Infrastructure
sre-cost-analyzer	Cloud cost analysis	Maintenance

Usage

Claude Code

After installation, use agents directly in conversation:

@sre-server-health check server status
@sre-docker-monitor analyze my containers
@sre-security-audit perform security audit
@sre-kubernetes-health check cluster health

Standalone Script (Codex CLI)

./sre-agents list                    # List agents
./sre-agents run server-health       # Run one agent
./sre-agents run                     # Run all agents
./sre-agents dry-run                 # Preview

Configuration

Telegram Notifications (for standalone script)

# .env file
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

Codex Profile

# ~/.codex/config.toml
[profiles.sre-agent]
model = "o3"

Project Structure

codex-sre-agents/
├── install.sh              # Quick installer script
├── sre-agents              # Bash runner for Codex CLI
├── agents/                 # Prompts for Codex CLI
│   └── *.md
├── .claude/agents/         # Claude Code agents (with frontmatter)
│   └── sre-*.md
├── components/agents/sre/  # Marketplace-compatible format
│   └── *.md
├── .claude-plugin/         # Plugin metadata
│   ├── manifest.json
│   └── marketplace.json
└── .env.example

Scheduling (Standalone)

systemd

cat > ~/.config/systemd/user/sre-agents.timer << EOF
[Unit]
Description=SRE Agents Timer
[Timer]
OnCalendar=*-*-* 08:00:00
Persistent=true
[Install]
WantedBy=timers.target
EOF

cat > ~/.config/systemd/user/sre-agents.service << EOF
[Unit]
Description=SRE Agents
[Service]
Type=oneshot
ExecStart=$HOME/codex-sre-agents/sre-agents run
EOF

systemctl --user daemon-reload
systemctl --user enable --now sre-agents.timer

cron

0 8 * * * $HOME/codex-sre-agents/sre-agents run

Creating Custom Agents

For Claude Code

Create ~/.claude/agents/my-agent.md:

---
name: my-agent
description: Description. Use PROACTIVELY for...
tools: Read, Bash
model: sonnet
---

You are a specialist in...

For Codex CLI

Create agents/my-agent.md:

# My Agent

Execute these commands and report...

Marketplace Integration

Compatible with aitmpl.com marketplace format.

The components/agents/sre/ directory follows the claude-code-templates structure for potential marketplace integration.

License

MIT