Organise is your file workspace inside xysq. Drop in PDFs, text files, screenshots, or data exports — xysq reads them, indexes the contents into your memory, and makes them available to Chat and any agent connected via MCP.
You get an Organise space for yourself, and a separate one for each team you belong to.
Opening Organise
- Personal — click Organise in the sidebar at app.xysq.ai
- Team — open a team from the Teams page and click Organise next to Vault
Both work the same way. The difference is who can see what’s in there: personal Organise is yours alone, team Organise is shared with everyone in the team.
Folders and files
Organise is a familiar folder tree on the left, file table on the right, breadcrumb on top.
You can:
- Create folders, nest them as deep as you want
- Rename or move folders and files
- Delete things you don’t need anymore
- Select multiple files and move or delete them in one go
Right-click anything for the full menu.
Uploading files
Drag files into the dropzone, or click to pick them. Uploads go straight to xysq’s storage — they never round-trip through anything else.
Supported types: PDF, plain text (.txt), Markdown (.md), JSON, CSV, and images (PNG, JPEG, etc.)
Size limit: 10 MB per file.
If you upload a file with a name that already exists in the same folder, xysq adds a suffix — report.pdf becomes report (1).pdf. Nothing gets overwritten.
What happens after upload
Every file goes through extraction:
| Status | What it means |
|---|
| pending | Queued for extraction |
| processing | xysq is reading the contents |
| ready | Indexed — your agents can use it |
| failed | Something went wrong; see the error on the file |
Use in Chat
Right-click any file or folder and pick Use in Chat. You’ll get a dialog that lets you:
- Add it to an existing conversation
- Start a new chat with it already attached
The file or folder stays pinned to that conversation, so you don’t need to re-mention it on every turn. If you pin a folder, every file inside it is in scope — and stays in scope as you add new files to that folder.
You can also @-mention files inline while chatting. See Chat for how mentions work.
Use in Chat is currently personal only. Team Chat picks up the team’s Organise contents through team vault recall instead.
The /Chats folder
When you drag a file directly into a chat window, it’s saved automatically to a folder called /Chats/<conversation title>/ in Organise. You can find it there later, but you can’t upload directly into /Chats/ from Organise — it’s managed by Chat.
If you remove a file from a conversation, it moves back out to your Organise root.
Deleting files and folders
Delete from the right-click menu. You’ll be asked whether to also remove what xysq learned from the file:
- Keep memory — the file is gone, but anything xysq extracted from it stays in your memory
- Forget it too — the file is gone and its extracted contents are removed from memory
Pick Forget it too if the file contained something you no longer want xysq to know.
Team Organise
Team Organise works the same as personal, with a few differences:
- Files belong to the team, not you
- Anyone with team access can see them
- Read/write actions follow your team role —
ro members can browse and download but can’t upload or delete
- File contents are indexed into the team vault, so the whole team’s agents can find them
Switching between personal and team Organise is just a matter of which sidebar you opened it from.
Limits
| Limit |
|---|
| File size | 10 MB |
| File types | PDF, TXT, MD, JSON, CSV, images |
| Folder depth | No hard limit |
| Filename collisions | Auto-renamed with (N) suffix |
Access from agents and code
Organise isn’t dashboard-only. The same folder tree and uploads are reachable from anything connected to your xysq account — MCP clients (Claude, Cursor, Windsurf) and the Python SDK both speak the same vault.
From an MCP client
Once you’ve connected your xysq MCP server, your agent gets these tools alongside the memory ones:
| Tool | What it does |
|---|
organise_list_folders | List every folder in the vault |
organise_get_folder | Inspect one folder + its direct children |
organise_create_folder | Create a new folder under a parent |
organise_rename_folder | Rename a folder (system folders excluded) |
organise_move_folder | Move a folder under a new parent (cascades) |
organise_delete_folder | Delete a folder + everything inside it |
organise_upload_file | Upload a file (markdown, PDF, etc.) inline |
team_id to target a team’s Organise instead of yours.
Example phrasing that lights the tools up:
- “Save this as
release-notes.md in my Releases folder.”
- “Make a folder called
quarterly-reviews and drop these three docs in.”
- “What’s in my Notes folder?”
The upload tool takes the file bytes inline (base64), so agents that can read a local file or generate document content can hand it straight to xysq without any signed-URL dance.
From the Python SDK
The organise namespace exposes the same operations as ordinary Python methods. Both async and sync clients work:
from xysq import Xysq
with Xysq() as client:
folder = client.organise.create_folder("Releases")
file = client.organise.upload_file(
"./release-notes.md",
folder_id=folder.id,
)
print(file.asset_id, file.extraction_status)
