Find your way around a workspace — the Library and Settings pages, uploading and finding files, using them in Ask, Learn and Code, and archiving or deleting a workspace.

On this page

A workspace holds the files, colleagues, memory, routines and plugins that your work draws on. Use separate workspaces to keep one client's or one team's work apart from another's. This page shows where everything is, how files work, and how to archive or delete a workspace. For sharing a workspace with other people, see Members and roles.

Switch workspaces from the switcher at the top of the panel, in the web app and the desktop app. My files is your personal workspace and is never shared.

What's in a workspace is private to it and its members. Files are never exposed as public links. Archiving a workspace keeps everything; only deleting removes it.

Your own workspace#

Everyone works in a workspace of their own. A workspace you only belong to as a member, or My files, doesn't count.

If you have none when you sign in, the web app and the desktop app ask you to make one first: Create your workspace (“Your chats, threads, files and connections live in a workspace. Anything you made without one moves into it.”). Keep the suggested name, such as “Sam's workspace”, or type your own, then choose Create workspace.

Your earlier chats, Learn topics and voice calls that weren't in a workspace move into it. Only your own move; nothing of anyone else's does. From then on, a new chat started without a workspace goes into your own workspace.

Where things are in the web app#

The rail lists Home, Code, Ask, Learn, Team and Routines, then Library. Library holds the workspace's own material:

Page What it's for
Files Documents, spreadsheets and images for Ask, Learn and Code. See Files.
Rules & instructions Standing instructions for Code work. See Rules.
Memory Facts and preferences Ysra carries across Ask conversations. See Memory.
Projects Multi-milestone plans. See Projects.

Team has its own place on the rail, with Team and Visitor questions. See Colleagues.

Settings opens from the account menu at the foot of the rail:

Group Page What it's for
Personal General Notice emails, error reports and what Ysra may do on its own. See Settings.
Signed in on Every app signed in to your account. See Sign in.
Devices Computers and servers signed in as devices. See Devices.
Usage Credits left and what used them. See Credits and usage.
Billing Plan, extra credits, payment methods, automatic top-ups and invoices. See Plans and billing.
Workspace This workspace Name, description, archive and delete. See Managing a workspace.
People Your organisation and the workspace's members. See Members and roles.
Connectors Apps (GitHub, Slack, Jira, Gmail and about thirty more), MCP servers and skills. See Plugins, connectors and skills.

Files#

Files with Upload files, a name filter, All, Documents, Images and Made by Ysra, a state filter, the order, "Search inside these files", and an empty upload area

Workspace files are read by Ysra so their contents can be searched, not just their names. Accepted types, the 100 MB limit and every other limit are on Files you can upload.

Uploading a file#

Drop files on the page or use Upload files. On the phone, add files from the camera, your photos or documents.

State Meaning What to do
Reading Being read Wait; most files take seconds
Ready Searchable —
Failed The reason shows in red, for example "This PDF is locked with a password. Remove the password and upload it again." or "Upload failed" In its details: Retry indexing reads the same file again; Re-upload replaces it. Failed in the state filter lists them

Finding a file#

Tool Finds
Filters By name, type (Documents, Images, Made by Ysra), state and order; grid or list
Search inside these files A decision, a name or a number in the contents
Made by Ysra Files Ysra created for you, such as documents, decks and spreadsheets from Ask

Using a file#

Where How
Ask Files are a source: Ysra searches and cites them. See Sources
Learn Course files become a notebook. See Study with a notebook
Code (desktop app, CLI) Attach a file to a thread — a spec, a screenshot of a bug, a design — so the work can use it
Anywhere Preview, download or open in a new tab, on iPad and in Safari too; on the phone, open in the system viewer or share

Workspace files on mobile: four files with their size, purpose and age, including a Q3 summary made by Ysra and a CSV with unsupported content, with Add files

Files on the phone.

Workspace settings on mobile: name and description, created date, Archive workspace, and a Delete workspace danger zone

This workspace: rename, archive or delete.

Managing a workspace#

This workspace holds three actions:

Action What happens
Rename Changes the name and description
Archive Everything is kept (files, conversations and the rest). The workspace stays in the switcher, labelled archived and listed last
Delete Type the workspace's name, then Delete permanently. The workspace, its files and everything read from them are removed at once and erased after 30 days. You can't undo it from the app. Projects survive without a workspace

Deleting can't be undone from the app

Archive a workspace you've finished with; delete only what you never need again. See Data, privacy and deletion.

YsraDocs