Caiioo for Word: Work on a Document from a Conversation
Caiioo for Word is a panel inside Microsoft Word. Ask about the document you have open, find clauses and defined terms, and get edits as tracked changes you accept or reject in Word.
The panel is a window onto Caiioo running on your own computer. Your conversation, your models and your tools stay where they already are; Word only shows the conversation and reads and edits the document you have open.
This page covers the panel in Word and the Word controls inside Caiioo. It describes what you see once the panel is open.
What You Need
- The Caiioo desktop app, open, on a Mac or a Windows PC. The panel says so itself: Caiioo runs on your own computer: keep the Caiioo app open on your Mac or PC, and this panel connects to it.
- Remote Access turned on for that computer, in Settings > Connectivity > Devices & Relay > Private Relay. It's off by default.
- Private Sync turned on and unlocked for that computer, in Settings > Connectivity > Private Sync (see Private Sync). Your computer needs it to run turns from Word.
- The same Caiioo account in the panel and in the desktop app. Caiioo for Word works on Free and paid plans.
If the desktop app isn't reachable, the panel shows Caiioo isn't running on your computer, with Waiting for your computer…. Open Caiioo on your Mac or PC and the panel connects by itself. Use a different account starts over so you can sign in with another account.
To install Caiioo for Word, open Home > Add-ins (or Insert > Add-ins > Get Add-ins) in Word on Windows, Mac or the web, search for Caiioo for Word, and click Add. To open the panel, select Open Caiioo under Caiioo on the Home tab.
Sign In
Click Sign in in the panel. What happens next depends on where Word is running.
Word on Windows or Mac signs in through an approval in your browser, which shows a code you type back into Word. Nobody can sign in a device without you approving it.
- The panel says Approve Caiioo for Word in your browser. It will show you a code to type here. and opens the approval page. If your browser doesn't open, the panel shows Open this address in your browser: with an address, and Open the page again. Cancel stops
- In your browser, read Allow Caiioo for Word to sign in?. It names the device (for example Caiioo for Word on Windows (as reported by that device) is asking to sign in as your email address) and when it was requested
- Click Allow only if you just clicked Sign in in Word yourself. If someone sent you the link, click Deny
- Your browser shows a 6-digit code. Type it into the Code box in Word and click Sign in. The panel shows Signing in…, then opens
Heads up — never read the code out or send it to anyone. Caiioo never asks you for it.
Word on the web doesn't use a code. The panel says Finish signing in in the window that opened. and opens the usual Caiioo sign-in in a window. Finish signing in there.
A few things can happen along the way:
- A different network. If the request came from a different network than the browser you're using, the page warns you and asks you to click Allow again to confirm. If you're not at the computer where you opened Word, click Deny.
- A wrong code. The panel says That code isn't right. and how many tries are left. After too many wrong codes it says Too many wrong codes. Start again to get a new one.
- You need a new code. After you allow a request, the approval page can Show a new code.
- It wasn't you. This wasn't me on the approval page withdraws the request.
- It expired, was denied, or didn't finish. The panel says The sign-in request expired. Start again., Sign-in was denied in your browser. Nothing was signed in. or Sign-in didn't finish. Try again when you're ready. Start again begins again.
Manage Paired Word Installs
Go to Settings > Preferences & Privacy > Trust Boundary > Account security > Signing in other devices. It lists the Word installs paired with your account, each with when it was Paired and when it was Last used, for example Caiioo for Word on Mac or Word on the web.
- A pairing lasts until you unpair it. Unpair signs that install out. Unpair all signs out every install.
- An approval you gave that is still waiting for its code shows as approved … waiting for the code; Withdraw cancels it.
- Device sign-in approval chooses the policy: Allow, after I approve in my browser and type the code it shows, or Never allow signing in another device this way.
A team or organization can turn this kind of sign-in off for you, and the approval page says so: Signing in another device this way is turned off by …. You can always choose the stricter option yourself. Change this in a browser or the Caiioo app where you signed in to Caiioo, not from a paired Word install.
Ask About the Document
With the panel open and signed in, ask about the document in the panel. While Caiioo reads a long document, the panel shows Reading this document… with a count of paragraphs so far.
The panel shows the conversation it is connected to: your prompts and the live replies, the same as in Caiioo.
Edits Come Back as Tracked Changes
Ask Caiioo to change something and it proposes the edit as a tracked change under your own Word name. You accept or reject each one in Word.
- Only the letters that need to change are marked. The text and formatting around an edit stay as they were. Ask for whole-word changes if you prefer them. If you explicitly ask for a change without tracking, Caiioo asks you to approve it first and warns that it can't be rejected in Word.
- Your Track Changes setting comes back. Caiioo records its edits as tracked changes whatever your setting is, then puts your setting back.
- Caiioo won't edit over other people's unresolved changes. If part of the text you want changed already has tracked changes, Caiioo leaves that part alone until you accept or reject them in Word. It can't accept or reject changes for you.
- Comments only when you ask. Caiioo adds, replies to or resolves a comment only when you ask, and asks for your approval first.
Heads up — a batch of edits isn't all-or-nothing in Word. If Caiioo stops part-way, the changes made so far stay as tracked changes for you to review.
Use the Word Menu in a Conversation
In Caiioo on your desktop, a Word button appears in the top row of the composer, next to the folders control, once a Word document with the Caiioo panel is open. It shows how many documents this conversation is using, and its tooltip reads Open Word documents.
- Open the Caiioo panel in each Word document you want to use
- In the conversation, click Word
- Check a document to add it to the conversation. The document whose panel is showing this conversation is checked already
- Uncheck a document to take it out, or click the × on its chip
You'll see Waiting for Word… while the change goes through, and a chip such as Contract.docx · Live in Word for each document in the conversation, with your attachments above the message box. The conversation's header and the conversation list show which documents a conversation is using, for example Word · Contract.docx. If the connection drops, they read Word connection lost.
A document whose panel is currently showing a different conversation is marked replace the conversation shown there — checking it moves that panel to this conversation. Two documents with the same name are numbered, and an unsaved one is called Untitled Word document.
Every selected panel shows the same conversation: the prompts and the live replies appear in each one. Caiioo can read, compare and propose tracked changes across all the documents you've selected, and it needs to know which document each edit is for.
The button is greyed out while a task is running, when Word isn't connected, while a change is in progress, or when the conversation runs on a different computer from the one Word is connected to. If your desktop app is too old for several documents, the menu says Update Caiioo on your desktop to use several Word documents in one conversation. If Word doesn't answer, it says Word did not confirm the change. Save any draft, finish the current task, and choose the document again.
Open in Word, and Disconnect
Under the conversation's title, Open in Word connects the conversation to a document you already have open. Once documents are connected the button reads Choose documents. The × on a document's chip (Disconnect) removes that document's access to the conversation. Word confirms the change before the connection is shown, and a draft you haven't sent, or a task that's running, keeps the current conversation where it is.
Ask Caiioo to Open a Document
On a Mac or a Windows PC, ask Caiioo to open a Word document from a folder you've connected — "open the lease in my Contracts folder". Caiioo opens the original file in Word.
- The folder must be connected to this conversation. See Workspace Files. A folder you've marked read-only can't be opened in Word this way.
- Linux can't open documents in Word this way.
- Opening a document doesn't connect it. Open the Caiioo panel in that document, then choose the document in the Word menu. Caiioo doesn't edit until you have.
Tips
- The panel needs the desktop app running. If a reply doesn't arrive, check that Caiioo is open on your computer and that Remote Access and Private Sync are on.
- You can turn Word off for a conversation without closing anything: uncheck its documents in the Word menu, or Disconnect each chip.
- Conversations that Word is connected to include Caiioo's Word tool from the first message. If you've turned that tool off yourself, it stays off.
This guide is maintained by the Caiioo team using Slate, our built-in editor.