@opencode-cloud/core 7.0.0 → 8.0.0

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "opencode-cloud-core"
-version = "7.0.0"
+version = "8.0.0"
 edition = "2024"
 rust-version = "1.88"
 license = "MIT"

package/README.md

@@ -1,6 +1,7 @@
 # opencode-cloud
 
 [![CI](https://github.com/pRizz/opencode-cloud/actions/workflows/ci.yml/badge.svg)](https://github.com/pRizz/opencode-cloud/actions/workflows/ci.yml)
+[![Mirror](https://img.shields.io/badge/mirror-gitea-blue?logo=gitea)](https://gitea.com/pRizz/opencode-cloud)
 [![crates.io](https://img.shields.io/crates/v/opencode-cloud.svg)](https://crates.io/crates/opencode-cloud)
 [![GHCR](https://img.shields.io/badge/ghcr.io-sandbox-blue?logo=github)](https://github.com/pRizz/opencode-cloud/pkgs/container/opencode-cloud-sandbox)
 [![Docker Hub](https://img.shields.io/docker/v/prizz/opencode-cloud-sandbox?label=docker&sort=semver)](https://hub.docker.com/r/prizz/opencode-cloud-sandbox)
@@ -9,7 +10,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 > [!WARNING]
-> This tool is still a work in progress and is rapidly evolving. Expect frequent updates and breaking changes. Follow updates at https://github.com/pRizz/opencode-cloud. Stability will be announced at some point. Use with caution.
+> This tool is still a work in progress and is rapidly evolving. Expect frequent updates and breaking changes. Follow updates at https://github.com/pRizz/opencode-cloud (mirror: https://gitea.com/pRizz/opencode-cloud). Stability will be announced at some point. Use with caution.
 
 A production-ready toolkit for deploying and managing [opencode](https://github.com/anomalyco/opencode) as a persistent cloud service, **sandboxed inside a Docker container** for isolation and security.
 
@@ -22,6 +23,22 @@ cargo install opencode-cloud
 opencode-cloud --version
 ```
 
+## Quick install (npm)
+
+```bash
+npx opencode-cloud@latest --version
+```
+
+```bash
+bunx opencode-cloud@latest --version
+```
+
+Or install globally:
+```bash
+npm install -g opencode-cloud
+opencode-cloud --version
+```
+
 ## Deploy to AWS
 
 [![Deploy to AWS](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?templateURL=https://opencode-cloud-templates.s3.us-east-2.amazonaws.com/cloudformation/opencode-cloud-quick.yaml)
@@ -55,7 +72,9 @@ The CLI manages the container lifecycle, so you don't need to interact with Dock
 
 ## Docker Images
 
-The sandbox container image is named **`opencode-cloud-sandbox`** (not `opencode-cloud`) to clearly distinguish it from the CLI tool. The CLI (`opencode-cloud` / `occ`) deploys and manages this sandbox container.
+The sandbox container image is named **`opencode-cloud-sandbox`** (not `opencode-cloud`) to clearly distinguish it from the CLI tool. The preferred way to use and manage the image is via the opencode-cloud CLI ([GitHub](https://github.com/pRizz/opencode-cloud), mirror: https://gitea.com/pRizz/opencode-cloud). It handles image pulling, container setup, and upgrades for you.
+
+**Why use the CLI?** It configures volumes, ports, and upgrades safely, so you don’t have to manage `docker run` flags or image updates yourself.
 
 The image is published to both registries:
 
@@ -85,6 +104,7 @@ occ start  # Pulls or builds the image as needed
 
 - **Rust 1.85+** - Install via [rustup](https://rustup.rs): `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`
 - **Docker** - For running the opencode container
+- **Supported platforms** - Linux and macOS
 
 ## Installation
 
@@ -95,10 +115,40 @@ cargo install opencode-cloud
 occ --version
 ```
 
+### Via npm
+
+```bash
+npx opencode-cloud@latest --version
+```
+
+```bash
+bunx opencode-cloud@latest --version
+```
+
+Or install globally:
+```bash
+npm install -g opencode-cloud
+occ --version
+```
+
+## First run
+
+```bash
+# Install as a system service (recommended for background use)
+occ install
+
+# Start the service
+occ start
+```
+
 ### From source (install locally)
 
 ```bash
+# GitHub (primary)
 git clone https://github.com/pRizz/opencode-cloud.git
+
+# Gitea (mirror)
+git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
 cargo install --path packages/cli-rust
 ```
@@ -106,7 +156,11 @@ cargo install --path packages/cli-rust
 ### From source (development run)
 
 ```bash
+# GitHub (primary)
 git clone https://github.com/pRizz/opencode-cloud.git
+
+# Gitea (mirror)
+git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
 just build
 cargo run -p opencode-cloud -- --version
@@ -155,6 +209,21 @@ occ update opencode
 occ update opencode --branch dev
 occ update opencode --commit <sha>
 
+# Remove the container (keeps volumes)
+occ reset container
+
+# Remove container and volumes (data loss)
+occ reset container --volumes --force
+
+# Clean bind mount contents (data loss)
+occ mount clean --force
+
+# Purge bind mounts (data loss, removes config entries)
+occ mount clean --purge --force
+
+# Factory reset host (container, volumes, mounts, config/data)
+occ reset host --force
+
 ### Webapp-triggered update (command file)
 
 When running in foreground mode (for example via `occ install`, which uses `occ start --no-daemon`),
@@ -290,7 +359,7 @@ just lint
 This is a monorepo with:
 - `packages/core` - Rust core library
 - `packages/cli-rust` - Rust CLI binary (recommended)
-- `packages/cli-node` - Node.js CLI (deprecated, directs users to cargo install)
+- `packages/cli-node` - Node.js CLI (fully supported and in parity with the Rust CLI)
 
 ### Cargo.toml Sync Requirement
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencode-cloud/core",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "Core NAPI bindings for opencode-cloud (internal package)",
   "main": "index.js",
   "types": "index.d.ts",

package/src/docker/README.dockerhub.md

@@ -2,6 +2,9 @@
 
 Opinionated container image for AI-assisted coding with opencode.
 
+Preferred usage and management is via the opencode-cloud CLI, which handles image pulls, volumes, ports, and upgrades:
+https://github.com/pRizz/opencode-cloud (mirror: https://gitea.com/pRizz/opencode-cloud)
+
 ## What is included
 
 - Ubuntu 24.04 (noble)
@@ -32,6 +35,26 @@ docker run --rm -it -p 3000:3000 ghcr.io/prizz/opencode-cloud-sandbox:latest
 
 The opencode web UI is available at `http://localhost:3000`.
 
+## Install the opencode-cloud CLI
+
+Cargo:
+
+```
+cargo install opencode-cloud
+```
+
+NPM:
+
+```
+npm install -g opencode-cloud
+```
+
+Then start the service (recommended):
+
+```
+occ start
+```
+
 ## opencode build and serve flow
 
 The Docker image builds opencode directly from the fork and runs the web server without nginx:
@@ -43,4 +66,5 @@ The Docker image builds opencode directly from the fork and runs the web server
 ## Source
 
 - Repository: https://github.com/pRizz/opencode-cloud
+- Mirror: https://gitea.com/pRizz/opencode-cloud
 - Dockerfile: packages/core/src/docker/Dockerfile

package/src/host/tunnel.rs

@@ -248,9 +248,18 @@ pub async fn test_connection(host: &HostConfig) -> Result<String, HostError> {
 #[cfg(test)]
 mod tests {
     use super::*;
+    use std::net::TcpListener;
+
+    fn can_bind_localhost() -> bool {
+        TcpListener::bind(("127.0.0.1", 0)).is_ok()
+    }
 
     #[test]
     fn test_find_available_port() {
+        if !can_bind_localhost() {
+            eprintln!("Skipping test: cannot bind to localhost in this environment.");
+            return;
+        }
         let port = find_available_port().unwrap();
         assert!(port > 0);