Skip to main content
Use workspaces when one-off file drops are not enough and you need persistent context.

​
Why use workspaces

Faster responses

Keep relevant context indexed and ready.

Lower cost

Send focused context instead of large raw inputs every time.

Large folders

Work with bigger codebases and document sets.

​
Create your first workspace

1

Open The Hub

Press Shift + Cmd + H.
2

Go to Workspaces

Open the Workspaces section in the sidebar.
3

Create workspace

Click + in the workspace picker.
4

Add files and folders

Add only the resources needed for one workflow you run often.

​
How files are prepared

File typeConversion
PDFsMarkdown with page markers
DOCXMarkdown
XLSXMarkdown or CSV
ImagesOCR text extraction
DirectoriesRecursive processing
Audio and video files are not supported directly in workspaces. Transcribe them first by dropping them into Alter.

​
Local storage

Workspace data is stored locally in: 
~/Library/Application Support/Alter/Workspaces/