Skip to content

Conversation

@gbasin
Copy link
Owner

@gbasin gbasin commented Jan 31, 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

frontierkodiak and others added 2 commits January 30, 2026 19:26
- 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 AGENTBOARD_REMOTE_HOSTS
- Add showHostInfo setting to gate host UI elements
- Add accessibility attributes to HostFilterDropdown
- Add unit tests for remoteSessions parsing functions

Co-Authored-By: frontierkodiak <frontierkodiak@gmail.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add optional chaining to handle cases where config.remoteHosts may be
undefined during test imports with module cache bypassing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@gbasin gbasin merged commit 2bc167c into master Feb 1, 2026
2 checks passed
@gbasin gbasin deleted the feat/remote-host-aggregation branch February 1, 2026 01:56
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