Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
Migrate legacy env config on startup
Alishahryar1fc3ef0b5ccff
diff --git a/cli/entrypoints.py b/cli/entrypoints.pyindex ccdcc960..96c625d7 100644--- a/cli/entrypoints.py+++ b/cli/entrypoints.py@@ -21,7 +21,7 @@ from cli.process_registry import (register_pid,unregister_pid,)-from config.paths import config_dir_path, managed_env_path+from config.paths import config_dir_path, legacy_env_paths, managed_env_pathfrom config.settings import Settings, get_settingsPROXY_PREFLIGHT_PATH = "/health"@@ -49,6 +49,7 @@ def serve() -> None:try:try:while True:+ _migrate_legacy_env_if_missing()settings = get_settings()if not _run_supervised_server(settings):return@@ -92,6 +93,14 @@ def init() -> None:config_dir = config_dir_path()env_file = managed_env_path()+ migrated_from = _migrate_legacy_env_if_missing()+ if migrated_from is not None:+ print(f"Config migrated from {migrated_from} to {env_file}")+ print(+ "Edit it to set your API keys and model preferences, then run: fcc-server"+ )+ return+if env_file.exists():print(f"Config already exists at {env_file}")print("Delete it first if you want to reset to defaults.")@@ -104,6 +113,24 @@ def init() -> None:print("Edit it to set your API keys and model preferences, then run: fcc-server")+def _migrate_legacy_env_if_missing() -> Path | None:+ """Copy a legacy user env into the managed config path when absent."""++ env_file = managed_env_path()+ if env_file.exists():+ return None++ # TODO: Remove after the ~/.fcc/.env migration has had a release cycle.+ for legacy_env in legacy_env_paths():+ if not legacy_env.is_file():+ continue+ env_file.parent.mkdir(parents=True, exist_ok=True)+ shutil.copyfile(legacy_env, env_file)+ return legacy_env++ return None++def _claude_child_env(settings: Settings, base_env: Mapping[str, str]) -> dict[str, str]:diff --git a/config/paths.py b/config/paths.pyindex 75bae73d..4cf79464 100644--- a/config/paths.py+++ b/config/paths.py@@ -4,6 +4,8 @@ from pathlib import PathFCC_CONFIG_DIRNAME = ".fcc"FCC_ENV_FILENAME = ".env"+LEGACY_REPO_DIRNAME = "free-claude-code"+LEGACY_XDG_CONFIG_DIRNAME = ".config"CLAUDE_WORKSPACE_DIRNAME = "agent_workspace"FCC_LOGS_DIRNAME = "logs"SERVER_LOG_FILENAME = "server.log"@@ -21,6 +23,16 @@ def managed_env_path() -> Path:return config_dir_path() / FCC_ENV_FILENAME+def legacy_env_paths() -> tuple[Path, ...]:+ """Return legacy user env paths that can be migrated to ~/.fcc/.env."""++ home = Path.home()+ return (+ home / LEGACY_REPO_DIRNAME / FCC_ENV_FILENAME,+ home / LEGACY_XDG_CONFIG_DIRNAME / LEGACY_REPO_DIRNAME / FCC_ENV_FILENAME,+ )++def default_claude_workspace_path() -> Path:"""Return the default Claude workspace path."""diff --git a/tests/cli/test_entrypoints.py b/tests/cli/test_entrypoints.pyindex 5b0831db..33d678ab 100644--- a/tests/cli/test_entrypoints.py+++ b/tests/cli/test_entrypoints.py@@ -62,6 +62,50 @@ def test_init_copies_template_content(tmp_path: Path) -> None:assert env_file.read_text("utf-8") == template+def test_init_migrates_home_checkout_env_before_template(tmp_path: Path) -> None:+ """init() preserves users who kept config in ~/free-claude-code/.env."""+ legacy_env = tmp_path / "free-claude-code" / ".env"+ legacy_env.parent.mkdir(parents=True)+ legacy_env.write_text("MODEL=deepseek/deepseek-chat\n", encoding="utf-8")++ output, env_file = _run_init(tmp_path)++ assert env_file.read_text("utf-8") == "MODEL=deepseek/deepseek-chat\n"+ assert f"Config migrated from {legacy_env}" in output+++def test_init_migrates_legacy_xdg_env_before_template(tmp_path: Path) -> None:+ """init() preserves users who kept config in ~/.config/free-claude-code/.env."""+ legacy_env = tmp_path / ".config" / "free-claude-code" / ".env"+ legacy_env.parent.mkdir(parents=True)+ legacy_env.write_text("MODEL=open_router/free-model\n", encoding="utf-8")++ output, env_file = _run_init(tmp_path)++ assert env_file.read_text("utf-8") == "MODEL=open_router/free-model\n"+ assert f"Config migrated from {legacy_env}" in output+++def test_legacy_env_migration_does_not_overwrite_managed_env(+ tmp_path: Path,+) -> None:+ """Legacy migration never overwrites an existing ~/.fcc/.env."""+ from cli.entrypoints import _migrate_legacy_env_if_missing++ managed_env = tmp_path / ".fcc" / ".env"+ managed_env.parent.mkdir(parents=True)+ managed_env.write_text("MODEL=nvidia_nim/current\n", encoding="utf-8")+ legacy_env = tmp_path / "free-claude-code" / ".env"+ legacy_env.parent.mkdir(parents=True)+ legacy_env.write_text("MODEL=deepseek/legacy\n", encoding="utf-8")++ with patch("pathlib.Path.home", return_value=tmp_path):+ migrated_from = _migrate_legacy_env_if_missing()++ assert migrated_from is None+ assert managed_env.read_text("utf-8") == "MODEL=nvidia_nim/current\n"++def test_env_template_loader_uses_root_template_in_source_checkout() -> None:"""Source checkout fallback uses the root .env.example as the single source."""from cli.entrypoints import _load_env_template@@ -152,6 +196,30 @@ def test_serve_supervisor_restarts_when_app_requests_restart() -> None:kill_all.assert_called_once()+def test_serve_migrates_legacy_env_before_loading_settings(tmp_path: Path) -> None:+ from cli import entrypoints++ legacy_env = tmp_path / "free-claude-code" / ".env"+ legacy_env.parent.mkdir(parents=True)+ legacy_env.write_text("MODEL=deepseek/deepseek-chat\n", encoding="utf-8")+ settings = _launcher_settings()+ get_settings = MagicMock(return_value=settings)+ get_settings.cache_clear = MagicMock()++ with (+ patch("pathlib.Path.home", return_value=tmp_path),+ patch.object(entrypoints, "get_settings", get_settings),+ patch.object(entrypoints, "_run_supervised_server", return_value=False),+ patch.object(entrypoints, "kill_all_best_effort"),+ ):+ entrypoints.serve()++ assert (tmp_path / ".fcc" / ".env").read_text("utf-8") == (+ "MODEL=deepseek/deepseek-chat\n"+ )+ get_settings.assert_called_once_with()++def test_serve_handles_keyboard_interrupt_without_traceback() -> None:from cli import entrypoints