Get started
Three commands, one sign-in, then ask.
Before you start
What the skill needs
| Requirement | Needed for | How |
|---|---|---|
| .NET 10 SDK | Runs every extraction, whichever installer you use | dotnet.microsoft.com/download |
| dotnet-script | Runs the extraction scripts | Step 2 below |
| Node.js 20 or later | The npm installer only | Skip if you use the .NET installer |
| One of the seven AI tools | Where you ask | Supported tools |
Python 3.12 is needed only by developers who use the Python step in the SDK. docuoria doctor reports whether the .NET 10 SDK and dotnet-script are present.
Step 1
Install the docuoria command
$ npm install -g @sidub-inc/docuoria.cliNode.js 20 or later. This distribution has no docuoria license commands; in step 4, get your licence from the marketplace.
$ dotnet tool install -g Docuoria.Cli.NET 10 SDK or later. This distribution also carries the docuoria license commands used in step 4.
Step 2
Install the script runtime
$ dotnet tool install -g dotnet-scriptStep 3
Add the skill to your AI tools
$ docuoria initRun it in your project folder. A picker lists the seven supported tools with their detection status, pre-selects the ones it finds, and writes the skill files into each one you confirm. Files that do not carry the Docuoria stamp are left alone unless you pass --force; edits to files the installer wrote are replaced on update.
Then run docuoria doctor. It confirms that the .NET 10 SDK and dotnet-script are present and lists the tools the skill was installed into.
Scripted or CI use
$ docuoria init --tools claude,cursor # named tools$ docuoria init --tools all # every supported tool$ docuoria init --tools claude --no-interactive # no picker| Tool | Tool ID |
|---|---|
| Claude Code | claude |
| GitHub Copilot | github-copilot |
| Cursor | cursor |
| Windsurf | windsurf |
| Codex | codex |
| VS Code AI Toolkit | aitk |
| AGENTS.md | agents-md |
Step 4
Get a free licence
With the .NET tool
$ docuoria license acquireIt signs you in with a device code in your browser and stores the licence in ~/.docuoria/license.json, where the skill reads it. No key passes through the chat.
With a key from the marketplace
- Open monaiq.com/marketplace and choose Docuoria. The Free plan costs nothing.
- Paste the key into your AI assistant when it asks for it.
- The assistant stores it locally and never repeats it.
You can also let the first request handle it
Ask for an extraction with no licence in place and your assistant tells you, in one sentence, that Docuoria needs a free licence, gives you the link, and continues once you have one.
Step 5
Ask for the first file
- > Can you get the data out of invoice.pdf? I need it in a spreadsheet.
- > This folder has all my software bills from different companies. One spreadsheet of everything: vendor, what it was for, dates, amounts.
- > New invoice came in. Same as last time please.
Your assistant reads every page, builds or reuses the rules for that kind of document (a template), rehearses the extraction, checks that the amounts add up, and writes the CSV or JSON file next to your PDFs. It asks at most one question, about what you want in the file, never about how. The template is saved in a templates folder beside your PDFs, so the next document of the same kind takes one sentence.
Upkeep
Four commands for the life of the install
| Command | Does |
|---|---|
docuoria doctor | Reports the .NET 10 SDK, dotnet-script, installed tools, and any stale files |
docuoria update | Re-applies the skill to the tools you installed it into, after a CLI update |
docuoria list-tools | Lists the seven tools with their detection status in this project |
docuoria license status | Shows the plan, features, and usage in the current window (.NET tool only) |
Building an application?
The same engine is a .NET 10 library on NuGet, with a scriptable CLI surface for pipelines and agents.