document cli & name it to 'hfx'

Author: coyotte508

packages/hub/README.md

@@ -93,6 +93,32 @@ for await (const fileInfo of hub.listFiles({repo})) {
 await hub.deleteRepo({ repo, accessToken: "hf_..." });
 ```
 
+## CLI usage
+
+You can use `@huggingface/hub` in CLI mode to upload files and folders to your repo. 
+
+```console
+npx @huggingface/hub upload coyotte508/test-model .
+npx @huggingface/hub upload datasets/coyotte508/test-dataset .
+# Same thing
+npx @huggingface/hub upload --repo-type dataset coyotte508/test-dataset .
+# Upload new data with 0 history in a separate branch
+npx @huggingface/hub upload coyotte508/test-model . --revision release --empty
+
+npx @huggingface/hub --help
+npx @huggingface/hub upload --help
+```
+
+You can also instal globally with `npm install -g @huggingface/hub`. Then you can do:
+
+```console
+hfx upload coyotte508/test-model .
+hfx upload --repo-type dataset coyotte508/test-dataset . --revision release --empty
+
+hfx --help
+hfx  upload --help
+```
+
 ## OAuth Login
 
 It's possible to login using OAuth (["Sign in with HF"](https://huggingface.co/docs/hub/oauth)).

packages/hub/package.json

@@ -58,7 +58,7 @@
 		"face"
 	],
 	"bin": {
-		"@huggingface/hub": "./dist/cli.js"
+		"hfx": "./dist/cli.js"
 	},
 	"author": "Hugging Face",
 	"license": "MIT",

packages/hub/src/lib/create-branch.ts

@@ -23,6 +23,8 @@ export async function createBranch(params: {
 	empty?: boolean;
 	/**
 	 * Use this to overwrite the branch if it already exists.
+	 *
+	 * If you only specify `overwrite` and no `revision`/`empty`, and the branch already exists, it will be a no-op.
 	 */
 	overwrite?: boolean;
 }): Promise<void> {