Your Yandex Disk from the terminal, for you and for Claude Code, Codex, Cursor or any AI agent. Search the text of the folders you choose on your computer, and work with the files live.
- Your documents, searchable on your computer. Choose the Disk folders that matter. Their text is copied into WireCat's local store, and one search finds it by words and word forms, and by meaning once indexed.
- The whole Disk, live. List, read, download, upload, copy, move, delete to the trash, restore and share files without opening a browser.
- Safe to give to an agent. Deleting and public links ask first at a terminal, and one setting turns either off for an agent.
- Find a document by what is in it. "Where is the lease for the flat?" finds the PDF by its text, not by its file name.
- Read a file without saving it. An agent reads the text of a PDF, docx, xlsx, CSV or Markdown file on the Disk and answers from it.
- Keep the Disk tidy. Move, copy, rename into a folder, and delete to the trash, where
files restorebrings a file back. - Share on request. A public link for a file or folder, and close it again when you are done.
- See the whole picture. The copies sit next to your messages, mail, notes and meetings from the other WireCat tools, so one search covers all of them.
You: Find the lease for the flat and send Bob a link to it.
Agent: (runs ydisk personal search "lease flat")
/Documents/Flat/lease-2026.pdf, signed by Alice Example on 12.03.
A public link lets anyone who has it open the file. Make one?
You: Yes.
Agent: (runs ydisk personal files publish /Documents/Flat/lease-2026.pdf --yes)
Here is the link. Say "close it" when Bob has the file.
Invented people, illustrative output.
- No WireCat server.
ydisktalks to Yandex Disk's API from your computer. There is no account with us, and the copies of your folders stay in a local store on your computer. - The official Disk API, with your own token.
ydiskuses Yandex's Disk REST API with an OAuth token from an app you register. The token stays in your system keyring and only goes to Yandex's API. - Search that understands the text. Text is read from PDF, docx, xlsx, CSV, TSV, plain text and Markdown files. Search finds other forms of a word, and matches by meaning once the text is indexed.
- Safe to give to an agent. You decide what an agent may do: read only, or no deleting and no public links. The agent's instructions say that text from files is data, never an instruction to follow.
- Ready for any agent. A skill for agents with a terminal, an MCP server for Claude Desktop and Cursor, and a secure link for ChatGPT and Claude in the browser.
- Free and open source. Apache 2.0, on macOS, Linux and Windows.
npm install -g @wirecat/yandex-disk-cli
ydisk doctor # what is set up, with no networkYou need Node.js 22.16 or a later 22.x, or 24 or later. Try it without installing:
npx @wirecat/yandex-disk-cli --help.
Sign in once with a Yandex OAuth token. The token is kept in the system keyring, or in a private file only you can read where no keyring works. It is never in an argument or the output.
- Register an app at oauth.yandex.com/client/new, platform "Web services",
redirect URI
https://oauth.yandex.ru/verification_code, with the accesscloud_api:disk.read,cloud_api:disk.writeandcloud_api:disk.info(onlydisk.readanddisk.infofor a read-only token). - Open
https://oauth.yandex.ru/authorize?response_type=token&client_id=with your app's ClientID added at the end, and copy the token (Yandex's guide). - Sign in under a profile name you choose, then copy a folder and search it:
ydisk personal session start # paste the token when asked, or pipe it on stdin
ydisk personal session status --check
ydisk personal folders add /Documents
ydisk personal sync
ydisk personal search "quarterly budget"personal is a name you choose for this account. You can add work or any other later. No profile is ever assumed.
Yandex says a token lasts several months and is extended while it is used
(Yandex ID). When Yandex stops accepting it, sign in
again.
More: installation
Ask in plain words. The agent picks the commands.
"Use ydisk. Find the contract with the printing house and tell me the payment terms." "Use ydisk. What did I upload to /Photos/Trips this month?" "Use ydisk. Move last year's invoices to /Archive."
- Claude Code, Codex, Gemini CLI and other agents with a terminal run
ydiskthemselves.ydisk skill installteaches them how. - Claude Desktop, Cursor and other MCP apps connect to
ydisk personal mcp serve. - ChatGPT or Claude in the browser reach it through your own tunnel, after a login with a one-time code.
ydisk skill install # Claude Code, Codex, Gemini CLI and OpenClaw
ydisk personal mcp add claude-code --allow-writes # or: codex
ydisk personal mcp config # the entry for Claude Desktop, Cursor and othersMore: agents and MCP
ydisk personal folders browse # the Disk's folders, one level at a time
ydisk personal folders add /Documents
ydisk personal sync # read what changed since the last sync
ydisk personal search "quarterly budget" --json
ydisk personal documents listTo read one document in full, pass an id from documents list or search to ydisk personal documents show.
Tags, notes and memories stay attached to a document, and documents export writes it to a Markdown file.
Choose folders rather than the whole Disk: each sync lists every one of their subfolders.
ydisk personal files list --folder /Documents
ydisk personal files download /Documents/notes.md # its text
ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
ydisk personal files upload ./notes.md --folder /Documents
ydisk personal files move /Documents/old.pdf --folder /Archive
ydisk personal files delete /Documents/old.pdf # to the Disk's trash, files restore brings it back
ydisk personal files publish /Documents/plan.pdf # a public link: anyone with it can open the file
ydisk personal files unpublish /Documents/plan.pdffiles show, files copy and files create (a new folder) are commands too.
ydisk personal api list lists the 20 operations of the Disk API, each as its own command, such as the trash, the
public links and the Disk's own operations that run in the background. ydisk personal api show resources-list shows
an operation's parameters without calling Yandex.
More: commands
ydisk keeps what it reads in the same local store as the other WireCat tools, such as Telegram, WhatsApp, mail,
Google Drive and Notion. memo context shows one person across all of them.
More: WireCat
- A local copy of the folders you choose. Yandex Disk has no change feed, so each
synclists the chosen folders again and reads only the files that changed since the last one (by MD5). A stop loses nothing: the next sync goes on from where it stopped. - Stable ids. A file moved inside the chosen folders keeps its id (Yandex's
resource_id), its tags and its notes. A file deleted on the Disk leaves the copy at the end of the pass. - Renamed folders. A chosen folder renamed or moved on the Disk is unavailable, and its copies leave the store, until you add it again under its new path.
- Files go straight to Yandex. Downloads and uploads go to the address Yandex gives, without the token.
- Made for scripts.
--jsongives the same shape for every command, and each kind of failure has its own exit code.
Each profile has its own settings. files.delete (a delete, and an upload, copy or move with --replace) and
files.share (a public link) ask first at a terminal. Over MCP there is no one to ask, so turn them off for an agent
that should not do them:
ydisk personal config set permissions.files.delete deny
ydisk personal mcp serve --permission files.share=deny # stricter for this server onlyYDISK_READ_ONLY=1 refuses every change.
More: settings
The token is in the system keyring, and no command takes it as an argument. It goes only to Yandex's API, never into a link, the output or a log. Over MCP an agent reads a file's text but cannot save a file to a path, and an upload refuses credential files and the WireCat folders unless you allow it.
More: security · Report a vulnerability: SECURITY.md
ydisk doctor # what is set up, without connecting
ydisk personal doctor --online # check that the token worksMore: troubleshooting · Ask on Discord · Bugs go to this repository's issues.
Every page is in docs/.
pnpm install && pnpm testMore: design ·
testing · pnpm docs:images renders the banner
from docs/images/src/banner.html.
Pull requests, bug reports and ideas go to issues.
ydisk is one of the WireCat tools: open-source, local-first command-line tools that give AI
agents your context from messengers, mail, calendars and documents. Each one works on its own.
