Skip to content

feat(docs): add automated SSH setup and remote dev guide for VM users#3554

Open
FedericoMusa wants to merge 1 commit intoadenhq:mainfrom
FedericoMusa:feat/remote-ssh-setup-utility
Open

feat(docs): add automated SSH setup and remote dev guide for VM users#3554
FedericoMusa wants to merge 1 commit intoadenhq:mainfrom
FedericoMusa:feat/remote-ssh-setup-utility

Conversation

@FedericoMusa
Copy link

@FedericoMusa FedericoMusa commented Feb 4, 2026

Description

Brief description of the changes in this PR.

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactoring (no functional changes)

Related Issues

Fixes #3415 (Re-opening the conversation with a production-ready solution).

Changes Made

Change 1: Created scripts/setup-remote.sh to automate SSH server installation, Firewall (ufw) rules, and service restarts.

Change 2: Added a comprehensive "Remote Development Setup (SSH)" section to ENVIRONMENT_SETUP.md.

Change 3: Included a visual port-forwarding guide and IDE connection instructions for Windows/Mac hosts.

Testing

Describe the tests you ran to verify your changes:

[x] Manual testing performed: Verified the SSH tunnel stability via VS Code Remote-SSH on an Ubuntu 24.04 VM.

[x] Verified that scripts/setup-remote.sh correctly identifies existing configurations to avoid redundancy.

Checklist

  • My code follows the project's style guidelines
  • [ x] I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • [x ] I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

Screenshots (if applicable)

image

Add screenshots to demonstrate UI changes.

@FedericoMusa
Copy link
Author

This PR introduces a remote development utility and updates the documentation to support developers working within Virtual Machines (e.g., VirtualBox). It aims to eliminate UI latency and keyboard mapping issues by providing an automated SSH setup flow, as discussed in the context of the (archived) issue #3415.

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.

[Feature]: Improve observability and trust signals for autonomous agent execution

1 participant