ente-cli 0.4.93 → 0.4.95

package/README.md

@@ -117,6 +117,8 @@ ente activity content read <activityId> --json
 ente activity content edit <activityId> --expected-version 42 --operations-file edits.json --json
 ente canvas boards <entityId>
 ente canvas html create <boardId> --title "Prototype" --file ./prototype.html --operation-id prototype-v1
+ente files list <entityId> --path "03 Unterlagen"
+ente files upload <entityId> ./Vertrag.pdf --folder "03 Unterlagen"   # at most 10 MiB, or --activity/--storage-id
 ente notification send --subject "Weekly brief" --text "Your brief is ready." --html-file ./brief.html --attachment ./brief.pdf --inline-image chart=./chart.png
 ente agent config show
 ente agent threads
@@ -151,6 +153,7 @@ Every command supports `--json`. Run `ente --help` or `ente <group> --help`.
 | `recording` | `list`, `show`, `inspect`, `rerun`, `orphans`, `backups` (platform key) |
 | `admin` | `tables`, `get`, `page` — read-only inspector over any table (platform key) |
 | `canvas` | `boards`, `html list`, `html get`, `html create`, `html update`, `html delete` |
+| `files` | `list`, `upload` (local file at most 10 MiB, or an activity attachment), `link`, `create-folder` — the entity's Nextcloud folder via your own connection; personal agent key only (MCP: `entity_files_list`, `entity_file_upload`, `entity_folder_link`, `entity_folder_create`) |
 | `notification` | `send` (emails only your own Ente account address; optional HTML, file attachments, and CID inline images) |
 | `agent` | `list`, `threads`, `show`, `new`, `send`, `config show`, `config set-prompt`, `schedules configure` |
 | `agent mail` | `address`, `threads`, `show`, `send`, `reply`, `mark` |

package/dist/SKILL.md

@@ -213,6 +213,15 @@ ente canvas html create <boardId> --title "Prototype" --file <html-path|-> [--pl
 ente canvas html update <boardId> <elementId> --file <html-path|-> [--title "Revised"] [--x N --y N] [--width N --height N] [--json]
 ente canvas html delete <boardId> <elementId> [--json]
 
+# Entity files: the entity's linked Nextcloud folder, through YOUR own Nextcloud
+# connection. Works only with your personal agent's key; shared agents are refused.
+# MCP/REST: entity_files_list, entity_file_upload, entity_folder_link, entity_folder_create.
+ente files list <entityId> [--path "03 Unterlagen"] [--json]
+ente files upload <entityId> <local-file> [--folder "03 Unterlagen"] [--name "Vertrag.pdf"] [--mime-type application/pdf] [--json]   # at most 10 MiB
+ente files upload <entityId> --activity <activityId> --storage-id <storageId> --name "Vertrag.pdf" [--folder …] [--json]   # copy an activity attachment
+ente files link <entityId> "Mandate/2026-017 Zebrafink" [--space <spaceId>] [--json]
+ente files create-folder <entityId> "2026-017 Zebrafink" [--parent Mandate] [--space <spaceId>] [--json]
+
 # Tasks (activities with type=task; short-ids #N, deadlines, assignees)
 # Entity task lists inherit up to 100 enabled direct children. Hierarchy scan
 # limits, more than 1,000 child task-link rows, or more than 400 child/space/type
@@ -384,6 +393,15 @@ board is already dense. The create result includes `reviewPath`. Update and dele
 read and fail on a concurrent human edit. These remote scene changes sync into open boards, but do
 not enter another browser's local undo stack.
 
+For entity files, `files list` returns a `status` (`ok`, `not_linked`, `not_connected`,
+`reconnect_required`, `no_access`, `folder_deleted`, `unreachable`, `unavailable`) instead of an
+empty list; tell the user to connect or reconnect Nextcloud in settings rather than retrying.
+Paths for `link`/`create-folder` are relative to the user's Nextcloud root; `--path`/`--folder`
+are relative to the entity's linked folder. Inline uploads are limited to 10 MiB; for an
+existing activity attachment pass `--activity` and `--storage-id` (from `activity get --json`).
+A taken file name gets a numbered suffix, nothing is overwritten. `--space` is needed only when
+the entity has several spaces with Nextcloud; the error lists the candidates.
+
 ### Recording transcripts — check them when something is unclear
 
 Activities, notes and summaries made from a recording keep only what the