sentinal

Sentinal

  

Infrastructure monitoring tools for AI assistants. One codebase, multiple platforms.

Ask your AI assistant to check Redis health, inspect BullMQ queues, diagnose slow queries — all through natural conversation.

Platforms

| Platform | Distribution | Install | |---|---|---| | Claude, Cursor, Copilot, Cline, Warp, Gemini CLI | MCP Server (npm) | npx @md-musaraf/sentinal-mcp | | OpenClaw | ClawHub | clawhub install sentinal-redis | | ChatGPT | GPT Store | Coming soon | | Raycast | Raycast Store | Coming soon |

Modules

| Module | Status | What it monitors | |---|---|---| | Redis | ✅ Ready | Server health, memory, slow queries, clients, BullMQ queues | | Docker | 🔜 Planned | Container health, logs, resource usage | | Kubernetes | 🔜 Planned | Pod status, restart counts, resource limits | | GitHub Actions | 🔜 Planned | Workflow runs, failures, re-triggers | | Vercel | 🔜 Planned | Deployment status, rollbacks |

MCP Server

Works with any AI tool that supports Model Context Protocol — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Cline, Warp, Gemini CLI, Continue, and more.

Install

Add to your MCP client config:

{
  "mcpServers": {
    "sentinal": {
      "command": "npx",
      "args": ["@md-musaraf/sentinal-mcp"],
      "env": {
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}

Tools

| Tool | Description | |---|---| | redis_ping | Test connectivity to a Redis instance | | redis_health | Full health report — server, memory, clients, slow queries, BullMQ queues | | redis_memory | Deep memory analysis with fragmentation diagnostics | | redis_slowlog | Inspect slow queries | | bullmq_list | List all BullMQ queues with job counts per state | | bullmq_failed_jobs | Inspect failed jobs with payloads and stack traces | | bullmq_job_details | Full details of a specific job | | bullmq_stale_jobs | Find jobs stuck in active state |

Example Usage

Just ask your AI assistant:

• "Check my Redis health"
• "Are any BullMQ queues backing up?"
• "Show me failed jobs in the email-queue"
• "Why is Redis slow?"
• "How much memory is Redis using?"
• "Find stale jobs in the payment-queue"

OpenClaw Skills

Install individual skills from ClawHub:

clawhub install sentinal-redis

The skill teaches your OpenClaw assistant to monitor Redis and BullMQ using redis-cli. No code required — just install and ask.

Project Structure

sentinal/
├── core/                     # Shared knowledge and scripts
│   ├── redis/
│   ├── docker/
│   └── kubernetes/
├── platforms/
│   ├── mcp/                  # MCP Server → npm
│   ├── openclaw/             # OpenClaw Skills → ClawHub
│   ├── chatgpt/              # Custom GPT → GPT Store
│   └── raycast/              # Extension → Raycast Store
└── scripts/                  # Build and publish automation

Development

Prerequisites

• Node.js 22+
• pnpm 10+

Setup

git clone https://github.com/Musaraf-M/sentinal.git
cd sentinal
pnpm install

Build

pnpm build

Run MCP server locally

node platforms/mcp/dist/index.js

Contributing

Contributions are welcome! Areas where help is needed:

• New monitoring modules (Docker, Kubernetes, GitHub Actions)
• New platform adapters
• Bug fixes and improvements

License

MIT