# htools

**Repository Path**: graviton/htools

## Basic Information

- **Project Name**: htools
- **Description**: H tools
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# htools

A mixed-language toolbox repository.

| Tool | Language | Purpose |
| --- | --- | --- |
| [`tools/install-vscode-server.ts`](#install-a-matching-vs-code-server-on-a-remote-host) | TypeScript (Bun) | Install a VS Code Server matching the local VS Code on a remote host |
| [`oars/`](oars/README.md) | Python | Box-shaped OAR suite for water-phantom treatment-planning studies: geometry from a phantom/target/beam TOML or a tps_service plan config, with Web UI entry values and docs |

## Install a matching VS Code Server on a remote host

From the repository root, run in PowerShell or CMD, replacing the SSH target and port with your own:

```powershell
bun run tools/install-vscode-server.ts --host USER@HOST --port PORT --proxy http://127.0.0.1:10808
```

The script reads the commit hash from local `code --version` and downloads the matching Linux x64 Server only from Microsoft's official CDN at `https://vscode.download.prss.microsoft.com`. Downloads use `curl.exe` and show a live progress bar. The archive installs at `/data/yangmy/.vscode-server/bin/<commit>` by default. SSH authentication is handled by OpenSSH; no password or private key is stored in this repository. The target is not overwritten if it already exists.

Options:

```text
--host USER@HOST       SSH destination (required)
--port PORT            SSH port (default: 22)
--install-dir PATH     Server install root (default: /data/yangmy/.vscode-server)
--commit HASH          Override the commit read from local VS Code
--proxy URL            HTTP/SOCKS proxy; defaults to HTTPS_PROXY/ALL_PROXY if set
```

For Remote-SSH, configure the same server root and use the classic server layout:

```json
{
  "remote.SSH.serverInstallPath": {
    "your-ssh-host-alias": "/data/yangmy/.vscode-server"
  },
  "remote.SSH.useExecServer": false
}
```

The key in `serverInstallPath` must match the SSH host alias used to connect. If connecting directly by IP, use the exact host identifier shown in Remote-SSH. The Server commit must match the local VS Code commit. If VS Code is updated, run the script again to install the new commit.