Skip to main content

Workspace FAQ

Should I import contexta?​

Yes. contexta is the supported Python import root for this repository.

What names should I use?​

Use Contexta for the product name, contexta for the Python package and CLI, CONTEXTA_* for environment variables, and .contexta/ for the canonical workspace root.

What is the canonical workspace root?​

The canonical workspace root is .contexta/.

Is Contexta local-first?​

Yes. Contexta is designed around a local workspace that owns metadata, records, artifacts, reports, and recovery state.

Can one repository have multiple workspaces?​

Yes. Examples often use named workspaces such as .contexta/docs-capture-ml so test data and real experiment history do not mix.