Skip to content

remote-access.md

Latest commit

 

History

History
103 lines (69 loc) · 1.78 KB

remote-access.md

File metadata and controls

103 lines (69 loc) · 1.78 KB

Remote Access

SSH + tmux

Gate runs in a persistent tmux session. Connect via SSH and attach:

ssh your-gate-host
tmux attach -t gate

The TUI dashboard shows active reviews, queue, health, recent reviews, and log tail.

tmux Keybindings

Key Action
q Quit TUI (stops server)
r Refresh all panels
c Cancel selected review
d Show pane capture for selected review
l Toggle log tail panel
Ctrl-b d Detach from tmux (leave running)

Quick Status (No tmux)

Check gate status without attaching to tmux:

ssh your-gate-host gate status

Output:

gate v0.1.0

Active reviews (1):
  PR #42 — logic (running)

Queued (0):

Health: all OK

Tailscale

Gate uses Tailscale for reliable remote access. The health check monitors Tailscale status and alerts if it goes down.

# From any Tailscale device
ssh user@your-host.tailnet.ts.net

Phone Access

View Status

  • SSH from Termius/Blink: ssh your-gate-host then gate status
  • ntfy push notifications for all review events

Control Actions

From GitHub (phone or desktop):

Action How
Re-run a review Add gate-rerun label
Skip a review Add gate-skip label
Emergency bypass Add gate-emergency-bypass label
Block auto-fix Add gate-no-fix label

Cancel a Review

ssh your-gate-host gate cancel --pr 42

Headless Mode

For LaunchAgent or unattended operation:

gate up --headless

Runs the server without TUI. Use gate status for monitoring.

Diagnostics

# Full health check
gate health

# Prerequisite verification
gate doctor

# Check server logs
tail -f <gate-dir>/logs/activity.log

# Check specific PR
cat <gate-dir>/logs/live/pr42.log