Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt

Use this file to discover all available pages before exploring further.

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), 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:
StatusWhat it means
pendingQueued for extraction
processingxysq is reading the contents
readyIndexed — your agents can use it
failedSomething went wrong; see the error on the file
You’ll see the status update live in the file table. Most files are ready in seconds. Once a file is ready, its contents are part of your memory. Ask Chat about it, or have your agent recall it via MCP — the answer will draw on what’s in the file, not just the filename.

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 rolero 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 size10 MB
File typesPDF, TXT, JSON, CSV, images
Folder depthNo hard limit
Filename collisionsAuto-renamed with (N) suffix
If you need to ingest something bigger or a type that isn’t supported yet, paste the relevant text into Chat or via your agent — xysq will keep what matters.