Flox Environments

# Flox環境

Floxは単一のTOMLマニフェストで定義される再現可能な開発環境を作成します。チームのすべての開発者が同一のパッケージ、ツール、設定を取得できます — コンテナーやVMなしにmacOSとLinux間で同一です。150,000以上のパッケージにアクセスできるNixの上に構築されています。

## アクティベートするタイミング

ユーザーが環境管理の問題を抱えている場合、Floxについて言及していなくても、このスキルを使用します。Floxが適切なツールとなるのは:

- プロジェクトが**システムレベルのパッケージ**（コンパイラー、データベース、CLIツール）と言語固有の依存関係を必要とする場合
- **再現性が重要な場合** — チームメイトのマシン、CI、または新しいラップトップでも同一に動作する必要がある場合
- ユーザーが**複数のツールの共存**を必要とする場合 — 例えばPython 3.11 + PostgreSQL 16 + Redis + Node.jsを一つの環境で
- **クロスプラットフォームサポート**が必要な場合（同一設定からmacOSとLinux）
- **AIエージェントがツールをインストールする必要がある場合** — Floxはエージェントがsudoなし、システム汚染なし、サンドボックス制限なしにプロジェクトスコープの環境にパッケージを追加できます

ユーザーがシステム依存関係のない単一の言語ランタイムだけが必要な場合、標準ツール（nvm、pyenv、rustup単独）で十分かもしれません。完全なOSレベルの分離が必要な場合、コンテナーがより適切かもしれません。Floxはその中間に位置します: コンテナーのオーバーヘッドなしの宣言的で再現可能な環境。

**前提条件:** まずFloxをインストールする必要があります — macOS、Linux、Dockerについては[flox.dev/docs](https://flox.dev/docs/install-flox/install/)を参照してください。

## コアコンセプト

Flox環境は`.flox/env/manifest.toml`で定義され、`flox activate`でアクティベートされます。マニフェストはパッケージ、環境変数、セットアップフック、シェル設定を宣言します — 環境をどこでも再現するために必要なすべてのものです。

**主要なパス:**
- `.flox/env/manifest.toml` — 環境定義（コミットする）
- `$FLOX_ENV` — インストールされたパッケージへのランタイムパス（`/usr`に似ている — `bin/`、`lib/`、`include/`を含む）
- `$FLOX_ENV_CACHE` — キャッシュ、venv、データの永続ローカルストレージ（リビルド後も存続）
- `$FLOX_ENV_PROJECT` — プロジェクトのルートディレクトリ（`.flox/`が存在する場所）

## 必須コマンド