Přehled příkazů CLI
Najděte příkazy CLI pro nastavení, překlad a údržbu katalogů.
Přehled dostupných příkazů zobrazíte pomocí lingo --help, jejich volby pomocí lingo <command> --help. lingo --version určuje nainstalovanou generaci. Aktuální balíček je @lingo.dev/cli; projekty i18n.json používají samostatnou příručku v0.
Pokud už máte projekt i18n.json, v části Migrace najdete, které aktuální příkazy odpovídají starším pracovním postupům.
Inicializace #
lingo init vytvoří základní nastavení zdrojových a cílových jazyků a vzorů pro výběr souborů. Volba pro vynucení nahradí stávající záznamy souborů a může odstranit pokročilé volby; před překladem proto zkontrolujte výslednou konfiguraci.
Přihlášení #
lingo login uloží relaci prohlížeče nebo ověřený klíč API. Jeho lokální volba --api-key uloží klíč trvale. Globální volba u jiného příkazu platí pouze pro dané spuštění.
Odhlášení #
lingo logout vymaže trvale uložené přihlašovací údaje. Klíče z prostředí a klíče zadané při spuštění nadále platí.
Identita #
lingo whoami vypíše identitu a typ ověření; --json poskytne strojově čitelný výstup. Pokud se při potížích s připojením použijí uložené informace, nejde o online ověření.
Propojení #
lingo link uloží ID organizace a lokalizačního engine používaná při překladu souborů. ID slouží k výběru zdrojů, ale neudělují k nim přístup.
Zrušení propojení #
lingo unlink odstraní tato ID, ale zachová soubory, nastavení lokalizace i vzdálené zdroje.
Odeslání #
lingo push odešle zdrojové soubory. Nabízí různé režimy pro uložení výchozího stavu, přírůstkový překlad, doplnění chybějících cílů, obnovení klíčů a vynucené nahrazení. --wait také načte výstup. Opětovné spuštění zopakuje neúspěšné operace.
Stažení #
lingo pull načte výsledky posledního lokálně zaznamenaného spuštění a před zápisem zkontroluje hashe cílů. --dry-run zobrazí náhled plánovaných zápisů, ale i při tom může kontaktovat server.
Vymazání #
lingo purge zobrazí náhled odvozených cílů nebo je odstraní. Při filtrování podle souborů nebo jazyků odstraní ze souboru Lockfile pouze vybrané cílové záznamy; bez filtrů odstraní celý soubor Lockfile. Sdílené katalogy XCStrings přeskočí.
Extrakce #
lingo extract převede podporovaná statická volání v TypeScript/TSX na zdrojový JSONC a deklarace. Jde o lokální extrakci, nikoli o automatické přepisování nebo překlad.
Kontrola #
lingo check selže, pokud chybí cílový soubor. Pokud je přítomen .lingo/lock.json, selže také v případě, že se zdroj od posledního překladu změnil. Neprovádí žádná síťová volání a nevyžaduje klíč API. Bez souboru Lockfile kontroluje pouze to, zda cílové soubory existují. V projektech React navíc kontroluje aktuálnost katalogu a typů, kontext, osiřelé položky a chybějící překlady. Nekontroluje klíče v cílových souborech mimo React ani neposuzuje kvalitu překladů.
Vyčištění #
lingo clean okamžitě odstraní z katalogů JSONC osiřelé zdrojové záznamy a zastaralé cílové záznamy. Nemá přepínač pro zkušební běh a znovu negeneruje deklarace.
Příručka #
lingo guide [name] vypíše pokyny pro React, které jsou součástí balíčku a jsou dostupné offline. Dostupné názvy jsou index, setup-react, api a migrate; bez názvu se zobrazí rejstřík. Při zadání neznámého názvu se vypíšou dostupné možnosti. Příručka odpovídá nainstalované verzi balíčku.
Příručka pro agenty #
lingo agent-guide [name] je určen pro AI agenty. Pokud nezadáte název, vypíše příručku pro agenty, která popisuje nastavení, přihlášení a MCP server, a seznam příruček pro agenty i uživatele. Pokud název zadáte, vypíše danou příručku, a to i příručky pro technologické stacky, které v seznamu nenajdete. Příručky odpovídají nainstalované verzi balíčku.
Agent #
lingo agent setup ověří, zda mají rozpoznaní programovací agenti (Claude Code, Codex a Cursor i agent, ve kterém sám běží) nastavený Lingo.dev MCP server. U těch, kteří ho nemají, odkáže na nastavení MCP; jejich konfiguraci nikdy neupravuje. Pomocí --client můžete místo toho určit, které agenty má zkontrolovat, včetně těch, které nerozpoznal. Pokud není k dispozici žádný agent ke kontrole, skončí chybou, aniž by cokoli zapsal. V projektu také zapíše blok Lingo.dev do AGENTS.md a do existujícího souboru CLAUDE.md, pokud tento soubor neimportuje AGENTS.md, do kterého se blok zapíše místo něj; CLAUDE.md nikdy nevytváří. Pokud soubor nelze přečíst, odkazuje mimo projekt nebo obsahuje nespárované značky bloku, ponechá ho beze změny a uvede důvod. Soubor opravte a spusťte nastavení znovu. --dry-run zobrazí plán, -y provede zápis bez potvrzení a --status zobrazí nastavení rozpoznaných agentů, přičemž ignoruje --client. Nastavení s programovacím agentem obsahuje prompty, které můžete zadat svému agentovi.
Aktualizace #
lingo update použije zjištěný způsob instalace. Konkrétní verzi nainstalujete pomocí správce balíčků. Výsledky kontrol aktualizací se ukládají do cache. Kontroly se přeskakují při zjištění prostředí CI nebo při vypnutí pomocí proměnné prostředí.
Vyhodnocení #
lingo score je zaregistrován, ale v běžné nápovědě se nezobrazuje. Spouští lokální kombinace hodnoticích nástrojů a modelů přes OpenRouter a ukládá výsledky lokálně, aniž by přidával záznamy do historie Radar.