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.