Kapi CLI-oppskrifter

Hver oppskrift tar én enkelt oppgave — anslå en jobb, fange opp avkutting i grensesnittet, håndheve en ordliste — angir målet, går gjennom stegene og lar deg kjøre kommandoene selv. De interaktive innbyggingene kjører den ekte kapi-binærfilen i nettleseren din: ingen installasjon, ingen server, ingen API-nøkkel. Hver kommando som vises er kommandoen som kjører.

For hva kapi er og hvordan CLI-en og Kapi Desktop henger sammen, se Kapi-oversikten. For hver kommando og hvert flagg, se kommandoreferansen.

Ad hoc eller prosjekt?

Et .kapi-prosjekt er den anbefalte arbeidsmodellen for ethvert kodelager eller innholdssett du lokaliserer gjentatte ganger. Det fanger språkene, innholdsmønstrene og flytene i en innsjekket oppskrift én gang, legger til git-aktig oppdagelse av oppskriften oppover fra enhver underkatalog, og holder et prosjektlokalt oversettelsesminne og en termbase som hver kjøring gjenbruker — slik at du slutter å gjenta flagg og begynner å bygge opp arbeid. Opprett ditt første prosjekt går gjennom oppsettet; referansen for prosjektfiler dekker oppskriftsformatet og oppdagelsesreglene.

kapi kjører også ad hoc: en kommando arbeider direkte på filene du navngir, konfigurert med flagg, uten at noe lagres — kapi ai-translate -i messages.json --target-lang fr. Det er den raske veien for engangsjobber, skripting og CI, og en fin innkjøring. Mange oppskrifter her vises ad hoc fordi de er genuine engangstilfeller; hver av dem nevner prosjektmodus-ekvivalenten der det hjelper.

Hver oppskrift er merket øverst med modusen sin — Kjører hvor som helst (ad hoc) eller Krever et .kapi-prosjekt.

Oppskrifter

Get oriented in kapi

The top-level commands, format readers, and processing tools — a 30-second tour to find your way around.

Estimate a translation job

Count blocks and source words in any supported format to size up a quote before you commission it.

Catch UI truncation early

Pseudo-translate your strings to surface clipping and missing-string bugs before real text arrives.

Where TM and termbases live

The three storage models — loose file, named store, or project store — and the flags that select each.

Enforce terminology

Import a glossary and flag terminology drift in translated files before they ship.

Prepare content for translation

Protect sensitive content, reuse past translations, and keep terminology and quality consistent — one repeatable pass before anything ships.

Pre-translate with TM + termbase

Leverage existing TM, fill the gaps, and pre-flag terminology — deterministic, no API key, before any vendor sees content.

Run a bilingual round-trip

Extract to XLIFF, hand it to a translator, merge the targets back — with full TM provenance. Project-based.

Work in a .klz workspace

A single-file, serverless workspace: extract sources in, run tools in place, merge the finished files out — config travels with the file.

Modes & bindings

How ad-hoc and project runs differ, the source/sink binding model, and when it makes sense to mix them.

Neste steg

• Installering — Homebrew, WinGet og binærnedlastinger
• Kommandoreferanse — hver kommando og hvert flagg
• Kapi Desktop — den visuelle følgesvennen for å bygge flyter og kjøre verktøy
• Bruke kapi med AI-assistenter — koble kapi til Claude Code, Cursor og mer