Skip to main content

Data on disk

Project packages​

.knoxstudio is a package (Finder treats it as a file). UTI com.knoxstudio.knoxstudio.project. Double-click opens KnoxStudio.

Inside:

PathContents
project.json or project.json.zstManifest (compressed above 4 KB). Version 2. SHA-256 checksum on save
media/Imported and captured files
proxies/Optional proxies
nests/Compound clips
luts/.cube LUTs
cache/Render cache

~/.knoxmedia (mode 0700)​

PathContents
video/ audio/ image/Generated media
docs/Converted Office/PDF Markdown
screenplay/Scripts + exports/
storyboard/Storyboard runs
roles/Character Role YAML
database/media_index.dbChat, generation records, search
config.yamlAgent config
defaults.yamlGeneration defaults
chat/Extra chat artifacts
continuity/Sequence working files
projects/autosave/Rotating project snapshots (last 5)

Legacy .{name}.autosave.json may still exist. If a project will not open, or after a crash, a snapshot picker lists the last 5 autosaves. Crash recovery Restore uses an autosave when one exists. Troubleshooting.

Secrets​

macOS Keychain: knoxchat_api_key, knoxchat_oauth_refresh. Never logged. Account metadata (user id, username, token id) in app config — not the raw key.

Back up​

Copy .knoxstudio packages and ~/.knoxmedia if you want generated assets, roles, and chat. Relink if media moved. Missing media.

This directory is not ~/.knoxcoder (KnoxCoder) and not ~/.knox (marketplace VS Code extension).