https://github.com/opus-domini/sentinel

Host operations platform: tmux workspaces, service monitoring, alerts, metrics, runbooks, and recovery, all from the browser. Self-hosted, single Go binary.
https://github.com/opus-domini/sentinel

claude codex developer-tools devops devops-tools gemini go golang linux macos opencode remote-access runbooks sysadmin sysadmin-tools terminal terminal-web tmux tmux-session-manager web-terminal

Last synced: 7 days ago
JSON representation

Host operations platform: tmux workspaces, service monitoring, alerts, metrics, runbooks, and recovery, all from the browser. Self-hosted, single Go binary.

• Host: GitHub
• URL: https://github.com/opus-domini/sentinel
• Owner: opus-domini
• License: mit
• Created: 2026-02-07T23:22:39.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-03T05:30:25.000Z (14 days ago)
• Last Synced: 2026-04-03T08:34:38.026Z (14 days ago)
• Topics: claude, codex, developer-tools, devops, devops-tools, gemini, go, golang, linux, macos, opencode, remote-access, runbooks, sysadmin, sysadmin-tools, terminal, terminal-web, tmux, tmux-session-manager, web-terminal
• Language: Go
• Homepage: https://opus-domini.github.io/sentinel/
• Size: 5.08 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          


    

    


    
Your terminal watchtower

    


        

        

        

        

        

    



Sentinel is a host operations platform delivered as a single binary.

It gives you a realtime browser interface to manage tmux sessions, monitor services, track alerts, run operational procedures, and recover from failures — all on your own machine.

No Electron. No cloud relay. Just your host and your shell.



  Documentation •

  Releases •

  Quick Start



## Why Sentinel

- One binary, fast setup, low operational overhead.

- Realtime tmux control with session, window, and pane visibility.

- Service monitoring and control for systemd and launchd.

- Alerts, timeline, and metrics for host-level observability.

- Runbooks for executable operational procedures with job tracking.

- Recovery snapshots and restore workflows.

- Guardrails for safer destructive terminal actions.

- Multi-user session support for shared hosts and team environments.

- Optimistic and responsive UI tuned for desktop and mobile.

## Core Capabilities

- **Tmux** — Interactive PTY in the browser with tmux workspace management.

- **Multi-user sessions** — Run tmux sessions as different OS users with security allowlist and sudo integration.

- **Services** — Monitor and control systemd/launchd units from `/services`.

- **Alerts** — Deduplicated alert feed from watchtower and service health at `/alerts`.

- **Timeline** — Searchable operational audit log at `/timeline`.

- **Metrics** — System and runtime resource dashboard at `/metrics`.

- **Runbooks** — Step-by-step operational procedures with job history at `/runbooks`.

- **Recovery** — Session snapshots and restore workflows.

- **Guardrails** — Safety rules for destructive terminal actions.

- Event-driven updates over WebSocket (`/ws/events`).

- Service mode and daily autoupdate (Linux/macOS).

- Optional token auth and origin allowlist.

## Requirements

- Linux or macOS host.

- `tmux` installed for tmux workspace features.

## Quick Start

### Install

```bash

curl -fsSL https://raw.githubusercontent.com/opus-domini/sentinel/main/install.sh | bash

```

### Open Sentinel

- `http://127.0.0.1:4040`

### Validate Runtime

```bash

sentinel doctor

sentinel service status

```

### Security Baseline for Remote Access

If you expose Sentinel outside localhost (`0.0.0.0`), always configure:

- `token`

- `allowed_origins`

## Documentation

- [Getting Started](https://opus-domini.github.io/sentinel/#/guide/getting-started)

- [Architecture](https://opus-domini.github.io/sentinel/#/guide/architecture)

- [Security](https://opus-domini.github.io/sentinel/#/guide/security)

- [CLI Reference](https://opus-domini.github.io/sentinel/#/reference/cli)

- [HTTP API](https://opus-domini.github.io/sentinel/#/reference/http-api)

- [WebSocket and Events](https://opus-domini.github.io/sentinel/#/reference/websockets-events)

- [Troubleshooting](https://opus-domini.github.io/sentinel/#/troubleshooting/common-issues)

## Screenshots

### Terminal Workspace

> Manage tmux sessions, windows, and panes with realtime sync — no terminal tab juggling.

![Desktop tmux sessions](docs/assets/images/desktop-tmux-sessions.png)

> Attach to any pane with a full interactive PTY, right in the browser.

![Desktop tmux fullscreen](docs/assets/images/desktop-tmux-fullscreen.png)

> Full terminal control on mobile — touch-optimized with gesture-safe zones.



  



### Ops Control Plane

> **Services:** Monitor and control systemd/launchd services with live status, logs, and one-click actions.

![Desktop services](docs/assets/images/desktop-services.png)

> **Alerts:** Catch failures early with deduplicated alerts from watchtower and service health checks.

![Desktop alerts](docs/assets/images/desktop-alerts.png)

> **Metrics:** CPU, memory, disk, and runtime stats at a glance — no external agents needed.

![Desktop metrics](docs/assets/images/desktop-metrics.png)

> **Timeline:** Searchable audit log of every operation, alert, and service event on your host.

![Desktop timeline](docs/assets/images/desktop-timeline.png)

> **Runbooks:** Executable step-by-step procedures with job tracking and per-step output history.

![Desktop runbooks](docs/assets/images/desktop-runbooks.png)

### Settings

> Theme, token auth, storage management, and guardrails — all configurable from the UI.

![Desktop settings theme](docs/assets/images/desktop-settings-theme.png)

## Stargazers over time ⭐

[![Stargazers over time](https://starchart.cc/opus-domini/sentinel.svg?variant=adaptive)](https://starchart.cc/opus-domini/sentinel)