|
1 | 1 | # Algolia CLI |
2 | 2 |
|
3 | | -A command line interface to enable Algolia developers to interact with and configure their Algolia applications straight from a command line or terminal window. Automate common workloads, create snapshots, revert to backups, or quickly modify applications as needed! This is a lightweight tool, providing a text-only interface, that is easy to install and use! |
| 3 | +The Algolia CLI lets you work with your Algolia resources, |
| 4 | +such as indices, records, API keys, and synonyms, |
| 5 | +and from the command line. |
4 | 6 |
|
5 | 7 |  |
6 | 8 |
|
7 | 9 | ## Documentation |
8 | 10 |
|
9 | | -See the [documentation](https://algolia.com/doc/tools/cli/) for setup and usage instructions. |
| 11 | +See [Algolia CLI](https://algolia.com/doc/tools/cli/) in the Algolia documentation for setup and usage instructions. |
10 | 12 |
|
11 | 13 | ## Installation |
12 | 14 |
|
13 | | -### Build from Source |
| 15 | +### macOS |
14 | 16 |
|
15 | | -A `Makefile` is available to help installing and building the CLI. |
| 17 | +The Algolia CLI is available on [Homebrew](https://brew.sh/) and as a downloadable binary from the [releases page](https://github.com/algolia/cli/releases). |
16 | 18 |
|
17 | | -```bash |
18 | | -git clone [email protected]:algolia/cli .git && make install |
| 19 | +```sh |
| 20 | +brew install algolia/algolia-cli/algolia |
19 | 21 | ``` |
20 | 22 |
|
21 | | -### MacOS |
| 23 | +### Linux |
22 | 24 |
|
23 | | -`algolia` is available on Homebrew and as a downloadable binary from the [releases page](https://github.com/algolia/cli/releases). |
| 25 | +The Algolia CLI is available as a `.deb` package: |
24 | 26 |
|
25 | | -```bash |
26 | | -brew tap algolia/algolia-cli && brew install algolia |
| 27 | +```sh |
| 28 | +# Select the package appropriate for your platform: |
| 29 | +sudo dpkg -i algolia_*.deb |
| 30 | +``` |
| 31 | + |
| 32 | +as a `.rpm` package: |
| 33 | + |
| 34 | +```sh |
| 35 | +# Select the package appropriate for your platform |
| 36 | +sudo rpm -i algolia_*.rpm |
| 37 | +``` |
| 38 | + |
| 39 | +or as a tarball from the [releases page](https://github.com/algolia/cli/releases): |
| 40 | + |
| 41 | +```sh |
| 42 | +# Select the archive appropriate for your platform |
| 43 | +tar xvf algolia_*_linux_*.tar.gz |
27 | 44 | ``` |
28 | 45 |
|
29 | 46 | ### Windows |
30 | 47 |
|
31 | | -`algolia` is available via [Chocolatey](https://community.chocolatey.org/packages/algolia/) and as downloadable .exe files. |
| 48 | +The Algolia CLI is available via [Chocolatey](https://community.chocolatey.org/packages/algolia/) and as a downloadable binary from the [releases page](https://github.com/algolia/cli/releases) |
32 | 49 |
|
33 | | -#### Chocolatey |
| 50 | +### Community packages |
34 | 51 |
|
35 | | -| Install: | Upgrade: | |
36 | | -| ------------------ | ------------------ | |
37 | | -| `choco install algolia` | `choco upgrade algolia` | |
| 52 | +Other packages are maintained by the community, not by Algolia. |
| 53 | +If you distribute a package for the Algolia CLI, create a pull request so that we can list it here! |
38 | 54 |
|
39 | | -#### Executable |
| 55 | +### Build from source |
40 | 56 |
|
41 | | -Executable files are available on the [releases page](https://github.com/algolia/cli/releases). |
| 57 | +To build the Algolia CLI from source, you'll need: |
42 | 58 |
|
43 | | -### Other platforms |
| 59 | +- Go version 1.23 or later |
| 60 | +- [Go task](https://taskfile.dev/) |
44 | 61 |
|
45 | | -Download packaged binaries from the [releases page](https://github.com/algolia/cli/releases). |
| 62 | +1. Clone the repo: `git clone https://github.com/kai687/cli.git algolia-cli && cd algolia-cli` |
| 63 | +1. Run: `task build` |
46 | 64 |
|
47 | 65 | ## Support |
48 | 66 |
|
49 | | -Found a bug on the CLI? [Open a new issue](https://github.com/algolia/cli/issues/new) or [contact the support](https://www.algolia.com/support/) to get help with Algolia! |
| 67 | +If you found an issue with the Algolia CLI, |
| 68 | +[open a new GitHub issue](https://github.com/algolia/cli/issues/new), |
| 69 | +or join the Algolia community on [Discord](https://alg.li/discord). |
0 commit comments