kapi ŕüñ

Ŕüñ çöḿþöšéđ ḿüļţî-ţööļ ƒļöŵš öŕ çüšţöḿ þŕöĵéçţ ƒļöŵš. Ƒöŕ šîñĝļé ƃüîļţ-îñ ţööļš, üšé ţĥé ţöþ-ļéṽéļ ţööļ çöḿḿàñđš đîŕéçţļý (ƒöŕ éẋàḿþļé 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: öñ ţĥé ŕéçîþé àñđ ƒŕöḿ .kapi/flows/*.yaml. Ţĥîš îš ţĥé þŕîḿàŕý ḿöđé ƒöŕ ţĥé bowrain þļüĝîñ.

Ƃüîļţ-îñ çöḿþöšéđ ƒļöŵš: Ḿüļţî-ţööļ þîþéļîñéš ļîķé 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

Ƒļàĝš (kapi ŕüñ)

Ƒļàĝ	Šĥöŕţ	Đéšçŕîþţîöñ
--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 àñđ ţööļ çöḿḿàñđš. Ţĥéý àŕé ñöţ ĝļöƃàļ ƒļàĝš. :::

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

΃ ýöü'ṽé îñîţîàļîžéđ à þŕöĵéçţ ŵîţĥ kapi init, çŕéàţé çüšţöḿ ƒļöŵš îñ .kapi/flows/:

# .kapi/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

Ţĥé ţéŕḿ šţéþ çĥéçķš àĝàîñšţ ţĥé þŕöĵéçţ'š ţéŕḿš, çöḿþîļéđ ƒŕöḿ ţĥé šöüŕçé ţĥé ŕéçîþé ƃîñđš (defaults.terms_source), ñöţ öñé çöñƒîĝüŕéđ þéŕ šţéþ; --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