repeatable-dev-envs-plus

Built on affaan-m/ECC by @affaan-m (255,666 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

A Claude Code skill that helps developers build safe, repeatable Flox environments for macOS and Linux.

💡 Why

Dev tools often work on one machine but fail on another.

Projects may need compilers, native libraries, fixed package versions, or local services. Installing them by hand can change the host system. Setup notes can also go out of date.

This skill helps Claude Code create and update Flox environments with clear safety rules. It fits into your current coding flow. It also knows when a simple language tool or container is a better choice.

📦 Install

Replace OWNER with the GitHub account that hosts this repo, then run:

mkdir -p ~/.claude/skills/flox-environments && curl -fsSL https://raw.githubusercontent.com/OWNER/repeatable-dev-envs-plus/main/skill/SKILL.md -o ~/.claude/skills/flox-environments/SKILL.md

That is the full install. The skill is one file and has no added dependencies.

🚀 Usage

Ask Claude Code for the environment you need:

Create a Flox environment for this Python project. Add Python 3.11, uv, ripgrep, and jq. Keep caches out of Git. Support macOS and Linux.

Expected result:

Checked flox --version.
Checked for an existing .flox directory.
Created or updated .flox/env/manifest.toml.
Added Python 3.11, uv, ripgrep, and jq.
Stored local caches under $FLOX_ENV_CACHE.
Tested the setup with flox activate -- <command>.

Claude Code will not install Flox or change the host system unless you ask. It will keep current manifest settings when it finds an existing .flox/ folder.

🔧 What we changed vs upstream

• 全体が日本語から簡潔な英語へ書き直され、長い説明や重複した表現が削減された。
• 適用条件が整理され、Floxを使う場合に加えて、単純な言語ツールやコンテナを選ぶ場合も明確になった。
• 開始前にflox --versionで確認し、依頼なしにFloxをインストール・ホスト環境を変更しないという安全策が追加された。
• 既存の.flox/やマニフェストの保護、秘密情報・キャッシュの扱い、複数OSでのテストを含む具体的な安全手順が追加された。
• コマンドやマニフェスト例は概ね維持しつつ、CIではflox activate -- <command>を使うなど実務上の指針が補強された。

📄 License

This repo is licensed under the MIT License. The upstream MIT license is preserved in UPSTREAM_LICENSE.