Skip to main content

kapi context import

kapi import [path]

Read a checkout's context files into this project's store: the terms, the voice profiles, the wording already approved, and the record of who approved it.

This is the one command that opens those files. Everything else answers from the store, so what you read here is in force for every checkout of this project on this machine, and for everyone else once they run it too. A person runs it: it is a decision about the project, and it appears in "kapi context log" with each file and the bytes that were read.

With no path it reads the project's own ".kapi" directory. Name a path to read another checkout's directory instead, when you are bringing an existing project's context across.

Running it twice changes nothing. Everything is matched by the identity the file carries, so a second read finds the store already holding what the file says. A file whose bytes have not moved since this checkout read it is skipped; --force reads it anyway.

Commandcontext import
Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

kapi context import
Flags
FlagTypeDefaultDescription
--forceboolfalseread every file, including ones whose bytes have not moved
--project, -pstringpath to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
More examples
kapi context import ../other-project/.kapi
kapi context import --force

← Back to the Command Reference