Using ActionWright

The task window

Run tasks, attach files, choose a folder, follow progress, and stop or continue a task.

What the task window is

The task window is where you give ActionWright larger tasks and follow them. Its title is Agentic Task. You type a request, attach files, choose a folder, answer questions, and read the result.

PartWhereWhat it does
Task boxBottomWhere you type the task. It also holds Root folder (optional):, the + button for attachments, and Run Task.
ResultMiddleThe answer, or the current state of the task. Questions and prompts appear under it.
Execution TraceRight side, closed by defaultEach step of the task and how it ended.
MenuTop leftOpens a small menu with Settings.
New ChatTop rightStarts a new conversation.
Show Agent BrowserTop rightOpens the agent's browser window, or brings it to the front.
Stop · Ctrl+EscTop right, only while a task runsStops the task.

Use the task window for anything you want to watch, check or refine. For short requests by voice, see Voice and Push-to-Talk.

Open the task window

  • Press ctrl+shift+a in any app.
  • Double-click the ActionWright tray icon, or right-click it and choose Open Action Wright.
  • Start ActionWright. The task window opens when the app starts, unless ActionWright was started in the background. On the first launch it opens after the tutorial. If ActionWright is already running, opening it again from the Start menu brings the existing window to the front.

Closing the window does not quit ActionWright or end your conversation. The window is hidden, and your chat is still there when you open it again. To exit, right-click the tray icon and choose Quit.

Run a task

  1. If the task involves files in a folder, choose a root folder. See Choose a root folder.
  2. Type the task in the box. Press shift+enter to start a new line.
  3. Add files with + if the task is about them. See Attach files.
  4. Press enter or click Run Task.
  5. Watch the result area. While the task runs, the Stop button is visible, the task box is read-only, and Run Task is disabled.
  6. Read the answer under Result.

You can run a task with attachments and no text. An empty box with no attachments does nothing.

The next message you send continues the same conversation, so you can refine the result: "make it shorter", "now do the same for March". To start fresh, use New Chat.

Choose a root folder

The root folder is the folder the file agent may work in. It can list, read, create, change and move files inside that folder and its subfolders. Outside it, the file agent can reach only files you attach.

  1. Next to Root folder (optional):, click Browse....
  2. Pick the folder and confirm.
  3. Check that its path appears in the box. You can also type or paste a path there.
  • The root folder is optional. Leave it empty for tasks that don't touch files.
  • The folder stays selected for later tasks. Clear the box when you no longer want it.
  • You cannot change it while a task runs.
  • If a task needs files and you have neither a root folder nor attachments, ActionWright may ask you for a folder. See When a task waits for you.

The root folder limits the file agent. Computer Use works through the apps on your screen, the way you do, so it is not limited to this folder. See Computer Use.

Choose the smallest folder that holds what the task needs. For what the file agent can do and what it asks before doing, see Files.

Attach files

Attach a file when you want ActionWright to read it, or to work on that exact file. Attached files appear as chips under the task box.

  • Click + and choose one or more files.
  • Drag files from File Explorer onto the task box.
  • Copy files in File Explorer, click the task box and press ctrl+v.
  • Copy an image, for example a screenshot, click the task box and press ctrl+v. It is attached as a picture.

To remove a file before you run the task, click its chip (the name with ✕). If a file can't be added, a red message under the task box says why.

You can attach files when no task is running, and while ActionWright waits for a typed answer to a question. Those files go with your answer.

Attachment limits

LimitValue
Files per message20
Total size per message100 MB
PDF, Word (.docx), PowerPoint (.pptx)50 MB per file
Excel (.xlsx), plain text20 MB per file
Images10 MB per file
Archives and all other files100 MB per file

Which files are read

ActionWright decides a file's type from its content, not only from its name.

File typeWhat ActionWright reads
Plain text and code, for example .txt, .md, .csvThe whole text.
PDFThe text and tables. A PDF that contains only scanned images has no text to read.
Word (.docx)Paragraphs, tables, and up to 8 embedded pictures.
Excel (.xlsx)Every sheet and every row, as cell values. A formula shows its last saved result.
PowerPoint (.pptx)Slide text, tables, and up to 8 pictures.
Images: PNG, JPEG, GIF, BMP, WebPThe picture itself, so the AI can look at it.
Archives: ZIP, RAR, GZ, 7zNothing. The file is passed by its path only.
Everything else, for example video, audio, programs, HEIC photos, and older .doc, .xls and .ppt filesNothing. The file is passed by its path only.

"Passed by path only" means the AI does not see the contents, but the agents can still use the file itself, for example to upload it to a website or move it into a folder.

What ActionWright reads from a file is sent to your AI provider with your message. Don't attach files you don't want your provider to receive. See Privacy.

What agents can do with attached files

  • Attaching a file hands the file itself to the agents, not just a copy of its text. If your task asks for it, they can change it, rename it, move it to the Recycle Bin, or upload it to a website, even when it is outside the root folder.
  • Without a root folder, the file agent can work only on the files you attached. It cannot list or search any folder.
  • The browser agent can upload only files you attached to the chat.
  • Attaching a file gives access to that file only, never to the folder it is in.
  • A file stays attached for the rest of the chat, also after its chip disappears. If it is renamed, it stays attached under the new name. It leaves the attached list only when it is moved into the root folder or moved to the Recycle Bin. There is no way to detach it yourself. Start a New Chat to begin without it.

Show the agent browser

The browser agent works in its own browser window, separate from your usual browser. When a task needs the web, that window opens on its own, and you can watch the agent work in it.

  • Click Show Agent Browser to open the agent browser, or to bring it to the front if it is already open.
  • There is no hide button. The browser is a normal window: move it aside, or close it when you no longer need it. The next time you click Show Agent Browser, or a task needs it, a browser window opens again.
  • Don't close the agent browser while a task is using it.
  • Stop does not close the agent browser. The page stays where it was.

For what the browser agent does, what it keeps between tasks, and when it hands control to you, see Browser.

Follow progress: result, trace and tokens

Result

The answer appears under Result. Links in it open in your default browser. If the window is not in front when the task ends or needs you, Windows shows a notification such as Task complete, Question waiting or Task failed. Click it to open the task window.

Execution Trace

The Execution Trace panel lists each step of the task. It is closed by default. To open it, click the narrow strip at the right edge of the result. The strip shows the number of steps and turns purple while a step runs. Drag the panel's edge to make it wider. Steps with more to show have an arrow: click it to see the full title and details.

BadgeMeaning
running...The step is in progress.
doneThe step finished. The number is how long it took, in seconds.
unverifiedThe step ran, but ActionWright could not confirm the result. Check it yourself.
errorThe step failed or was stopped.

In a chat with several tasks, the trace can show the steps of earlier tasks again, and step numbers continue from them.

Token counter

Under the result, a line such as "Tokens: 12,345 total (11,000 in / 1,345 out)" shows the tokens the orchestrator used for this turn. It is not your full usage: it does not include the work of the file agent, the browser agent and Computer Use, and it is shown only after a task that finishes in one go. It is not shown after a stop, an error, or a task that paused and then continued. For exact usage and cost, check your AI provider's dashboard.

Stop a task

  • Click Stop · Ctrl+Esc in the task window, or press ctrl+esc in any app. The shortcut helps while Computer Use is using your mouse and keyboard.
  • The button changes to Stopping… and the result shows "Stopping… finishing the current step."
  • When the task has stopped, the result shows "Task was stopped by the user." A task that was waiting for you shows "Task cancelled." instead.

While a task waits for you (a question, a Done prompt or a Continue prompt), ctrl+esc does not end it. Use the Stop button in the window, or the prompt's own stop button.

ctrl+esc also stops a spoken reply in Voice mode.

Continue a stopped task

A stop ends the turn, not the work. ActionWright remembers where a stopped agent was, for its most recent stopped runs (up to three per chat).

  1. Check the state of what the task was doing, especially the action that was running when you stopped.
  2. In the same chat, send a message such as "continue where you stopped". Add anything that changed, for example "the first email was already sent".
  3. ActionWright can pick up the stopped agent's work instead of starting over. It is told to check the current state first, because the screen, pages and files may have changed.

Stopped runs are kept in memory only. New Chat and quitting ActionWright forget them. If you stop the same job more than once, a later "continue" may pick up an older part of it, so check what was done.

When a task waits for you

Sometimes a task pauses and waits for you. The prompt appears under the result.

What you seeWhat it meansWhat to do
A question with Type your answer... and SubmitActionWright needs information from you.Type the answer and press enter or Submit. You can attach files with +.
A question with Select a folder... and Browse...The task needs a root folder.Click Browse..., pick the folder, then click Submit.
An approval dialogAn action needs your permission first.Read it, then allow or deny. See Approvals.
A message with Reply (optional)... and DoneYou need to do something yourself, often in the agent browser, such as signing in.Do it, then click Done. You can add a short reply first.
Step budget reached with Yes, Continue and No, StopThe task used its steps.See The step limit.
An AI provider problem with Continue and StopYour AI provider failed in a way you can fix.See AI provider errors.

A paused task has no time limit. It waits as long as ActionWright runs. Stop, New Chat or quitting ActionWright ends it. An approval dialog is different: it blocks the window, so answer it first, for example with Deny, and then use Stop. If you started the task by voice, ActionWright also reads the question or prompt aloud.

The step limit

Every task has a step limit, so a task that goes in circles cannot run forever. The orchestrator counts its own steps, such as handing work to an agent or searching the web. Each agent counts its own actions every time the orchestrator hands it work.

The limits are fixed, and you cannot change them in Settings. See Limits per run.

When a limit is reached, the task pauses and shows "Step budget reached" with the steps used, and asks whether to grant more steps.

  • Yes, Continue gives the orchestrator or the agent that ran out a fresh set of steps, as many as its limit. The task continues where it stopped. If it runs out again, you are asked again.
  • No, Stop ends the task. ActionWright then shows a short summary of what was done and what is left.

If a task keeps hitting the limit, read the trace before you continue. It may be stuck on something you can fix, or the task may be better split into smaller ones.

AI provider errors

If your AI provider fails in a way you can fix, ActionWright first retries. If it still fails, the task pauses instead of ending. The window explains the problem, for example not enough credit, a rejected key, or a model that is not available, and shows Continue and Stop.

  1. Fix the cause: add credit at your provider, enter a working key, or choose another model in Settings. For a network problem or a busy provider, wait a moment.
  2. Click Continue. The task continues from where it paused, with the settings you have now.

Stop ends the task and keeps what was already done.

Errors you can't fix by changing a setting end the task with an error message instead of a pause. For setting up providers, see Providers.

Start a new chat

Click New Chat to start a new conversation. If a task is running, it is stopped first.

  • The result, the trace and pending attachments are cleared.
  • A task waiting for you is ended.
  • ActionWright no longer uses the earlier conversation, its attached files, or its stopped runs.
  • The root folder stays selected, and the agent browser stays open.

Conversations are kept in memory only. Quitting ActionWright clears them, and there is no chat history to reopen. For what ActionWright remembers during a chat and between chats, see How it works.

Troubleshooting

ProblemLikely causeWhat to try
enter does nothingA task is still running, or the box and attachments are empty.Wait for the result or press Stop. Type a task or attach a file.
A file can't be attachedIt is over an attachment limit, or the file can't be read.Check the attachment limits. Split the files over several messages, or put them in a root folder.
"Could not read an attached file" when you runThe file was moved or deleted after you attached it.Remove the chip and attach the file again.
The answer ignores an attached fileThe file type is passed by path only, or the PDF has no text.See Which files are read. Save the content in a readable format.
ctrl+esc does not stop a paused taskThe shortcut only stops a task while it runs.Click Stop in the task window.
The trace shows steps from an earlier taskSteps of earlier tasks in the same chat can come back.Read the newest steps at the bottom, or start a New Chat.
"Could not open browser: …"The agent browser could not start.Try Show Agent Browser again. See Troubleshooting.