Skip to content

Conversation

@frontierkodiak
Copy link
Contributor

@frontierkodiak frontierkodiak commented Jan 30, 2026

Summary

  • Poll remote hosts over SSH with cache + host-status broadcast
  • Tag sessions with host/remote flags and add host badge + filter in UI
  • Treat remote sessions as read-only in the terminal (no attach/kill)

Env vars / defaults

  • AGENTBOARD_REMOTE_HOSTS: comma-separated hostnames; enables polling
  • AGENTBOARD_REMOTE_POLL_MS: default 15000
  • AGENTBOARD_REMOTE_TIMEOUT_MS: default 4000 (increase for slow SSH or cold connections)
  • AGENTBOARD_REMOTE_STALE_MS: default max(poll * 3, 15000)
  • AGENTBOARD_REMOTE_SSH_OPTS: extra ssh args (split on whitespace; keep args simple)
  • AGENTBOARD_HOST: override host label (defaults to hostname)
  • AGENTBOARD_REMOTE_ALLOW_CONTROL: default false (reserved for enabling remote control)
  • SSH prerequisites: passwordless keys (or Tailscale SSH) to each host and tmux installed

Limitations

  • Remote sessions are read-only in the UI; control is intentionally disabled unless control gating is wired (future AGENTBOARD_REMOTE_ALLOW_CONTROL=true)
  • Poller relies on tmux list-windows; malformed/unexpected lines are skipped and will not appear (use tmux output for troubleshooting)
  • SSH options parsing does not support quoted args or paths with spaces

Testing

  • Not run (not requested)

@frontierkodiak frontierkodiak marked this pull request as ready for review January 30, 2026 21:09
@frontierkodiak frontierkodiak marked this pull request as draft January 30, 2026 21:30
@gbasin
Copy link
Owner

gbasin commented Jan 31, 2026

Superseded by #40 which includes review fixes. Thanks @frontierkodiak for the original implementation - you're credited as co-author in the commits!

@gbasin gbasin closed this Jan 31, 2026
gbasin added a commit that referenced this pull request Feb 1, 2026
## Summary
- Poll remote hosts over SSH with cache + host-status broadcast
- Tag sessions with host/remote flags and add host badge + filter in UI
- Treat remote sessions as read-only in the terminal (no attach/kill)
- Add RFC 1123 hostname validation for remote hosts
- Auto-show host UI when multiple hosts are detected

## Env vars / defaults
- `AGENTBOARD_REMOTE_HOSTS`: comma-separated hostnames; enables polling
- `AGENTBOARD_REMOTE_POLL_MS`: default `15000`
- `AGENTBOARD_REMOTE_TIMEOUT_MS`: default `4000`
- `AGENTBOARD_REMOTE_STALE_MS`: default `max(poll * 3, 15000)`
- `AGENTBOARD_REMOTE_SSH_OPTS`: extra ssh args
- `AGENTBOARD_HOST`: override host label (defaults to `hostname`)

## Limitations
- Remote sessions are read-only in the UI
- SSH options parsing does not support quoted args or paths with spaces

## Credits
Based on #39 by @frontierkodiak with review fixes applied.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: frontierkodiak <frontierkodiak@gmail.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants