# foxAI - quick guide foxAI is a fox that lives on your desktop and helps you with your documents. Everything she reads stays on your computer: the "brain" (an artificial intelligence model) runs there, without the internet. You only need the internet the first time, to download it (about 2 GB). On first launch a three-step welcome explains what the fox does, how it handles your data and that you are using artificial intelligence, then lets you choose the model before downloading it (size, free space, estimated time). The download resumes where it stopped if the connection drops. You can see the welcome again from Settings → About. The foxAI icon (a fox head in profile drawn with a single orange line; on the Mac it is black or white like the other menu bar icons) sits in the menu bar at the top (Mac) or next to the clock (Windows). From there you find Chat, Undo, Reminders, Notes, PDF tools, Settings and Quit. foxAI speaks Italian and English. At first she follows the language of your system; you can change it in Settings → System → Language. This guide also exists in Italian: [GUIDA.md](GUIDA.md). ## What the fox does on her own - She walks and trots to ever-changing spots, stops to sniff or dig and sets off again, sits, lies down, stretches, yawns, scratches, licks her paw, shakes herself. When she's in a good mood she does the play bow, chases her tail, jumps, does a somersault. - If you keep the pointer near her while she's still, she turns her head to look at it; if the pointer stays still near the floor, she sometimes pounces on it like on a mouse. - In Settings → Fox you choose her size (small, normal, large) and her pace: calm, normal or lively. - Every now and then she climbs onto the window you're using and walks along it. If you move or close the window, she falls and lands on her feet. - She hides at the edge of the screen or behind a window, leaving her tail out, and peeks now and then. A click brings her out. - With more than one monitor she sometimes moves from one to the other. - At night, or when you're not using the computer, she sleeps. - At Christmas and in summer she wears a hat. After a tidy-up she dresses for the job: for example a visor and a calculator for invoices. - When you watch a film or play a game in full screen, she disappears and then comes back. A window that is simply maximised doesn't make her disappear. - If you switch desktop (virtual desktops on Windows, Spaces on Mac) the fox comes with you, together with the speech bubble and the chat. Each of these can be turned off in Settings → Fox. "Do not disturb" (from the menu) sends her to the bottom right corner: she stays seated and quiet, except for errors. ## How to interact - **Stroke her**: move the mouse back and forth over her, without clicking. She half-closes her eyes and then sits down, happy. - **One click**: she looks around. If she's asleep, she wakes up. - **Pick her up and throw her**: drag her and let go. She falls, bounces off the edges and lands. - **Sulking**: if you throw her hard or click 4 times in a row, she takes offence, turns her back and grumbles for a while. It passes on its own. - **Double click**: opens the chat bar above her. Enter sends the question, Esc closes it. - **Right click**: opens the menu with Chat, Undo last tidy-up, Reminders, Notes, PDF tools, Settings, Focus 25 min, Do not disturb and Hide. While she's reading documents there's also "Stop reading". - **Dragging files onto the fox**: she tidies them up (see below). If you give her only photos, she asks whether to make a PDF of them; to merge several PDFs use "PDF tools…" from the menu. - **Ctrl+Alt+F** (Ctrl+Option+F on Mac): opens the chat from any program; the same keys close it again. You can change them in Settings → Break and shortcut. ## What to ask in the chat Write as you would speak. A few examples: - **Find a document she has already tidied**: "where did I put the January invoice?". Cards appear under the bar: one click opens the file or its folder. - **Search for a file on the computer**: "find the Rossi contract on my computer". She looks in Desktop, Documents and Downloads, and in the folders you add in Settings. She doesn't save anything she sees. - **Reminders**: "remind me tomorrow at 9 to call Marco", "remind me to pay the car tax on March 3", "alert me in 2 hours to take the laundry out". The fox repeats the date in full: check it. "Undo" removes it straight away. - **Notes**: "note: gate code 4521", "jot down: plate AB123CD". You find them again with "find gate" or in the Reminders window → Notes. - **Spending**: "how much did I spend on electricity in 2026?", "total of my bills for 2025". The sum is based on the documents you've tidied up. The amounts were read by the fox: check them on the document (you can correct them in the preview, see below). If in the meantime you deleted or moved some of those documents, the fox tells you. - **A document to read on the spot**: drag it onto the **chat bar**, not onto the fox. Then ask "summarize the document", "translate it into English", "what are the deadlines?", "who signs the contract?". The document isn't archived or moved. - **Focus timer**: "start a focus session", "focus 40 minutes", "set a timer for 10 minutes", "stop the timer". The fox reads next to you and at the end suggests a break. - **Quick sums** (instant answer, no "brain"): "what is 12*3+4", "15% of 240", "240 + 15%". Numbers are written the English way: 1,234.56. - **VAT**: "vat 20% on 1000" (net, VAT and total), "remove vat at 20% from 1200". In English always say the rate: if you don't, the fox asks for it. Amounts and results are in euros. - **Dates**: "how many days until November 15?", "how many days until Christmas?", "what day will it be in 45 days?", "what day is Christmas?", "30 working days from today", "how many working days from December 21 to December 31?". In English, working days skip Saturdays and Sundays only: public holidays are not counted. - **Writing a text**: "write a short email to the landlord about the leak", "write to Mario that I'm late". For a text of your own, paste it after the colon: "proofread: …", "rephrase in a more formal tone: …", "summarize: …", "translate into Italian: …". Straight after, you can ask "make it shorter" or "translate it into German" without pasting it again. The text also appears above the bar with the **Copy** button. The parts the fox doesn't know (dates, names) stay in square brackets, for example [date]: fill them in before sending. - **Text from an image**: drag a photo or a screenshot onto the chat bar (PNG, JPG, BMP, TIFF; on Mac also iPhone HEIC photos). The fox reads the text, shows it with **Copy**, and then you can ask "summarize", "translate it into English", "what are the deadlines?": the summary or translation appears in a second box, and the text she read stays copyable. The image isn't saved or moved. - **Help**: write "help" or "what can you do?" for a list of examples. - **A little chat**: "how are you?", "hi fox!". Fixed answers (sums, VAT, dates, reminders, search results) follow the interface language; texts the model writes for you (emails, summaries, translations) follow the language you write in. ## Tidying up documents 1. Drag one or more PDF files (scanned ones too), Word, TXT or MD onto the fox. 2. The fox reads them and opens a **preview**: for each file you see the new name, the folder and the deadlines she found. You can change everything before confirming. Under "Details" there's also the **amount** the fox read: if it's wrong, correct it (94.60 or 1,234.50); leave it empty if the document has no amount. Spending totals use whatever you leave there. 3. Confirm: the files are **copied**. The originals stay where they are, unless you chose "Move" in Settings. Usually the folder is on the Desktop (called "Organized" for new English users), or the one you chose for the category. - **Stopping her halfway**: if you realise you gave her the wrong files, or there are many and it's taking too long, choose "Stop reading" from the fox's menu or from the icon (it's there only while she's reading), or write "stop" in the chat. She stops at once and shows you in the preview the files she had already read; the others stay where they are, untouched. If she hadn't read any yet, she says "I stopped reading." - **Undo**: from the fox's menu or from the icon, "Undo last tidy-up". It removes only the copies that are still identical: if you changed a file in the meantime, the fox leaves it where it is and tells you why. All tidy-ups are also in Settings → History. - **Duplicates**: a file already tidied (even under another name) shows up as excluded in the preview, with the date and the place where you put it. To do it again anyway use "Tidy up anyway". - **Destinations**: in Settings → Tidying and destinations you can choose a folder for each category, for example `Invoices/{year}`, so the 2026 invoices end up in Invoices/2026. - **Deadlines**: the ones you leave ticked in the preview become reminders. The fox reminds you the day before and on the day, only when you're at the computer and foxAI is open. Categories and folder names are in the language foxAI had when you first started it. If you already used foxAI in Italian, your folders and categories keep their Italian names even after switching to English. ## PDF tools From the fox's menu, "PDF tools": - **Merge**: several PDFs (and photos too) in a single PDF. The order is the one in the list: change it with the arrows. - **From images**: each photo becomes an A4 page, straight and centred. Handy for receipts and documents photographed with your phone. - **Extract pages**: choose a PDF and write the pages to keep, for example 2-5 or 1,3,6. Drag the files into the window (or use "Choose files…" in the installed version). The new PDF appears next to the originals, which stay as they are. Password-protected or damaged PDFs are skipped, and the fox tells you which. For a very heavy merge (over 1 GB of files, or huge PNG photos) she asks you to split it into several parts. "Undo" removes it straight away, if you haven't changed it. ## Useful settings - **Watched folder**: the fox watches for example Downloads and, when a new file arrives, asks whether to tidy it. She never does anything without asking. - **Morning briefing**: at your first activity of the day she tells you today's and tomorrow's deadlines. Not before 7, and not before the time chosen in "Reminders from" (8:30 at first). - **Sounds**: off at first. You can turn them on and choose the volume. - **Active break**: off at first. If you turn it on, after 50 minutes (or as many as you choose) at the computer the fox stretches and suggests a two-minute break. "Later" postpones it by a quarter of an hour; if you really get up for a few minutes the count starts again from zero. - **Shortcut**: the key combination that opens the chat. Click in the field and press the keys; if another program already uses it, the page tells you (and the fox says so once at startup). - **Model**: shows which brain the fox uses and which one she recommends for your computer. - **System**: language, starting together with the computer (installed version only) and reading scanned PDFs. - **Clear history and index**: deletes the saved data about the documents. The tidied files stay where they are. ## Portable version (USB drive) - **Prepare it at home**: copy the whole foxAI folder onto the USB drive (you need at least 3 GB free), start it once on a computer with internet, wait until it has finished downloading the model and close it with Quit. From then on it also works without internet. - Start `foxai.exe` (Windows) or `foxAI.app` (Mac) from the USB drive. You don't need to install anything or be an administrator. - Tidied documents are copied into a folder on the USB drive (`Organized` for new English users, `Riordinati` for those who started in Italian). Settings, archive and notes stay in the `data` folder. - **What stays on the PC**: when it closes, foxAI deletes the traces it creates on its own (WebView2 registry keys on Windows, cache on Mac). Only the traces Windows keeps for any program that runs remain (list of programs run, Prefetch) and, if you open a document, the "recent files" of the app that opens it. - To close it use the icon → Quit, then wait about ten seconds before removing the USB drive. - The PC's Recycle Bin isn't used: when you undo a tidy-up, the copies are deleted. ## Limits to know about - The fox can make mistakes: sometimes she misreads an amount or a date said in an unusual way. That's why she always repeats the date, and in the preview the amount she read can be corrected. - Reminders only go off while foxAI is open: no system notifications. Each one is for a single day: repeating reminders ("every Monday", "every day") aren't available yet, and the fox says so. - The first answer after a pause can take a few seconds, because the fox "switches her brain back on". - On computers with less than 6 GB of memory the fox doesn't tidy up and doesn't chat with the model. Notes, timer and search by name work all the same. - Files that exist only in the cloud (OneDrive, iCloud) can be found by name, but the fox doesn't read them. - Scanned PDFs are read when tidying, not in the chat (in the chat she reads images). In the portable version for Mac the first scanned document of each session takes about 25 seconds longer. - Text read from an image can contain a few mistakes, especially with crooked or handwritten photos: check it before using it. On Windows the system OCR needs Italian or English (added from Settings → Time & language → Language); HEIC photos can be read only on Mac. - Texts written by the fox (emails, translations) should always be read again: they're a help with the draft, not a text to send without looking. In the "Ready text" box the "AI-generated text" label is a reminder. - Amounts, spending totals and VAT are in euros only: documents in other currencies are tidied up but get no amount. - Updates are not automatic: new versions are downloaded by hand.