Using ActionWright

Working with files

What the file agent can do inside the folder you choose, which actions ask first, and how to undo a mistake.

What the file agent does

The file agent is the part of ActionWright that works with files and folders on your PC. You don't start it yourself. When your task involves files, ActionWright hands that part of the work to the file agent, and the result comes back into your task. See How it works.

Use it to find, read, sort and tidy files, and to write plain-text files. For example:

  • "Sort the PDFs in this folder into subfolders by year."
  • "Find the invoice from March and tell me the total."
  • "Read the three contracts I attached and compare the payment terms."
  • "Rename the receipt photos in this folder to the date and shop name on each one."
  • "Make a CSV file that lists every file in this folder with its size."
  • "Move the old installers in Downloads to the Recycle Bin."

Before you begin

  • Set up an AI provider. The file agent uses it like the rest of ActionWright. See AI providers.
  • Know which folder the task is about, or have the files ready to attach.
  • If the files matter, make a copy first or make sure you have a backup.

There is no setting to turn on. The file agent is always available.

Where it can work

The file agent works only inside the scope you give it: the folder you chose, the files you attached, or both. It stays inside that scope. If a request points at anything outside it, that action is refused, and nothing outside is read or changed.

What you setWhat the file agent can reach
A root folderThat folder and everything in its subfolders.
Attached files, no root folderOnly those exact files. See Working on attached files only.
A root folder and attached filesThe root folder, plus the attached files wherever they are.
NeitherNothing. See If no scope is set.

Some sensitive files and locations are always off-limits to the file agent, even inside your folder.

Set the scope

  • In the task window, next to Root folder (optional):, click Browse... and choose a folder. You can also type or paste a path.
  • Or attach files with +. See Task window.
  • The root folder stays set for your next tasks until you change it. ActionWright does not remember it after you close the app.
  • You can't change the root folder while a task is running.

If no scope is set

When a task needs files and you set neither a root folder nor attachments, ActionWright pauses and asks you to choose a folder. Pick the folder in the question, then click Submit. The task continues, and that folder is the file agent's scope for the rest of the task. To use it for later tasks too, set it in Root folder (optional):.

Working on attached files only

With attached files and no root folder, the file agent can reach only those exact files, not the folders they are in. It can read those files, change their text, rename them and move them to the Recycle Bin. It cannot list or search folders, create new files or folders, or move or copy the files somewhere else, because all of that needs a folder. Set a root folder for that kind of work.

Files you attach stay within reach for the rest of the chat. New Chat starts without them.

Run a file task

  1. Open the task window. See Task window.
  2. Set the scope. See Where it can work.
  3. Describe what you want, with the names, dates or rules that matter. For example: "Move every PDF from before 2024 into a folder named Archive."
  4. Click Run Task.
  5. When an approval dialog appears, read the preview, then choose. See Approvals for file actions.
  6. Read the summary at the end, then check the folder in File Explorer.

You know it worked when the summary describes the changes and File Explorer shows them.

What it can do, and what asks first

Actions that change files show the title of their approval dialog, in bold.

ActionWhat it doesAsks first?
List a folderShows what is in a folder.Runs automatically
SearchFinds files whose name contains what it looks for.Runs automatically
Check detailsGets a file's size, type, and created and modified dates.Runs automatically
Read a fileReads the content of a file. See Files it can read.Runs automatically
Create FolderCreates a folder, including any missing folders above it.Asks first
Write FileCreates a plain-text file, or replaces all the text of an existing one.Asks first
Edit FileReplaces specific text inside a plain-text file.Asks first
Rename ItemRenames one file or folder. It stays in the same folder.Asks first
Move ItemsMoves files or folders into another folder.Asks first
Copy ItemsCopies files or folders into another folder.Asks first
Move to Recycle BinSends files or folders to the Windows Recycle Bin.Always asks
  • Runs automatically: no dialog. Reading, listing and searching don't change your files.
  • Asks first: an approval dialog that also offers Always Allow.
  • Always asks: an approval dialog every time, without Always Allow.

Replacing and editing text

  • Write File and Edit File work on plain-text files, such as .txt, .md, .csv or .html files. The file agent cannot create or change Word, Excel, PowerPoint or PDF files. It can only read them.
  • When Write File replaces an existing file, or Edit File changes one, the old text is gone. It does not go to the Recycle Bin. If you chose Always Allow for Write File or Edit File, this happens without a dialog.
  • Write File also creates any missing folders in the new file's path.
  • By default, a move or copy stops if the destination folder already has an item with the same name. The agent replaces that item only when it decides to, for example because you asked. A replaced item goes to the Recycle Bin first. This happens under the Move Items or Copy Items approval, which can be set to Always Allow.

What it cannot do

  • Open files in other apps or run programs.
  • Unpack ZIP files or other archives.

Approvals for file actions

When an action asks first, you see an approval dialog. See Approvals for what each choice does.

What the preview shows

Before a file change, the dialog previews it:

  • The action at the top, for example Move Items.
  • How many items are affected, counted as files and folders.
  • A one-line description of the effect, for example "Moves 3 items to the destination folder."
  • The list of items, each with its full path. Long lists scroll.

Read the list. It is what will change. Before Move to Recycle Bin, ActionWright first checks that every item exists, and the list shows exactly what will go to the Recycle Bin.

The preview does not show everything. It does not show the text a file will get, the destination folder of a move or copy, or the new name in a rename. Say these clearly in your request, and check them in the summary afterwards.

The Recycle Bin

The file agent has no delete action of its own. When it removes something, it asks Windows to move it to the Recycle Bin, and it always asks you first. You can restore the item from there. Windows decides what happens next: on drives without a Recycle Bin, such as many network and removable drives, or when the Recycle Bin is turned off or too small for the item, Windows may delete it permanently.

  1. Open the Recycle Bin from your desktop.
  2. Find the item.
  3. Right-click it and choose Restore.

The item goes back to the folder it came from.

  • Replaced or edited text is not kept here. See Replacing and editing text.
  • What the Recycle Bin keeps, and for how long, depends on your Windows Recycle Bin settings. Emptying the Recycle Bin removes its items for good.

Files it can read

Reading runs automatically. With long files, the agent reads only part of the file.

TypeWhat it readsLimits
Text files, for example .txt, .md, .csv, .log and .html files, and codeThe text.Long files are read in part: the beginning, the end, or some of both. It cannot jump to the middle of a long file.
PDFText and tables.Long PDFs are read in part: the start and pages spread through the rest. A scanned PDF that holds only pictures of pages has no text it can read.
Word (.docx)Headings, text, tables and pictures.Long documents are read only in part.
Excel (.xlsx)Cell values as last saved, not formulas.Many sheets or rows are read in part.
PowerPoint (.pptx)Slide text, tables and pictures.Long presentations are read in part, from the first slide.
Pictures: PNG, JPEG, GIF, BMP and WebPThe AI looks at the picture itself.Pictures are scaled down if large. See Attachment limits.
ZIP archivesThe list of files inside, with their sizes.Lists the files inside, without opening them.

For other types, for example older .doc, .xls and .ppt files, RAR or 7z archives, audio, video and programs, the agent sees only the name, size and dates. It can still rename, move, copy or recycle them, but it cannot read their content. To have such a document read, save it as .docx, .xlsx, .pptx or PDF first.

Limits

  • Step limit. Each run has a step limit. When it is reached, ActionWright asks whether to continue. See Limits per run.
  • Search matches file names, not the text inside files. It looks in your root folder and a few levels below it. For files deeper down, the agent can open folders one level at a time, or you can choose a root folder closer to the files.
  • Move and copy need a destination folder that already exists. If it doesn't, the agent creates it first, which asks for Create Folder.
  • Attachments have size and count limits. See Attachment limits.
  • Stop during a change: if you click Stop while the file agent is changing something, that change may or may not have completed. Check the folder before you continue.

What is sent to your AI provider

The file agent works through your AI provider, so what it looks at is sent to that provider:

  • When a file task starts, the path of your root folder, and the names and sizes of the files and folders in it and in its subfolders one level down.
  • The results of every listing and search.
  • The content of every file it reads, including pictures.

Files you attach are also read by the task window and sent with your message. See Privacy.

Tips

  • Choose the narrowest folder, not your whole user folder or a whole drive. See Where it can work.
  • Test on a copy first. For a big reorganization, copy the folder, run the task on the copy, and check the result.
  • Be specific. Name the folder, the file types and the rule, for example "PDFs from 2023 into a folder named 2023". Say if nothing should be replaced.

Risks to keep in mind

  • Text inside a file never counts as your request. The file agent's changes still ask first unless you chose Always Allow for that kind of action, so use Always Allow only for actions you would accept every time. See Instructions inside pages and files.

See Safety.

If something goes wrong

ProblemLikely causeWhat to try
ActionWright asks you to choose a folderNo root folder and no attachments are set.Pick the folder in the question and click Submit, or set Root folder (optional): before you click Run Task.
The agent can't reach a fileThe file is outside your root folder, or you attached files without a root folder.Choose a root folder that contains the file, or attach the file.
A file you know is there isn't foundIt is deep in subfolders, its name doesn't match what the agent searched for, or it is a protected file.Tell the agent which folder it is in, or choose a root folder closer to it.
The agent can't read a documentIts type isn't supported, it is a scanned PDF, it is a very large picture, or the file is damaged.Save it as .docx, .xlsx, .pptx or a PDF with text, or make the picture smaller.
A move, rename or edit failsThe file is open in another app, or Windows doesn't allow the change.Close the file in the other app and ask again.
"Step budget reached" appearsThe job needed more steps than one run allows.Click Yes, Continue, or click No, Stop and split the job into smaller tasks.
Something went to the Recycle Bin by mistakeYou approved Move to Recycle Bin.Open the Recycle Bin, right-click the item and choose Restore.
A file's text was replaced or changed by mistakeWrite File or Edit File ran.Restore the file from your backup or Windows File History. See Replacing and editing text.
You clicked Stop during a changeThat change may or may not have completed.Check the folder before you continue.

For problems that are not specific to files, see Troubleshooting.