needle-cloud 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.6.0] - 2026-09-23
+### Added
+- `upload` and `delete <identifier>` commands.
+- Experimental `aiEvaluate()` browser API.
+
+### Changed
+- Standardized CLI team selection on `--team`; deprecated `--org` remains supported as a hidden alias.
+- Improved optimize polling and prevented duplicate optimization jobs.
+- Improved browser uploads and checkout attribution without injecting a global `Buffer`.
+
 ## [2.4.6] - 2026-08-13
 ### Fixed
 - A failing command now prints a single readable error line instead of a large dump of internal code.
@@ -156,4 +166,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - add: open pages url
 
 ## [0.0.1-alpha.1] - 2024-07-06
-- initial release
+- initial release

package/README.md

@@ -28,8 +28,53 @@ npx needle-cloud help <command>    # Help for a specific command
 **Core commands:**
 - `deploy` — Deploy a website to Needle Cloud
 - `optimize` — Optimize 3D files (glTF, GLB, VRM, FBX, USD) with Draco, KTX2, and Progressive Loading
+- `list` — List content stored in Needle Cloud
+- `download` — Download a content item
+- `delete` — Move a content item to Trash
 - `login` / `logout` — Authenticate with Needle Cloud
-- `start` — Start the local license server (for editor integrations and CI/CD)
+- `start` — Start the local server for licensing, editor integrations, and MCP tools
+- `settings` — View CLI settings, including [local tool access for Needle Cloud AI](#local-tools-in-needle-cloud-ai)
+
+Manage stored content by using the identifier shown by `list`:
+
+```bash
+npx needle-cloud list
+npx needle-cloud download <identifier>
+npx needle-cloud delete <identifier>
+```
+
+Use `--team <name-or-id>` with content commands to select a team. The legacy
+`--org` option remains supported for existing scripts.
+
+Deleting content immediately frees total storage capacity, but it does not refund
+the current month's upload usage. Deleted content can be restored from Trash for
+31 days when the account has enough total storage available for it.
+
+## Local tools in Needle Cloud AI
+
+[Needle Cloud AI](https://cloud.needle.tools/team#ai) can use local tools provided by this CLI to read project files, search your code, and inspect logs. You can enable or disable local tools in an individual chat. See the [Needle Cloud AI documentation](https://engine.needle.tools/docs/cloud/#needle-cloud-ai) for how this works with your Unity or Blender project.
+
+To block Needle Cloud AI from calling tools on this machine across all chats, run:
+
+```bash
+npx needle-cloud settings remote-ai-tools false
+```
+
+To re-enable access (the default):
+
+```bash
+npx needle-cloud settings remote-ai-tools true
+```
+
+To check the current setting:
+
+```bash
+npx needle-cloud settings
+```
+
+The setting is saved in `~/.needle/settings.json` for your user account on this machine and persists across restarts. A running local server applies changes automatically; no restart is required. Disabling remote AI tools keeps the local MCP server and Unity/Blender connections available. Enabling local tools in a chat does not override this CLI setting.
+
+See the [Needle MCP documentation](https://engine.needle.tools/docs/ai/needle-mcp-server) for available tools and how to connect other AI assistants.
 
 ## CI/CD