matter-workspace

Matter workspaces isolate client contexts by managing separate environments for each matter. You can create, list, switch, and close matters to keep files and history strictly separated.

Matter management workspaces support both private-practice and in-house settings by organizing matters into isolated directories. This approach maintains dedicated history and notes for each client context.

To archive closed matters, the workspace moves them under the matters/_archived directory. This preserves readability and auditability by keeping the matter.md, history.md, and notes.md files intact.

Yes, you can create a new matter workspace by running the new command with a slug. This automatically generates the necessary matter.md, history.md, and notes.md files under the matters directory.

Switching active matters updates the Active matter reference directly in the practice-level CLAUDE.md file. This ensures the current client context is accurately tracked without losing previous matter history.

Detaching a matter does not delete the workspace files. It simply removes the active matter reference, allowing you to preserve the context, history, and notes while operating outside a specific client workspace.