Inbox Goals
Pro Only
An inbox goal is a goal on the Plan tab that uses a directory on disk as its inbox. Files dropped into the inbox, by you or by other software, are read by the Tasks Manager and turned into tasks in the goal, which then run like any other task. An inbox can collect bug reports, feature requests, or any other requests for work, in any format an AI agent can read, such as saved mail (.eml), text, logs, PDFs, or screenshots.
Creating an Inbox Goal
To create an inbox goal, such as one named Bug Reports for your users' bug reports, press + Add Goal at the bottom of the Plan tab's Goals view and select Inbox Goal as the Type in the New Goal dialog. To make an existing goal into an inbox goal, or change an inbox goal's settings, right-click on the goal's header and select Goal Properties..., which shows the same dialog. The dialog properties are:
- Name -- The goal's name.
- Directory -- The inbox. Type its path, either absolute or relative to the agent working directory, or press Browse... to choose it. When the agent working directory is on a remote host, the inbox is on that host too.
- Create the directory if it does not exist -- When checked, Wing makes the directory when you press OK. This is checked for a new goal or one being made into an inbox goal, and unchecked when you change the settings of an existing inbox goal.
- File Tasks As -- Whether the Tasks Manager files tasks as Ready, so they start to run immediately, or holds them for your review as Draft. The default is Ready.
- Instructions -- Anything the Tasks Manager should know about the files in this inbox, such as who sends them or which part of the project they concern. This is optional.
Each inbox goal needs a directory of its own, so Wing refuses one that is inside, or contains, another inbox goal's directory. If the directory already holds files at its top level and was not used as an inbox before, Wing asks before using it, since the Tasks Manager reads each of those files and may make them into tasks.
An inbox goal's tasks come from its files, so it has no + Add Task.
Changing an inbox goal's Type from Inbox Goal back to Goal stops Wing from watching its directory. Any tasks already filed stay in the goal.
There can be any number of inbox goals, for example one for bug reports and one for feature requests.
If several instances of Wing use the same inbox, only one of them reads each file, to avoid creating redundant tasks.
The Inbox Directory
An inbox goal's directory is shown after its name in the goal's header in the Plan tab's Goals view, as Inbox: and the path, relative to the agent working directory when it is inside it. When there is not enough room, the start of the path is cut. Click Open there to show the directory in your file manager, or Create to make it if it does not exist yet. Open is not shown for a directory on a remote host. To use another directory, right-click on the goal's header and select Goal Properties....
Wing creates the inbox directory with active, done and declined subdirectories and a README.txt. If the inbox is inside the project's working copy, Wing also adds it to the .gitignore or .hgignore file, so the files dropped into it are not committed.
Hover the mouse over the path to see the full path of the directory and counts of the goal's files by status. The last two are shown only when there are any:
- waiting -- Files that are waiting to be read by the Tasks Manager.
- active -- Files needed for tasks that have not yet finished running.
- done -- Files whose tasks have been completed and committed.
- declined -- Files that the Tasks Manager decided hold no valid requests for this project, or whose tasks were deleted without being committed.
- missing -- Files the Tasks Manager has read that are no longer in the directory, for example because you removed them.
- handled elsewhere -- Files being handled by another instance of Wing that shares the inbox.
Wing moves each file from the top level to active/ or declined/ sub-directories when the Tasks Manager has read it, and from active/ to done/ or declined/ when its tasks finish. Do not move files out of the subdirectories yourself.
Wing watches each inbox for new files, and waits until each stops changing before the Tasks Manager reads it. Hidden files, temporary files, partial downloads, and the README.txt are ignored.
Triage by the Tasks Manager
Only the Tasks Manager makes files into tasks, so while it is disabled, files wait in the inbox. An open inbox goal lists the waiting files above its tasks, marked Waiting for the Tasks Manager or Tasks Manager is off. Files that arrived while Wing or the Manager was not running are read once the Manager is on again.
The Tasks Manager reads new files without asking you, following the goal's Instructions if any were given, and files tasks as Ready or Draft as the goal's File Tasks As says. It files one task for each request, so it may merge several files about the same request into one task, or split a file that holds several requests into several tasks. A file about something an existing task already covers is attached to that task. Files that hold no request for this project, such as spam, are declined.
A task made from inbox files shows From inbox: and the names of its files on its row. The tooltip on the task shows where each inbox file is now located. The task's text names the files' paths, so the worker can read them.
Deleting an Inbox Goal
When you delete an inbox goal, Wing asks you to confirm and shows how many files its directory holds. Checking Also delete the directory and its files moves the directory to the trash. This is unchecked by default, so the directory is kept. The checkbox is not shown for a directory on a remote host. Once the goal is deleted, files dropped into its directory are no longer made into tasks.