opencloudboxQuickstart

Let’s get the remote computer working.

opencloudbox is in technical preview. A useful support request names the failing command, the expected result, the actual result, and the provider—without including secrets.

Troubleshoot a SessionStart with local diagnostics and the current Session state.Report a reproducible bugUse GitHub issues for CLI behavior that can be shared publicly.Understand a commandCheck the v0.1 CLI contract and Project model.

Start with the state, not the symptom.

Run these checks in order. Each answer narrows the failing boundary.

Check the clientocbox agent doctor

Confirm the local agent integration and configuration can be read.

Check the Projectocbox status

Confirm the Project, chosen provider, and current Session reference.

Check file movementocbox sync diff

Inspect what will cross the boundary before changing either workspace.

Reproduce narrowlyocbox exec <command>

Use the smallest command that still produces the failure.

Include enough to reproduce it.

Redact tokens, provider credentials, repository secrets, file contents, and environment values.

CommandThe exact ocbox command

ContextCLI version, operating system, and provider

ExpectedWhat you thought would happen

ActualError text and the smallest safe log excerpt

ReproductionThe shortest repeatable sequence

Security reports need a private path.

Do not disclose a suspected vulnerability in a public issue. A verified private reporting channel and response policy will be published before service access opens.

Review the current security model