needle-cloud 1.9.4-rc.e7733a5 → 1.9.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,9 @@ All notable changes to this package will be documented in this file.
4
4
  The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
5
5
  and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
6
6
 
7
+ ## [1.9] - 2026-04-03
8
+ - add: MCP tools
9
+
7
10
  ## [1.7.0] - 2025-02-10
8
11
  - add: MCP tools
9
12
 
package/README.md CHANGED
@@ -1,10 +1,59 @@
1
- # Needle Cloud
1
+ # Needle Cloud CLI
2
2
 
3
- Use the Needle Cloud CLI to connect to your Needle account, run optimization or deploy websites.
3
+ The official command-line interface for [Needle Cloud](https://cloud.needle.tools) deploy websites, optimize 3D assets, and manage your projects from the terminal.
4
4
 
5
- Run `npx needle-cloud help` to see all available options.
5
+ ## Getting Started
6
+
7
+ No installation needed — use `npx` to run commands directly:
8
+
9
+ ```bash
10
+ npx needle-cloud deploy ./dist --name my-project
11
+ ```
12
+
13
+ Or install globally:
14
+
15
+ ```bash
16
+ npm install -g needle-cloud
17
+ ```
18
+
19
+ **Requirements:** Node.js 18 or later.
20
+
21
+ ## Commands
22
+
23
+ ```bash
24
+ npx needle-cloud help # List all commands
25
+ npx needle-cloud help <command> # Help for a specific command
26
+ ```
27
+
28
+ **Core commands:**
29
+ - `deploy` — Deploy a website to Needle Cloud
30
+ - `optimize` — Optimize 3D files (glTF, GLB, VRM, FBX, USD) with Draco, KTX2, and Progressive Loading
31
+ - `login` / `logout` — Authenticate with Needle Cloud
32
+ - `start` — Start the local license server (for editor integrations and CI/CD)
33
+
34
+ ## CI/CD
35
+
36
+ For automated deployments, use an access token:
37
+
38
+ 1. Create a token on [your team page](https://cloud.needle.tools/team) with `read/write` permissions
39
+ 2. Pass it via `--token` or the `NEEDLE_CLOUD_TOKEN` environment variable
40
+
41
+ ```bash
42
+ npx needle-cloud deploy ./dist --name my-project --token "$NEEDLE_CLOUD_TOKEN"
43
+ ```
44
+
45
+ Or use the official [GitHub Action](https://github.com/marketplace/actions/deploy-to-needle-cloud):
46
+
47
+ ```yml
48
+ - uses: needle-tools/deploy-to-needle-cloud-action@v1
49
+ with:
50
+ token: ${{ secrets.NEEDLE_CLOUD_TOKEN }}
51
+ dir: ./dist
52
+ name: my-project
53
+ ```
6
54
 
7
55
  ## Links
8
56
 
9
57
  - [Needle Cloud](https://cloud.needle.tools)
10
- - [Needle Cloud Documentation](https://engine.needle.tools/docs/cloud/)
58
+ - [Documentation](https://engine.needle.tools/docs/cloud/)
59
+ - [Pricing](https://needle.tools/pricing)