Automic VaultAutomic Vault

brew

immich-cli を Homebrew, Nix でインストール

immich-cli のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

インストール

追加のインストールコマンド

macOS

Homebrew確認済み · 100%
brew install immich-cli

local Homebrew formula metadata

Linux

Nix確認済み · 92%
nix profile install nixpkgs#immich-cli

nixpkgs package indexes · pkgs/by-name/im/immich-cli/package.nix · ソース: api.github.com

概要

パッケージ概要

Command-line interface for self-hosted photo manager Immich

履歴

プロジェクトの歴史と使われ方

immich-cli is the official command-line interface for Immich, the self-hosted photo and video management project. It is distributed from the Immich monorepo as the @immich/cli npm package and as an immich-cli container image.

プロジェクトの歴史

Immich's GitHub repository was created on 2022-02-03 and grew into a high-profile self-hosted alternative to cloud photo libraries. The CLI became the official automation surface for uploading photos and videos, checking server information, and authenticating with API keys outside the web and mobile clients.

The @immich/cli package metadata records publication history beginning in 2023. Official documentation describes the migration from a legacy npm package named immich to the scoped @immich/cli package, plus a Docker invocation path for users who do not want to install Node.js locally.

採用の歴史

immich-cli adoption follows Immich adoption. Repository metadata shows Immich with a very large GitHub audience, and Homebrew formula analytics show the CLI receiving thousands of installs over the measured 365-day formula window. The input metadata also records Nix packaging.

The CLI occupies a pragmatic role in the Immich ecosystem: it is the supported tool for bulk upload and scripting, while the official docs point users with Google Photos Takeout needs to the community-maintained immich-go tool.

使われ方

The official docs document login with an Immich server URL and API key, storage of credentials in auth.yml under ~/.config/immich by default, upload of files and directories, recursive upload, dry runs, album creation, duplicate handling, ignore globs, concurrency, JSON output, and environment-variable configuration.

パッケージ好きにとっての重要性

immich-cli is package-nerd significant because it is a companion CLI for a fast-moving self-hosted application, and its packaging spans npm, Docker, Homebrew, and Nix. It also demonstrates the common tradeoff that led to immich-go: official Node-based CLIs are easy for project maintainers to ship from a TypeScript monorepo, while some users prefer static single-binary migration tools.

タイムライン

  • 2022-02-03: Immich GitHub repository created.
  • 2023-11-19: @immich/cli npm package metadata records its package creation date.
  • 2025-10-01: Immich v2.0.0 stable release published.
  • 2026: Official CLI docs describe @immich/cli installation, Docker usage, auth.yml credentials, and upload commands.

Related projects

  • immich-cli is part of the Immich monorepo and depends on the Immich server API. The official CLI docs recommend immich-go for Google Photos Takeout import workflows, making the two tools related but not equivalent.

セキュリティ状態

リスクレベル: グリーン

narrow executable package without higher-risk signals.

リスク分類器

リスク グリーン · 信頼度 低 · appliance

理由

  • narrow executable package without higher-risk signals

信号

  • metadata:no-higher-risk-signals

インストール挙動

  • formula メタデータに Homebrew post-install フックは記録されていません。
  • Homebrew bottle メタデータは 1 個のプラットフォームターゲットで利用できます。
  • 1 件の実行時依存関係とともにインストールされます。

推奨レビュー

エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
~/.config/immich/auth.yml

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix
~/.config/immich/auth.yml

実行可能ファイル

インストールされる実行可能ファイル

コマンド種類公開範囲メモ
immichcliグローバル実行可能ファイル

鮮度

バージョンと鮮度

これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。

ページ生成日2026-07-08
マネージャ版3.0.1
マネージャ更新日2026-07-04
ローカルデータOK
上流not checked
検出された最新未検出

https://immich.app/docs/features/command-line-interface

インストールメタデータ

パッケージメタデータ

パッケージキーbrew:immich-cli
バージョン3.0.1
パッケージマネージャHomebrew
パッケージマネージャページhttps://formulae.brew.sh/formula/immich-cli
ホームページhttps://immich.app/docs/features/command-line-interface
リポジトリhttps://github.com/immich-app/immich
上流ドキュメントhttps://docs.immich.app/features/command-line-interface
ライセンスAGPL-3.0-only
ソースアーカイブhttps://registry.npmjs.org/@immich/cli/-/cli-3.0.1.tgz
最終更新2026-07-04T02:30:15Z
Pulseupdated
依存関係node
Bottle利用可能 (対象 all)
Homebrew post-install未定義
サービス宣言なし

レジストリ情報

ソースデータベース詳細

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameimmich-cli
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

ソースデータベース一致

他のパッケージマネージャ記録

一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。

Nix95%

immich-cli

nix profile install nixpkgs#immich-cli
  • normalized package name match
  • 一致条件: Immich Cli
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/im/immich-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Nix92%

immich

nix profile install nixpkgs#immich
  • installed executable or alias match
  • 一致条件: Immich
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/im/immich/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

ソース経路

リポジトリデータから生成

このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。

使用ソース

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment