# Orbiter Dev — Claude Code Plugin

> **The Air Traffic Control for your AI Fleet** 🛸

Mobile approval companion for AI coding agents. Get push notifications, approve/deny from your phone's lock screen, track agent progress — all without leaving your IDE.

## Install

```bash
/plugin install github:orbiter-dev/claude-code-plugin
```

Or add to your project's `.claude/settings.json`:

```json
{
  "plugins": [
    { "source": "github:orbiter-dev/claude-code-plugin" }
  ]
}
```

## What You Get

### 🔔 Push Notifications
- **Permission prompts** → Approve/deny from lock screen
- **Agent idle** → Know when Claude needs your input
- **Task complete** → "It's done!" with duration and file count
- **Elicitation relay** → Answer Claude's questions from your phone

### 🛡️ Policy Engine
- Deny pattern matching (regex-based risk detection)
- Tiered risk levels (warning vs critical)
- Dynamic permission updates from mobile

### 📊 Agent HUD
- Real-time agent status on your phone
- Session lifecycle tracking
- Checkpoint timeline

### 🔧 Slash Commands
- `/approve [description]` — Request mobile approval
- `/status` — Check agent dashboard

## Requirements

- **Orbiter Dev mobile app** (iOS)
- `ORBITER_TOKEN` environment variable
- `ORBITER_SERVER_URL` (default: `http://localhost:3000`)

## Hook Coverage

| Hook Event | What It Does |
|-----------|-------------|
| PreToolUse | Deny-pattern matching → mobile approval |
| PermissionRequest | Native permission dialog intercept + input rewriting |
| PostToolUse | Fire-and-forget tool completion notification |
| Notification (4 matchers) | Approval relay, idle push, auth, elicitation |
| TaskCompleted | "Task done!" push with duration + file count |
| SessionStart | Register session, set heartbeat to working |
| SessionEnd | Session ended notification, set heartbeat to idle |

**7/20+ hook events covered** — more than any competitor.

## License

MIT (Plugin) • Proprietary (Backend + Mobile App)
