Skip to content

File formats

Kitly's shareable files are all JSON based: readable text, safe to email, sync, and version-control. This page lists what each one is, where it comes from, and where it goes back in.

.kitlypreset

A saved parameter setup for one operation: the values you dialed in, under a name.

  • Made by: the Presets box in the Pipelines panel (and the ChannelPanel), via export.
  • Used by: import in the same Presets box. Preset packs from plugin repositories install these in bundles.
  • Share it when: a teammate should get your exact look for an operation without screenshotting sliders.

.retargetmap.json

A bone mapping between a source skeleton and a target rig, as built in Retarget Mode.

  • Made by: the "Saved Maps" section's export in Retarget.
  • Used by: "Import map from file..." in the same section.
  • Share it when: several artists retarget clips onto the same rig. Map it once, distribute the file, everyone skips the bone-matching chore.

kitly-theme.json

A complete UI theme: mode, custom palette swatches, background image reference, and font choices.

  • Made by: Export... in the Theme editor (burger menu, Theme...).
  • Used by: Import... in the same dialog.
  • Share it when: you want a studio-standard look across machines, or you've made a palette worth keeping.

.kitlyflow.json

A workflow graph: nodes, wires, parameters, and promoted inputs.

  • Made by: Export..., then Workflow file... in Workflows.
  • Used by: Open workflow, or drop the file onto a workflow canvas and choose "Add as subgraph node" or "Open".
  • Share it when: a pipeline you built should run on someone else's machine, or you want graphs in version control alongside the project.

take.json

The manifest inside an exported Take bundle. It sits next to the canonically named files (like GoblinWarrior_Diffuse.png) and describes the bundle: which slot each file fills, per modality, for that Take.

  • Made by: Export Take... in Asset Mode, in both the Copy to Directory and Zip Archive flavors.
  • Used by: whatever consumes the bundle. An engine-side import script or a pipeline tool can read it instead of guessing from filenames.

agent-presets.json

Assistant personas: name, provider, model, system prompt, description, category, tags.

  • Made by: export in the Agent / Model Presets dialog. Built-in presets are read-only and stay put.
  • Used by: import in the same dialog.
  • Share it when: the team should have the same art-director or lore-keeper personas in their Assistant.
  • project.cgproj is the project file at the root of every project folder. It travels with the project, not on its own.
  • The hidden .cgasset/ folder holds asset records, thumbnails, and lineage. Back it up with the project; never edit it.
  • asset://<id> isn't a file but a clipboard token from Copy As Reference, valid inside the project it came from.