opencode-skills-collection 3.1.12 → 3.1.14

package/bundled-skills/rclone-cli/references/commands/rclone_obscure.md

@@ -0,0 +1,60 @@
+---
+title: "rclone obscure"
+description: "Obscure password for use in the rclone config file."
+versionIntroduced: v1.36
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/obscure/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_obscure/](https://rclone.org/commands/rclone_obscure/)
+# rclone obscure
+
+Obscure password for use in the rclone config file.
+
+## Synopsis
+
+In the rclone config file, human-readable passwords are
+obscured. Obscuring them is done by encrypting them and writing them
+out in base64. This is **not** a secure way of encrypting these
+passwords as rclone can decrypt them - it is to prevent "eyedropping" -
+namely someone seeing a password in the rclone config file by accident.
+
+Many equally important things (like access tokens) are not obscured in
+the config file. However it is very hard to shoulder surf a 64
+character hex token.
+
+This command can also accept a password through STDIN instead of an
+argument by passing a hyphen as an argument. This will use the first
+line of STDIN as the password not including the trailing newline.
+
+```console
+echo 'secretpassword' | rclone obscure -
+```
+
+If there is no data on STDIN to read, rclone obscure will default to
+obfuscating the hyphen itself.
+
+If you want to encrypt the config file then please use config file
+encryption - see [rclone config](/commands/rclone_config/) for more
+info.
+
+```
+rclone obscure password [flags]
+```
+
+## Options
+
+```
+  -h, --help   help for obscure
+```
+
+See the [global flags page](/flags/) for global options not listed here.
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_purge.md

@@ -0,0 +1,58 @@
+---
+title: "rclone purge"
+description: "Remove the path and all of its contents."
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/purge/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_purge/](https://rclone.org/commands/rclone_purge/)
+# rclone purge
+
+Remove the path and all of its contents.
+
+## Synopsis
+
+Remove the path and all of its contents.  Note that this does not obey
+include/exclude filters - everything will be removed.  Use the
+[delete](/commands/rclone_delete/) command if you want to selectively
+delete files. To delete empty directories only, use command
+[rmdir](/commands/rclone_rmdir/) or [rmdirs](/commands/rclone_rmdirs/).
+
+The concurrency of this operation is controlled by the `--checkers` global flag.
+However, some backends will implement this command directly, in which
+case `--checkers` will be ignored.
+
+**Important**: Since this can cause data loss, test first with the
+`--dry-run` or the `--interactive`/`-i` flag.
+
+```
+rclone purge remote:path [flags]
+```
+
+## Options
+
+```
+  -h, --help   help for purge
+```
+
+Options shared with other commands are described next.
+See the [global flags page](/flags/) for global options not listed here.
+
+### Important Options
+
+Important flags useful for most commands
+
+```text
+  -n, --dry-run         Do a trial run with no permanent changes
+  -i, --interactive     Enable interactive mode
+  -v, --verbose count   Print lots more stuff (repeat for more)
+```
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_rc.md

@@ -0,0 +1,111 @@
+---
+title: "rclone rc"
+description: "Run a command against a running rclone."
+versionIntroduced: v1.40
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rc/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_rc/](https://rclone.org/commands/rclone_rc/)
+# rclone rc
+
+Run a command against a running rclone.
+
+## Synopsis
+
+This runs a command against a running rclone.  Use the `--url` flag to
+specify an non default URL to connect on.  This can be either a
+":port" which is taken to mean <http://localhost:port> or a
+"host:port" which is taken to mean <http://host:port>.
+
+A username and password can be passed in with `--user` and `--pass`.
+
+Note that `--rc-addr`, `--rc-user`, `--rc-pass` will be read also for
+`--url`, `--user`, `--pass`.
+
+The `--unix-socket` flag can be used to connect over a unix socket like this
+
+```sh
+# start server on /tmp/my.socket
+rclone rcd --rc-addr unix:///tmp/my.socket
+# Connect to it
+rclone rc --unix-socket /tmp/my.socket core/stats
+```
+
+Arguments should be passed in as parameter=value.
+
+The result will be returned as a JSON object by default.
+
+The `--json` parameter can be used to pass in a JSON blob as an input
+instead of key=value arguments.  This is the only way of passing in
+more complicated values.
+
+The `-o`/`--opt` option can be used to set a key "opt" with key, value
+options in the form `-o key=value` or `-o key`. It can be repeated as
+many times as required. This is useful for rc commands which take the
+"opt" parameter which by convention is a dictionary of strings.
+
+```text
+-o key=value -o key2
+```
+
+Will place this in the "opt" value
+
+```json
+{"key":"value", "key2","")
+```
+
+The `-a`/`--arg` option can be used to set strings in the "arg" value. It
+can be repeated as many times as required. This is useful for rc
+commands which take the "arg" parameter which by convention is a list
+of strings.
+
+```text
+-a value -a value2
+```
+
+Will place this in the "arg" value
+
+```json
+["value", "value2"]
+```
+
+Use `--loopback` to connect to the rclone instance running `rclone rc`.
+This is very useful for testing commands without having to run an
+rclone rc server, e.g.:
+
+```sh
+rclone rc --loopback operations/about fs=/
+```
+
+Use `rclone rc` to see a list of all possible commands.
+
+```
+rclone rc commands parameter [flags]
+```
+
+## Options
+
+```
+  -a, --arg stringArray      Argument placed in the "arg" array
+  -h, --help                 help for rc
+      --json string          Input JSON - use instead of key=value args
+      --loopback             If set connect to this rclone instance not via HTTP
+      --no-output            If set, don't output the JSON result
+  -o, --opt stringArray      Option in the form name=value or name placed in the "opt" array
+      --pass string          Password to use to connect to rclone remote control
+      --unix-socket string   Path to a unix domain socket to dial to, instead of opening a TCP connection directly
+      --url string           URL to connect to rclone remote control (default "http://localhost:5572/")
+      --user string          Username to use to rclone remote control
+```
+
+See the [global flags page](/flags/) for global options not listed here.
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_rcat.md

@@ -0,0 +1,79 @@
+---
+title: "rclone rcat"
+description: "Copies standard input to file on remote."
+versionIntroduced: v1.38
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_rcat/](https://rclone.org/commands/rclone_rcat/)
+# rclone rcat
+
+Copies standard input to file on remote.
+
+## Synopsis
+
+Reads from standard input (stdin) and copies it to a single remote file.
+
+```console
+echo "hello world" | rclone rcat remote:path/to/file
+ffmpeg - | rclone rcat remote:path/to/file
+```
+
+If the remote file already exists, it will be overwritten.
+
+rcat will try to upload small files in a single request, which is
+usually more efficient than the streaming/chunked upload endpoints,
+which use multiple requests. Exact behaviour depends on the remote.
+What is considered a small file may be set through
+`--streaming-upload-cutoff`. Uploading only starts after
+the cutoff is reached or if the file ends before that. The data
+must fit into RAM. The cutoff needs to be small enough to adhere
+the limits of your remote, please see there. Generally speaking,
+setting this cutoff too high will decrease your performance.
+
+Use the `--size` flag to preallocate the file in advance at the remote end
+and actually stream it, even if remote backend doesn't support streaming.
+
+`--size` should be the exact size of the input stream in bytes. If the
+size of the stream is different in length to the `--size` passed in
+then the transfer will likely fail.
+
+Note that the upload cannot be retried because the data is not stored.
+If the backend supports multipart uploading then individual chunks can
+be retried. If you need to transfer a lot of data, you may be better
+off caching it locally and then `rclone move` it to the
+destination which can use retries.
+
+```
+rclone rcat remote:path [flags]
+```
+
+## Options
+
+```
+  -h, --help       help for rcat
+      --size int   File size hint to preallocate (default -1)
+```
+
+Options shared with other commands are described next.
+See the [global flags page](/flags/) for global options not listed here.
+
+### Important Options
+
+Important flags useful for most commands
+
+```text
+  -n, --dry-run         Do a trial run with no permanent changes
+  -i, --interactive     Enable interactive mode
+  -v, --verbose count   Print lots more stuff (repeat for more)
+```
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_rcd.md

@@ -0,0 +1,219 @@
+---
+title: "rclone rcd"
+description: "Run rclone listening to remote control commands only."
+versionIntroduced: v1.45
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcd/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_rcd/](https://rclone.org/commands/rclone_rcd/)
+# rclone rcd
+
+Run rclone listening to remote control commands only.
+
+## Synopsis
+
+This runs rclone so that it only listens to remote control commands.
+
+This is useful if you are controlling rclone via the rc API.
+
+If you pass in a path to a directory, rclone will serve that directory
+for GET requests on the URL passed in.  It will also open the URL in
+the browser when rclone is run.
+
+See the [rc documentation](/rc/) for more info on the rc flags.
+
+## Server options
+
+Use `--rc-addr` to specify which IP address and port the server should
+listen on, eg `--rc-addr 1.2.3.4:8000` or `--rc-addr :8080` to listen to all
+IPs.  By default it only listens on localhost.  You can use port
+:0 to let the OS choose an available port.
+
+If you set `--rc-addr` to listen on a public or LAN accessible IP address
+then using Authentication is advised - see the next section for info.
+
+You can use a unix socket by setting the url to `unix:///path/to/socket`
+or just by using an absolute path name.
+
+`--rc-addr` may be repeated to listen on multiple IPs/ports/sockets.
+Socket activation, described further below, can also be used to accomplish the same.
+
+`--rc-server-read-timeout` and `--rc-server-write-timeout` can be used to
+control the timeouts on the server.  Note that this is the total time
+for a transfer.
+
+`--rc-max-header-bytes` controls the maximum number of bytes the server will
+accept in the HTTP header.
+
+`--rc-baseurl` controls the URL prefix that rclone serves from.  By default
+rclone will serve from the root.  If you used `--rc-baseurl "/rclone"` then
+rclone would serve from a URL starting with "/rclone/".  This is
+useful if you wish to proxy rclone serve.  Rclone automatically
+inserts leading and trailing "/" on `--rc-baseurl`, so `--rc-baseurl "rclone"`,
+`--rc-baseurl "/rclone"` and `--rc-baseurl "/rclone/"` are all treated
+identically.
+
+`--rc-disable-zip` may be set to disable the zipping download option.
+
+### TLS (SSL)
+
+By default this will serve over http.  If you want you can serve over
+https.  You will need to supply the `--rc-cert` and `--rc-key` flags.
+If you wish to do client side certificate validation then you will need to
+supply `--rc-client-ca` also.
+
+`--rc-cert` must be set to the path of a file containing
+either a PEM encoded certificate, or a concatenation of that with the CA
+certificate. `--rc-key` must be set to the path of a file
+with the PEM encoded private key. If setting `--rc-client-ca`,
+it should be set to the path of a file with PEM encoded client certificate
+authority certificates.
+
+`--rc-min-tls-version` is minimum TLS version that is acceptable. Valid
+values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default "tls1.0").
+
+## Socket activation
+
+Instead of the listening addresses specified above, rclone will listen to all
+FDs passed by the service manager, if any (and ignore any arguments passed
+by `--rc-addr`).
+
+This allows rclone to be a socket-activated service.
+It can be configured with .socket and .service unit files as described in
+<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>.
+
+Socket activation can be tested ad-hoc with the `systemd-socket-activate`command
+
+```console
+systemd-socket-activate -l 8000 -- rclone serve
+```
+
+This will socket-activate rclone on the first connection to port 8000 over TCP.
+
+### Template
+
+`--rc-template` allows a user to specify a custom markup template for HTTP
+and WebDAV serve functions.  The server exports the following markup
+to be used within the template to server pages:
+
+| Parameter   | Subparameter | Description |
+| :---------- | :----------- | :---------- |
+| .Name       |              | The full path of a file/directory. |
+| .Title      |              | Directory listing of '.Name'. |
+| .Sort       |              | The current sort used. This is changeable via '?sort=' parameter. Possible values: namedirfirst, name, size, time (default namedirfirst). |
+| .Order      |              | The current ordering used. This is changeable via '?order=' parameter. Possible values: asc, desc (default asc). |
+| .Query      |              | Currently unused. |
+| .Breadcrumb |              | Allows for creating a relative navigation. |
+|             | .Link        | The link of the Text relative to the root. |
+|             | .Text        | The Name of the directory. |
+| .Entries    |              | Information about a specific file/directory. |
+|             | .URL         | The url of an entry. |
+|             | .Leaf        | Currently same as '.URL' but intended to be just the name. |
+|             | .IsDir       | Boolean for if an entry is a directory or not. |
+|             | .Size        | Size in bytes of the entry. |
+|             | .ModTime     | The UTC timestamp of an entry. |
+
+The server also makes the following functions available so that they can be used
+within the template. These functions help extend the options for dynamic
+rendering of HTML. They can be used to render HTML based on specific conditions.
+
+| Function   | Description |
+| :---------- | :---------- |
+| afterEpoch  | Returns the time since the epoch for the given time. |
+| contains    | Checks whether a given substring is present or not in a given string. |
+| hasPrefix   | Checks whether the given string begins with the specified prefix. |
+| hasSuffix   | Checks whether the given string end with the specified suffix. |
+
+### Authentication
+
+By default this will serve files without needing a login.
+
+You can either use an htpasswd file which can take lots of users, or
+set a single username and password with the `--rc-user` and `--rc-pass` flags.
+
+Alternatively, you can have the reverse proxy manage authentication and use the
+username provided in the configured header with `--user-from-header`  (e.g., `--rc-user-from-header=x-remote-user`).
+Ensure the proxy is trusted and headers cannot be spoofed, as misconfiguration
+may lead to unauthorized access.
+
+If either of the above authentication methods is not configured and client
+certificates are required by the `--client-ca` flag passed to the server, the
+client certificate common name will be considered as the username.
+
+Use `--rc-htpasswd /path/to/htpasswd` to provide an htpasswd file.  This is
+in standard apache format and supports MD5, SHA1 and BCrypt for basic
+authentication.  Bcrypt is recommended.
+
+To create an htpasswd file:
+
+```console
+touch htpasswd
+htpasswd -B htpasswd user
+htpasswd -B htpasswd anotherUser
+```
+
+The password file can be updated while rclone is running.
+
+Use `--rc-realm` to set the authentication realm.
+
+Use `--rc-salt` to change the password hashing salt from the default.
+
+```
+rclone rcd <path to files to serve>* [flags]
+```
+
+## Options
+
+```
+  -h, --help   help for rcd
+```
+
+Options shared with other commands are described next.
+See the [global flags page](/flags/) for global options not listed here.
+
+### RC Options
+
+Flags to control the Remote Control API
+
+```text
+      --rc                                 Enable the remote control server
+      --rc-addr stringArray                IPaddress:Port or :Port to bind server to (default localhost:5572)
+      --rc-allow-origin string             Origin which cross-domain request (CORS) can be executed from
+      --rc-baseurl string                  Prefix for URLs - leave blank for root
+      --rc-cert string                     TLS PEM key (concatenation of certificate and CA certificate)
+      --rc-client-ca string                Client certificate authority to verify clients with
+      --rc-enable-metrics                  Enable the Prometheus metrics path at the remote control server
+      --rc-files string                    Path to local files to serve on the HTTP server
+      --rc-htpasswd string                 A htpasswd file - if not provided no authentication is done
+      --rc-job-expire-duration Duration    Expire finished async jobs older than this value (default 1m0s)
+      --rc-job-expire-interval Duration    Interval to check for expired async jobs (default 10s)
+      --rc-key string                      TLS PEM Private key
+      --rc-max-header-bytes int            Maximum size of request header (default 4096)
+      --rc-min-tls-version string          Minimum TLS version that is acceptable (default "tls1.0")
+      --rc-no-auth                         Don't require auth for certain methods
+      --rc-pass string                     Password for authentication
+      --rc-realm string                    Realm for authentication
+      --rc-salt string                     Password hashing salt (default "dlPL2MqE")
+      --rc-serve                           Enable the serving of remote objects
+      --rc-serve-no-modtime                Don't read the modification time (can speed things up)
+      --rc-server-read-timeout Duration    Timeout for server reading data (default 1h0m0s)
+      --rc-server-write-timeout Duration   Timeout for server writing data (default 1h0m0s)
+      --rc-template string                 User-specified template
+      --rc-user string                     User name for authentication
+      --rc-user-from-header string         User name from a defined HTTP header
+      --rc-web-fetch-url string            URL to fetch the releases for webgui (default "https://api.github.com/repos/rclone/rclone-webui-react/releases/latest")
+      --rc-web-gui                         Launch WebGUI on localhost
+      --rc-web-gui-force-update            Force update to latest version of web gui
+      --rc-web-gui-no-open-browser         Don't open the browser automatically
+      --rc-web-gui-update                  Check and update to latest version of web gui
+```
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_rmdir.md

@@ -0,0 +1,52 @@
+---
+title: "rclone rmdir"
+description: "Remove the empty directory at path."
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rmdir/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_rmdir/](https://rclone.org/commands/rclone_rmdir/)
+# rclone rmdir
+
+Remove the empty directory at path.
+
+## Synopsis
+
+This removes empty directory given by path. Will not remove the path if it
+has any objects in it, not even empty subdirectories. Use
+command [rmdirs](/commands/rclone_rmdirs/) (or [delete](/commands/rclone_delete/)
+with option `--rmdirs`) to do that.
+
+To delete a path and any objects in it, use [purge](/commands/rclone_purge/) command.
+
+```
+rclone rmdir remote:path [flags]
+```
+
+## Options
+
+```
+  -h, --help   help for rmdir
+```
+
+Options shared with other commands are described next.
+See the [global flags page](/flags/) for global options not listed here.
+
+### Important Options
+
+Important flags useful for most commands
+
+```text
+  -n, --dry-run         Do a trial run with no permanent changes
+  -i, --interactive     Enable interactive mode
+  -v, --verbose count   Print lots more stuff (repeat for more)
+```
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->

package/bundled-skills/rclone-cli/references/commands/rclone_rmdirs.md

@@ -0,0 +1,66 @@
+---
+title: "rclone rmdirs"
+description: "Remove empty directories under the path."
+versionIntroduced: v1.35
+# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rmdirs/ and as part of making a release run "make commanddocs"
+---
+
+> **Official documentation:** [https://rclone.org/commands/rclone_rmdirs/](https://rclone.org/commands/rclone_rmdirs/)
+# rclone rmdirs
+
+Remove empty directories under the path.
+
+## Synopsis
+
+This recursively removes any empty directories (including directories
+that only contain empty directories), that it finds under the path.
+The root path itself will also be removed if it is empty, unless
+you supply the `--leave-root` flag.
+
+Use command [rmdir](/commands/rclone_rmdir/) to delete just the empty
+directory given by path, not recurse.
+
+This is useful for tidying up remotes that rclone has left a lot of
+empty directories in. For example the [delete](/commands/rclone_delete/)
+command will delete files but leave the directory structure (unless
+used with option `--rmdirs`).
+
+This will delete `--checkers` directories concurrently so
+if you have thousands of empty directories consider increasing this number.
+
+To delete a path and any objects in it, use the [purge](/commands/rclone_purge/)
+command.
+
+```
+rclone rmdirs remote:path [flags]
+```
+
+## Options
+
+```
+  -h, --help         help for rmdirs
+      --leave-root   Do not remove root directory if empty
+```
+
+Options shared with other commands are described next.
+See the [global flags page](/flags/) for global options not listed here.
+
+### Important Options
+
+Important flags useful for most commands
+
+```text
+  -n, --dry-run         Do a trial run with no permanent changes
+  -i, --interactive     Enable interactive mode
+  -v, --verbose count   Print lots more stuff (repeat for more)
+```
+
+## See Also
+
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable ul-style line-length -->
+
+* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
+
+
+<!-- markdownlint-restore -->