lingo link
Select the organization and localization engine used by a checkout, or remove that binding without deleting its files.
lingo link saves orgId and engineId in .lingo/config.json. These non-secret IDs tell file translation where to run. Your active credential still determines whether the selected resources are accessible.
lingo whoami
lingo linkLink prompts for an organization and localization engine when they are not supplied. The interactive flow can create either resource when your access allows it. For an existing selection, use --org <id> and --engine <id>; display names are not IDs.
Finish organization setup #
When you create a new organization interactively, link asks for its name and onboarding answers. Setup in the web app creates the organization's first engine from your website.
While that setup is unfinished, link lists existing engines but does not offer to create another one. If there is no available engine, it exits with a link to finish setup. Complete the web flow, then run lingo link again. This onboarding restriction does not apply to organizations you were invited to or to API-key authentication.
If you have no organization membership, or your organizations require an SSO sign-in that the session has not completed, link directs you to the web app. Create or join an organization, or sign in through its SSO provider, then retry. Supplying an organization ID does not bypass membership or SSO requirements.
Check the project you are binding #
The CLI finds the nearest ancestor .lingo/config.json. Running link inside a nested package can therefore change the ancestor project. Inspect the config path and saved IDs before pushing files. Link preserves source/target locales and file-entry settings.
A fork inherits the IDs in copied configuration, not access to the original organization's resources. Relink it to the intended localization engine. In a monorepo, use separate package configs when policies differ and run commands from their owning roots.
The localization engine supplies models and language guidance. Linking selects it without proving every attachment or optional stage is appropriate for the project; inspect its configuration before the first translation.
Unlink #
lingo unlinkUnlink removes only orgId and engineId. It keeps localization settings, files, and lockfile, and does not delete the remote localization engine or revoke credentials. Use logout for persisted login, or purge only when intentional file deletion is the task.
LINGO_API_URL selects the server that receives project content and credentials. See CLI environment settings before changing the API origin.