lf use

lf use [local|cloud] [--json]

Show the current active mode or switch it persistently. Mode is always stored in your OS user config (e.g. ~/.config/lenserfight/lenserfight.json on Linux) — the single source of truth. Repo-local .lenserfight/lenserfight.json is not updated unless you pass --project.

---

Subcommands / arguments

Argument	Description
(none)	Print the current mode and its source
local	Switch to local mode (Supabase on localhost)
cloud	Switch to cloud mode (lenserfight.com API)

---

Show current mode

lf use

Output:

  ──────────────────────────────────────
  ●  Active mode   local
     Source        /home/you/.config/lenserfight/lenserfight.json
  ──────────────────────────────────────

  Switch:  lf use cloud  ·  per-invocation: lf --cloud <cmd>

The Source line tells you whether the mode comes from:

• Your user config file (~/.config/lenserfight/lenserfight.json on Linux)
• An environment override (LF_LOCAL / LF_CLOUD / --local / --cloud flag)
• The built-in default (cloud) when no project config exists

JSON output

lf use --json

{
  "mode": "local",
  "source": "/your/project/.lenserfight/lenserfight.json",
  "configPath": "/your/project/.lenserfight/lenserfight.json"
}

---

Switch mode

lf use cloud    # switch to cloud
lf use local    # switch to local

lf use writes the mode field in .lenserfight/lenserfight.json. If the file does not exist yet, it is created. All subsequent commands in that directory use the new mode without any flags.

Example — cloud to local:

lf use local
# ✔ Switched to local mode.
# ℹ Config: /your/project/.lenserfight/lenserfight.json
# ℹ Start local services:  lf setup --mode local
# ℹ Override per-command:  lf --local <cmd>

Example — local to cloud:

lf use cloud
# ✔ Switched to cloud mode.
# ℹ Config: /your/project/.lenserfight/lenserfight.json
# ℹ Authenticate:          lf auth login
# ℹ Override per-command:  lf --cloud <cmd>

No-op: If you run lf use cloud and the project is already in cloud mode, the command exits without rewriting the file:

lf use cloud
# ℹ Already in cloud mode — nothing changed.

---

Per-invocation override

lf use sets a persistent mode. To override for a single command without touching the config file, use the global --local or --cloud flag:

lf --cloud lf status          # check cloud status without switching permanently
lf --local lf db migrate      # run a migration against local Supabase

These flags work with any lf command and are processed before the subcommand runs.

You can also export them as environment variables for the duration of a shell session:

export LF_CLOUD=1   # all lf commands in this shell use cloud mode
export LF_LOCAL=1   # all lf commands in this shell use local mode

---

Mode comparison

	local	cloud
Supabase URL	http://127.0.0.1:54321	https://<your-project>.supabase.co
API base URL	http://localhost:8786	https://api.lenserfight.com
Auth required	No (local dev keys used)	Yes — run lf auth login
Prerequisites	Docker + Supabase CLI + lf setup --mode local	Node ≥ 22, network access

---

Flags

Flag	Description
--json	Emit mode, source, and config path as JSON (only valid without a positional argument)

---

Related commands

• lf init — Initialize a new project config, optionally passing --mode local|cloud
• lf status — Shows the active mode in the Mode row alongside auth and environment state
• lf auth login — Authenticate with the cloud API (required after switching to cloud)
• lf setup — Guided onboarding wizard; accepts --mode local|cloud
• lf doctor — Validate environment health for the active mode
• Configuration — Full reference for .lenserfight/lenserfight.json