trycua/cua

TypeScript SDK "useHostComputerServer" example in documentation not present in NPM releases

Open

#916 opened on Jan 26, 2026

View on GitHub
 (2 comments) (1 reaction) (1 assignee)HTML (16,722 stars) (1,051 forks)batch import
bughelp wanted

Description

Hi CUA team,

I am trying to follow the official guide for using the Computer SDK in TypeScript: https://cua.ai/docs/cua/guide/get-started/using-computer-sdk

The documentation shows the following example:

import { Computer } from '@trycua/computer';

const computer = new Computer({ useHostComputerServer: true });
await computer.run(); // Connect to the host desktop

However, I encountered several issues:

  1. I installed the latest NPM release (@trycua/computer v0.1.6) and earlier versions (0.1.2, 0.1.3, 0.1.5). In all cases, useHostComputerServer is not recognized as a valid parameter in the Computer constructor.

  2. Reviewing the TypeScript source code, I can only find CloudComputer and CloudComputerConfig. There is no apparent way to construct a Computer instance that connects to the local host desktop, as described in the documentation.

  3. The Python SDK works correctly with a local computer_server, so this seems to be specific to the TypeScript SDK.

My questions:

  • Which TypeScript SDK version supports the useHostComputerServer option shown in the guide?
  • If no release exists yet, is there an official way to connect to a local host desktop from TypeScript?
  • Is there a recommended channel to get the TypeScript usage examples that match the Python functionality?

Thank you for your guidance!

Contributor guide

Tech stack
typescriptnodejs
Domain
apidocumentation
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
basic TypeScript knowledgeunderstanding of Computer SDK concepts
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50
Research direction
Investigate the TypeScript SDK source code (likely in packages/computer/ directory) to find where Computer constructor options are defined. Check if 'useHostComputerServer' exists in any unreleased branch. Compare with Python SDK's equivalent feature for reference. If the option is missing, determine if it should be added or if the documentation needs correction. Also review the latest npm release tags and changelogs to understand the version discrepancies. Coordinate with the assigned maintainer to clarify the intended API.