immich/cli
2025-09-09 20:38:17 -04:00
..
bin feat: bin for cli (#19648) 2025-07-01 08:00:41 -04:00
src fix: cli upload deletes files that failed uploading (#19140) 2025-06-12 17:32:35 -04:00
.editorconfig
.gitignore
.npmignore chore(cli): clean up files (#7955) 2024-03-14 13:09:27 -04:00
.nvmrc chore(deps): update node.js to v22.19.0 (#21509) 2025-09-05 08:43:58 -04:00
.prettierignore
.prettierrc chore(cli): auto-sort imports (#7116) 2024-02-14 09:55:40 -05:00
Dockerfile chore: use pnpm for builds (#19752) 2025-08-19 08:55:24 -04:00
eslint.config.mjs chore: finish migrating eslint config files; bump unicorn (#17200) 2025-03-31 12:18:25 +01:00
LICENSE
package.json chore: remove unused dependencies (#21736) 2025-09-09 20:38:17 -04:00
README.md fix(cli): Update build instructions for CLI (#11874) 2024-08-28 13:25:58 +00:00
tsconfig.json chore(cli): clean up files (#7955) 2024-03-14 13:09:27 -04:00
vite.config.ts fix(cli): handle patterns correctly on Windows (#10430) 2024-06-21 17:09:02 -07:00
vitest.config.ts

A command-line interface for interfacing with the self-hosted photo manager Immich.

Please see the Immich CLI documentation.

For developers

Before building the CLI, you must build the immich server and the open-api client. To build the server run the following in the server folder:

$ npm install
$ npm run build

Then, to build the open-api client run the following in the open-api folder:

$ ./bin/generate-open-api.sh

To run the Immich CLI from source, run the following in the cli folder:

$ npm install
$ npm run build
$ ts-node .

You'll need ts-node, the easiest way to install it is to use npm:

$ npm i -g ts-node

You can also build and install the CLI using

$ npm run build
$ npm install -g .