# Self-Starter

Self-Starter — an MCP server for Claude Code that runs background event probes locally without model calls. It wakes your agent only when CI fails, services crash, or log files report errors.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: hyprh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hyprh/self-starter
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/self-starter

## What it does

Self-Starter attaches an autonomous background event layer to your coding assistant. The agent drafts a short TypeScript probe, tests it, and registers it with `launchd` on macOS or `systemd` on Linux. Routine checks run purely on your machine, burning zero tokens until an event triggers.

The core engine tracks state shifts, enforces cooldowns, prevents alert spam, and halts pings during quiet hours. Once conditions match, the agent restarts with the original instructions, checks logs or CLI outputs, and evaluates whether to notify you. The integrated local console via `self-starter ui` on `127.0.0.1` handles probe inspection and alert delivery to Desktop, Telegram, Discord, or Slack.

Running probes requires macOS or Linux, a working Node.js runtime with `npx`, and access to background system daemons.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add self-starter -- npx -y self-starter
```

### Codex

**Platform CLI**
```bash
codex mcp add self-starter -- npx -y self-starter
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "self-starter": {
            "command": "npx",
            "args": [
                "-y",
                "self-starter"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "self-starter": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "self-starter"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add self-starter npx -y self-starter
```

## When to use it
- watch long CI workflows and investigate failed job logs automatically
- track local service uptime and read logs when an HTTP endpoint stays down
- monitor GPU idle state via `nvidia-smi` to queue the next training job
- route alerts from background probes to Telegram, Slack, or desktop popups

## Example prompts
- Keep watching this PR with Self-Starter, investigate any failing CI run, and continue in this conversation
- Set a probe on local port 3000: if it goes down for two minutes, trace container logs and explain the root cause
- Run `self-starter ui` to review active background probe tasks

## Similar
- [system-admin](https://affpapa.org/en/nevibecode/skills/system-admin.md) — skill · 577 installs
- [server-management](https://affpapa.org/en/nevibecode/skills/server-management.md) — skill · 76 installs
- [daily-update](https://affpapa.org/en/nevibecode/skills/daily-update.md) — skill · 2400 installs
- [background-jobs-designer](https://affpapa.org/en/nevibecode/skills/background-jobs-designer.md) — skill · 286 installs
- [self-improving-agent](https://affpapa.org/en/nevibecode/skills/self-improving-agent.md) — skill · 1078 installs
- [Webhook Automation](https://affpapa.org/en/nevibecode/skills/webhook-automation.md) — skill · 4800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
