Skip to content

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.py
index 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_path
from config.settings import Settings, get_settings
PROXY_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.py
index 75bae73d..4cf79464 100644
--- a/config/paths.py
+++ b/config/paths.py
@@ -4,6 +4,8 @@ from pathlib import Path
FCC_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.py
index 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