mirror-immich/cli
Min Idzelis 54bc9ddd69
chore: add vitest project names and fix server config root paths (#26684)
Add `name` to all vitest configs matching CI job buckets (server:unit,
server:medium, cli:unit, web:unit, e2e:server, e2e:maintenance) so they
appear as filterable @tags in the Vitest VSCode extension.

Fix `root` in server vitest configs to use an absolute path derived from
`import.meta.url` instead of `'./'`, which resolved relative to the config
file directory (`server/test/`) rather than `server/`, causing test
discovery to fail in the Vitest VSCode extension.
2026-03-04 08:20:43 -05:00
..
bin feat: bin for cli (#19648) 2025-07-01 08:00:41 -04:00
src fix(cli): delete sidecar files after upload if requested (#26353) 2026-02-20 14:54:08 +00:00
.editorconfig feat(cli) Add new CLI (#3066) 2023-07-06 09:37:47 -05:00
.gitignore test(cli): e2e testing (#5101) 2023-12-18 20:29:26 -06:00
.npmignore chore(cli): clean up files (#7955) 2024-03-14 13:09:27 -04:00
.nvmrc chore(deps): update node.js to v24.13.1 (#26275) 2026-02-17 11:45:57 +01:00
.prettierignore refactor: open api (#6334) 2024-01-12 07:36:27 -05:00
.prettierrc chore(cli): auto-sort imports (#7116) 2024-02-14 09:55:40 -05:00
Dockerfile chore(deps): update node to v24 (major) (#24169) 2025-11-25 15:40:48 +01:00
LICENSE Change license to AGPLv3 (#7046) 2024-02-12 15:31:59 +00:00
README.md feat(cli): add debug development config (#22712) 2025-10-08 17:08:33 +00:00
eslint.config.mjs chore: finish migrating eslint config files; bump unicorn (#17200) 2025-03-31 12:18:25 +01:00
mise.toml feat: mise monorepo tasks (#23691) 2025-11-10 15:55:15 +01:00
package.json chore: enable prettier caching and quiet output (#26681) 2026-03-04 03:34:48 +00:00
tsconfig.json chore(deps): update dependency eslint-plugin-unicorn to v62 (#24167) 2025-11-27 21:31:16 +00:00
vite.config.ts fix(cli): handle patterns correctly on Windows (#10430) 2024-06-21 17:09:02 -07:00
vitest.config.ts chore: add vitest project names and fix server config root paths (#26684) 2026-03-04 08:20:43 -05:00

README.md

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:

$ pnpm install
$ pnpm run build

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

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

Run from build

Go to the cli folder and build it:

$ pnpm install
$ pnpm run build
$ node dist/index.js

Run and Debug from source (VSCode)

With VScode you can run and debug the Immich CLI. Go to the launch.json file, find the Immich CLI config and change this with the command you need to debug

"args": ["upload", "--help"],

replace that for the command of your choice.

Install from build

You can also build and install the CLI using

$ pnpm run build
$ pnpm install -g .