ķàþî ŕüñ

Ŕüñ çöḿþöšéđ ḿüļţî-ţööļ ƒļöŵš öŕ çüšţöḿ þŕöĵéçţ ƒļöŵš. Ƒöŕ šîñĝļé ƃüîļţ-îñ ţööļš, üšé ţĥé ţöþ-ļéṽéļ ţööļ çöḿḿàñđš đîŕéçţļý (ƒöŕ éẋàḿþļé kapi translate, kapi exec qa).

Šýñöþšîš

kapi run <flow-name> [flags]
kapi flows

Đéšçŕîþţîöñ

kapi run éẋéçüţéš à ñàḿéđ ḿüļţî-šţéþ þîþéļîñé. Îţ ŕéàđš à šöüŕçé, šţŕéàḿš îţ ţĥŕöüĝĥ éàçĥ ţööļ, àñđ ŵŕîţéš ţĥé ŕéšüļţ ţö à šîñķ.

Àđ ĥöç, ţĥé šîñķ îš à ƒîļé (-o).
Îñšîđé à þŕöĵéçţ ŵîţĥ ñö -o, ţĥé ŕüñ îš þŕöçéšš-öñļý: îţ çöḿḿîţš ŕéšüļţš ţö ţĥé þŕöĵéçţ šţöŕé, àñđ kapi merge ŵŕîţéš ţĥé ƒîļéš.

Ḿüļţîþļé îñþüţ ƒîļéš çàñ ƃé þŕöçéššéđ îñ þàŕàļļéļ. Üšé --explain ţö þŕîñţ ţĥé ŕéšöļṽéđ source → sink ŵîţĥöüţ ŕüññîñĝ.

Þŕöĵéçţ-ƃàšéđ ƒļöŵš: Îƒ à .kapi þŕöĵéçţ éẋîšţš (à kapi.yaml ŕéçîþé ƒöüñđ ƃý ŵàļķîñĝ üþ ţĥé ţŕéé), ƒļöŵš àŕé ļöàđéđ ƒŕöḿ îñļîñé flows: öñ ţĥé ŕéçîþé àñđ ƒŕöḿ ţĥé ÝÀḾĻ ƒîļéš îñ ţĥé đîŕéçţöŕý ţĥé ŕéçîþé ñàḿéš ŵîţĥ flows_dir:. Ţĥîš îš ţĥé þŕîḿàŕý ḿöđé ƒöŕ ţĥé ƃöŵŕàîñ þļüĝîñ.

Ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš: Ḿüļţî-ţööļ þîþéļîñéš ļîķé translate-qa àŕé àṽàîļàƃļé àš ƃüîļţ-îñ ƒļöŵš.

Šîñĝļé ţööļš àš ţöþ-ļéṽéļ çöḿḿàñđš: Îñđîṽîđüàļ ţööļš ŕüñ đîŕéçţļý àš ţöþ-ļéṽéļ çöḿḿàñđš: kapi translate, kapi pseudo-translate, kapi exec qa, kapi exec recycle, àñđ šö öñ.

Üšé kapi flows ţö šéé àṽàîļàƃļé ƒļöŵš, öŕ kapi tools ţö šéé àṽàîļàƃļé ţööļš.

Éẋàḿþļéš

# Draft with AI (top-level tool command)
kapi translate -i input.html -o output.html --source-lang en --target-lang fr

# Draft then quality-check (composed flow)
kapi run translate-qa -i input.html -o output.html --source-lang en --target-lang fr

# Pseudo-translate for testing (top-level tool command)
kapi pseudo-translate input.html -o output.html --target-lang fr

# Process multiple files in parallel (top-level tool command)
kapi translate -i file1.html -i file2.html --source-lang en --target-lang fr -j 4

# Reuse from content memory (top-level tool command)
kapi exec recycle -i input.html -o output.html --source-lang en --target-lang fr

# Run quality checks (top-level tool command)
kapi exec qa -i translations.html -o check-report.html --target-lang fr

# Run a custom project flow
kapi run translate-review

# List available flows
kapi flows

# List available tools
kapi tools

Ƒļàĝš (ķàþî ŕüñ)

Ƒļàĝ	Šĥöŕţ	Đéšçŕîþţîöñ
`--input`	`-i`	Îñþüţ ƒîļé þàţĥ(š); ŕéþéàţ ƒöŕ ḿüļţîþļé ƒîļéš (ŕéǫüîŕéđ)
`--output`	`-o`	Öüţþüţ ƒîļé þàţĥ (šîñĝļé-ƒîļé ḿöđé); öḿîţ îñ à þŕöĵéçţ ƒöŕ à þŕöçéšš-öñļý ŕüñ ţö ţĥé šţöŕé
`--explain`		Þŕîñţ ţĥé ŕéšöļṽéđ `source → sink` ƃîñđîñĝš àñđ éẋîţ ŵîţĥöüţ ŕüññîñĝ
`--format`	`-f`	Öṽéŕŕîđé îñþüţ ƒöŕḿàţ đéţéçţîöñ
`--encoding`	`-e`	Îñþüţ éñçöđîñĝ (đéƒàüļţ: ÜŢƑ-8)
`--source-lang`		Šöüŕçé ļàñĝüàĝé, ƂÇÞ 47 (đéƒàüļţ: éñ)
`--target-lang`		Ţàŕĝéţ ļàñĝüàĝé, ƂÇÞ 47 (ŕéǫüîŕéđ)
`--concurrency`	`-j`	Ḿàẋ þàŕàļļéļ đöçüḿéñţš (0 = àüţö, 1 = šéǫüéñţîàļ)
`--provider`		ÀÎ þŕöṽîđéŕ; àñý ţĥé ţŕàñšļàţé ţööļ šüþþöŕţš
`--api-key`		ÀÞÎ ķéý ƒöŕ ţĥé ÀÎ þŕöṽîđéŕ
`--model`		Ḿöđéļ ñàḿé

:::ñöţé Ţĥé --format, --encoding, --source-lang, àñđ --target-lang ƒļàĝš àŕé šþéçîƒîç ţö kapi run àñđ ţööļ çöḿḿàñđš. Ţĥéý àŕé ñöţ ĝļöƃàļ ƒļàĝš. :::

Þŕöĵéçţ-ƃàšéđ ƒļöŵš

Îñ à þŕöĵéçţ, çŕéàţé çüšţöḿ ƒļöŵš îñ à çöḿḿîţţéđ đîŕéçţöŕý àñđ ñàḿé îţ îñ ţĥé ŕéçîþé ŵîţĥ flows_dir: flows:

# flows/translate-review.yaml
name: translate-review
description: Draft with AI then run the checks

steps:
  - tool: translate
    config:
      provider: anthropic
      model: claude-sonnet-5

  - tool: qa
    config:
      checkDoubleSpaces: true
      checkPatterns: true

  - tool: term-check
    config:
      caseSensitive: false

Ţĥé ţéŕḿ šţéþ çĥéçķš àĝàîñšţ ţĥé þŕöĵéçţ'š ţéŕḿš, ŵĥîçĥ kapi store import ŕéàđš îñţö ţĥé þŕöĵéçţ'š šţöŕé. --termstore öṽéŕŕîđéš ţĥé ţéŕḿš šţöŕé ƒöŕ à šîñĝļé ŕüñ.

Ŕüñ ŵîţĥ:

kapi run translate-review

Þŕöĵéçţ ƒļöŵš üšé ţĥé ŕéçîþé'š çöñţéñţ çöļļéçţîöñš àñđ ļöçàļé đéƒàüļţš, šö ýöü ļéàṽé öüţ --input, --output, --source-lang àñđ --target-lang. À þŕöĵéçţ ŕüñ îš þŕöçéšš-öñļý: ŕéšüļţš ļàñđ îñ ţĥé þŕöĵéçţ šţöŕé, àñđ kapi merge ŵŕîţéš ţĥé ţàŕĝéţ ƒîļéš.

Ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš

Ŵîţĥöüţ à .kapi þŕöĵéçţ, ýöü çàñ üšé ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš ŵîţĥ éẋþļîçîţ ƒļàĝš:

kapi run translate-qa -i input.html -o output.html --source-lang en --target-lang fr

Àṽàîļàƃļé ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš:

Ƒļöŵ	Đéšçŕîþţîöñ
`translate-qa`	Đŕàƒţ ţĥéñ ǫüàļîţý çĥéçķ ŵîţĥ àñ ÀÎ þŕöṽîđéŕ
`segmentation`	Šþļîţ šöüŕçé ţéẋţ îñţö šéñţéñçé šéĝḿéñţš

Ţöþ-ļéṽéļ ţööļ çöḿḿàñđš

Šîñĝļé ţööļš ŕüñ đîŕéçţļý àš ţöþ-ļéṽéļ çöḿḿàñđš:

Çöḿḿàñđ	Đéšçŕîþţîöñ
`kapi translate`	Đŕàƒţ çöñţéñţ ŵîţĥ àñ ÀÎ þŕöṽîđéŕ
`kapi pseudo-translate`	Ĝéñéŕàţé þšéüđö-ţŕàñšļàţîöñš ƒöŕ ţéšţîñĝ
`kapi exec qa`	Ŕüñ ŕüļé-ƃàšéđ ǫüàļîţý çĥéçķš
`kapi exec recycle`	Þŕé-ƒîļļ ţàŕĝéţš ƒŕöḿ çöñţéñţ ḿéḿöŕý

Ļîšţîñĝ àṽàîļàƃļé ţööļš

kapi tools

Šýñöþšîš​

Đéšçŕîþţîöñ​

Éẋàḿþļéš​

Ƒļàĝš (ķàþî ŕüñ)​

Þŕöĵéçţ-ƃàšéđ ƒļöŵš​

Ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš​

Ţöþ-ļéṽéļ ţööļ çöḿḿàñđš​

Ļîšţîñĝ àṽàîļàƃļé ţööļš​