Nastavení pomocí programovacího agenta

Nechte Claude Code, Codex nebo Cursor nastavit Lingo.dev ve vašem projektu s návody CLI pro agenty: prompty ke zkopírování, blok AGENTS.md, lingo agent setup a lingo agent-guide.

CLI obsahuje návody pro programovací agenty, jako jsou Claude Code, Codex a Cursor. Zadejte svému agentovi některý z níže uvedených promptů. Spustí lingo agent-guide, přečte si návod pro daný úkol a provede potřebné kroky ve vašem repozitáři pomocí CLI. Operace na úrovni účtu, například správa glosáře pro engine nebo připojení GitHub App, probíhají přes Lingo.dev MCP server.

Návody jsou součástí CLI, takže agent vždy čte návod pro verzi, kterou používá. Než cokoli přeloží, ukáže vám plán a odhad a počká na vaše schválení.

Prompty #

Spusťte agenta v kořenovém adresáři projektu a vložte do něj prompt.

Nastavení Lingo.dev od začátku #

text
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.

Agent:

  1. Zkontroluje, zda má k dispozici nástroje MCP pro Lingo.dev. Pokud ne, přidá server a požádá vás, abyste agenta restartovali a znovu vložili prompt.
  2. Zjistí použité technologie, najde všechny zdrojové soubory, které aplikace načítá, a spustí příslušný návod (Rails, iOS, Android, Markdoc, e-maily, knihovna i18n nebo web s dokumentací).
  3. Požádá vás o přihlášení. Až vás vyzve, spusťte npx @lingo.dev/cli@latest login ve vlastním terminálu. Klíč API nikdy nevkládejte do konverzace.
  4. Spustí lingo init a lingo link. Pokud už projekt obsahuje překlady, zkontroluje, zda v nich nejsou poškozené zástupné symboly, nepřeložený text nebo nejednotná terminologie, a opraví jen to, co schválíte.
  5. Ukáže plán a lingo push --estimate a po vašem schválení spustí překlad.
  6. Zaregistruje nové jazyky v aplikaci a nabídne připojení GitHub App.

Připojení GitHub App #

text
Connect the Lingo.dev GitHub App to this repository. Run npx @lingo.dev/cli@latest agent-guide github and follow it.

Pokud projekt ještě není nastavený, agent ho nejprve nastaví. Zkontroluje, zda má GitHub App přístup k repozitáři, a pokud ne, poskytne vám odkazy k nápravě. Nechá vás vybrat, zda má aplikace překládat po sloučení, nebo v pull requestech. Pull request s konfigurací otevře až po vašem souhlasu.

Blok AGENTS.md #

lingo init a lingo agent setup zapíšou krátký blok do AGENTS.md v kořenovém adresáři projektu, aby agent při každé další relaci věděl, že si má před lokalizací přečíst návody:

markdown
<!-- lingo:begin -->

## Lingo.dev localization

This project is localized with Lingo.dev. The config is `.lingo/config.json` next to this file. Lingo.dev commands and workflows change between versions, so do not rely on what you remember about them.

Before any localization task (translating content, adding a locale, connecting GitHub, changing the glossary or tone of voice), run `npx @lingo.dev/cli agent-guide` from this directory and follow the guide it names. The guides ship with the CLI and describe the version you run.

This block is written by `lingo init` and `lingo agent setup`. Text between the markers is replaced on the next run; keep your own notes outside them.

<!-- lingo:end -->
  • Pokud AGENTS.md chybí, vytvoří se. Text mimo značky zůstane zachován a při dalším spuštění se nahradí jen text mezi nimi.
  • Blok se přidá i do existujícího CLAUDE.md, pokud neimportuje AGENTS.md, který ho už obsahuje (@AGENTS.md). CLAUDE.md se nikdy nevytváří.
  • Pokud soubor nelze přečíst, odkazuje mimo projekt nebo obsahuje nespárované značky, zůstane beze změny a zobrazí se varování. Opravte soubor a spusťte lingo agent setup znovu.
  • Pokud chcete blok vynechat, spusťte lingo init --no-agents-md.

Když agent spustí příkaz Lingo.dev v projektu, jehož AGENTS.md nebo CLAUDE.md neobsahuje blok, CLI vypíše na stderr jeden řádek s pokynem ke spuštění lingo agent setup -y. Uživatelům ani CI se tento řádek nezobrazuje.

lingo agent setup #

bash
lingo agent setup

Zkontroluje, zda mají programovací agenti na tomto počítači (Claude Code, Codex a Cursor i agent, ve kterém příkaz běží) k dispozici Lingo.dev MCP server. U každého agenta, který ho nemá, uvede konfigurační soubor, který je potřeba upravit. Konfiguraci agentů nikdy nemění; server přidejte podle postupu v části Nastavení MCP. Při spuštění v projektu také po vašem potvrzení zapíše blok AGENTS.md.

PřepínačÚčinek
--client <name>Zkontroluje pouze zadaného agenta, i když nebyl rozpoznán: claude-code, codex nebo cursor. Lze použít opakovaně.
--dry-runUkáže, co by se změnilo, a nic nezapíše.
--statusUkáže, co je nastaveno pro rozpoznané agenty. Ignoruje --client.
-y, --yesZapíše blok bez dotazu.

Pokud není k dispozici žádný agent ke kontrole, skončí chybou a nic nezapíše.

lingo agent-guide #

bash
lingo agent-guide           # the agent guide and the list of guides
lingo agent-guide setup     # one guide

Bez zadání názvu vypíše průvodce, kterým začíná každý agent (CLI nebo MCP, přihlášení, nedokončené úvodní nastavení), a seznam průvodců. Při zadání názvu vypíše příslušného průvodce. Pokud název nezná, skončí s kódem 1 a vypíše seznam průvodců dostupných v této verzi. lingo guide zpřístupňuje průvodce lidem, kteří používají @lingo.dev/react.

Relace bez lidské obsluhy #

V cloudové relaci nebo relaci CI nastavte LINGO_API_KEY, aby se agent nemusel přihlašovat. Takový agent provede část úkolu využívající CLI a MCP server nenastavuje. V závěrečné zprávě uvede, co zbývá provést na úrovni účtu. Tyto kroky můžete dokončit ve webové aplikaci nebo pomocí agenta, který má MCP server.

Pokud je překlad odmítnut z fakturačních důvodů, CLI skončí s kódem 9, když je nutný zásah člověka (došly kredity, byl dosažen limit pro engine nebo plán nezahrnuje potřebnou funkci), a s kódem 75, když je vyčerpán denní limit tokenů. Vypíše důvod a odkaz na fakturační stránku. Návody agentům ukládají, aby při kterémkoli z těchto kódů zastavili práci.

Hlášení od agentů #

Návody žádají agenty, aby při selhání kroku a při dokončení úkolu odeslali do Lingo.dev krátké hlášení pomocí lingo agent report. Díky tomu můžeme návody zlepšovat. Hlášení obsahuje údaj o návodu a kroku, shrnutí v jedné či dvou větách, název agenta a propojenou organizaci a engine. CLI odstraní přihlašovací údaje a tajné hodnoty a každý text omezí na 500 znaků. Hlášení nikdy nezpůsobí selhání úkolu. Pokud nikdo není přihlášen nebo je telemetrie vypnutá (LINGO_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 nebo OTEL_SDK_DISABLED=true), nic se neodesílá.