diff options
| author | Mohamed Bassem <me@mbassem.com> | 2024-11-09 16:29:38 +0000 |
|---|---|---|
| committer | Mohamed Bassem <me@mbassem.com> | 2024-11-09 16:29:38 +0000 |
| commit | bff02d68151a543788d5df2a82fe8444592f0ed8 (patch) | |
| tree | 94c3178985419731c7cac3d28b51d2d9be3322df /docs/versioned_docs/version-v0.19.0/09-command-line.md | |
| parent | 6ccaec957476957e0eeba41269d427d1a3f1be91 (diff) | |
| download | karakeep-bff02d68151a543788d5df2a82fe8444592f0ed8.tar.zst | |
docs: Release the 0.19 docs
Diffstat (limited to 'docs/versioned_docs/version-v0.19.0/09-command-line.md')
| -rw-r--r-- | docs/versioned_docs/version-v0.19.0/09-command-line.md | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/docs/versioned_docs/version-v0.19.0/09-command-line.md b/docs/versioned_docs/version-v0.19.0/09-command-line.md new file mode 100644 index 00000000..5d404914 --- /dev/null +++ b/docs/versioned_docs/version-v0.19.0/09-command-line.md @@ -0,0 +1,109 @@ +# Command Line Tool (CLI) + +Hoarder comes with a simple CLI for those users who want to do more advanced manipulation. + +## Features + +- Manipulate bookmarks, lists and tags +- Mass import/export of bookmarks + +## Installation (NPM) + +``` +npm install -g @hoarderapp/cli +``` + + +## Installation (Docker) + +``` +docker run --rm ghcr.io/hoarder-app/hoarder-cli:release --help +``` + +## Usage + +``` +hoarder +``` + +``` +Usage: hoarder [options] [command] + +A CLI interface to interact with the hoarder api + +Options: + --api-key <key> the API key to interact with the API (env: HOARDER_API_KEY) + --server-addr <addr> the address of the server to connect to (env: HOARDER_SERVER_ADDR) + -V, --version output the version number + -h, --help display help for command + +Commands: + bookmarks manipulating bookmarks + lists manipulating lists + tags manipulating tags + whoami returns info about the owner of this API key + help [command] display help for command +``` + +And some of the subcommands: + +``` +hoarder bookmarks +``` + +``` +Usage: hoarder bookmarks [options] [command] + +Manipulating bookmarks + +Options: + -h, --help display help for command + +Commands: + add [options] creates a new bookmark + get <id> fetch information about a bookmark + update [options] <id> updates bookmark + list [options] list all bookmarks + delete <id> delete a bookmark + help [command] display help for command + +``` + +``` +hoarder lists +``` + +``` +Usage: hoarder lists [options] [command] + +Manipulating lists + +Options: + -h, --help display help for command + +Commands: + list lists all lists + delete <id> deletes a list + add-bookmark [options] add a bookmark to list + remove-bookmark [options] remove a bookmark from list + help [command] display help for command +``` + +## Optaining an API Key + +To use the CLI, you'll need to get an API key from your hoarder settings. You can validate that it's working by running: + +``` +hoarder --api-key <key> --server-addr <addr> whoami +``` + +For example: + +``` +hoarder --api-key mysupersecretkey --server-addr https://try.hoarder.app whoami +{ + id: 'j29gnbzxxd01q74j2lu88tnb', + name: 'Test User', + email: 'test@gmail.com' +} +``` |
