Skip to main content
Contexity can export focused context capsules from one checkout and import them into another. This lets you carry relevant work history across branches, machines, or repository clones — without manually reconstructing what the agent knew about a task. Trust state travels with the capsule and is re-evaluated on import, so a stale clone can’t silently steer a newer one.

​
Export a Capsule

Export context scoped to a specific task description:
If you need to export a specific context item rather than a full task scope, target it directly by ID:
The export command produces a capsule file you can move to another machine or pass to a teammate.

​
Preview Before Importing

Always preview a capsule before applying it. The preview shows how each item in the capsule will be classified against the target project:
The preview report groups items into four categories:
Always preview a capsule before applying it so you can see which items need review or were rejected. Applying without previewing skips a step that can catch misleading or outdated context.

​
Apply the Import

Once you’ve reviewed the preview, choose how much of the capsule to apply. Apply only items that passed safe revalidation:
Include items that need review alongside safe items (you’ll be prompted to confirm each needs-review item):

​
Trust Model

Imported context does not automatically inherit the trust level it had in the source project. Instead, Contexity re-evaluates each item against evidence in the target repository:
  • Items that can be revalidated by target repo evidence are promoted to safe
  • Items that cannot be revalidated default to candidate or needs-review
  • Items that conflict with verified target context are rejected
This prevents an old clone from silently steering a newer checkout with stale or contradictory context. The trust model ensures that moving context between projects is always an explicit, reviewable action — not an automatic override.