Tasks
A task is one piece of work you hand to Jaah: you describe it, a runner does it, and the result comes back to the task. These guides cover what you do with a task while it runs. For the ideas behind tasks and their states, see How tasks work.
- Start a task — from the board in one line or in the full editor.
- Finish a task whose attachment didn't upload — read why a file was refused, then Retry upload or drop the file and carry on.
- Start a task from a tracker issue — pick a Jira, Linear or Backlog issue in From issue to fill the description and link the task.
- Write a good task description — the goal, the place, the details, the boundaries and what done means.
- Format a task's description: headings, lists, checklists, code and links from the formatting bar, typed shortcuts or pasted Markdown.
- Fix spelling as you write a task: catch misspelled words in a description or comment, pick a correction and keep code out of the check.
- Test a staging site with an agent — an agent clicks through your staging or live site like a QA tester and reports what is broken.
- Example tasks — a hundred real task descriptions, grouped by kind of work, with what each one took.
- Answer a task's question — find a task that is waiting for you and send your answer, with files if they help.
- Look at an artifact beside a question — read the file a runner handed back next to its question, with Open artifacts.
- Answer a task's questions with the keyboard — pick with the arrow keys, Enter for Next and Send, Space to tick.
- Finish answering a task's questions later: your unsent answers are kept until Send, and unanswered takes you back to the ones you passed.
- Format an answer and add screenshots — bold, lists and links in an answer, @ to mention a teammate, and pasted screenshots.
- Answer a question in the task's terminal — answer where the agent asked, in the web console; the task carries on.
- Get a task going when your answer doesn't reach it — read the Q&A tab's warning, then open the console, stop or reset.
- Chat with a running task — read the session as a chat, send a message, interrupt a turn.
- Stop, restart or reset a task — stop a running task, start it again, park it, reset it to a clean draft, mark it done or archive it.
- Complete a task with a one-line outcome: mark a task done by hand with Complete and say what happened in one line.
- Start a task on another node — leave the node that holds a task's last VM with Start fresh elsewhere.
- Set a task's state by hand — move a stuck task to any state from State on its Details tab.
- Find out why a task failed — read the reason in its banner and its Timeline, then fix it and start it again.
- Find out who paused a task: hover a paused task's status for who stopped it and when, or why Jaah paused it.
- Review a task's work before it ships — start it as Interactive, ask for changes, then pick Finish to let it merge.
- Read a task's result — its outcome, the change it delivered, its files and its cost.
- Preview a document, spreadsheet or slide deck on a task — read a
.docx,.xlsxor.pptxa task handed back on its Artifacts tab. - Rate a task's result: give a finished task one to five stars, read who voted what and change your vote.
- Check how much memory and CPU a task used: run time, tokens, cost, peak RAM, peak CPU and CPU time on its Metrics tab.
- Download a task's compliance manifest — the signed record of how AI took part, as HTML or signed JSON.
- Comment on a task — discuss it with your team, mention someone and react.
- Reply to a comment: answer a teammate's comment with ↩, which mentions them so they're notified.
- Organize tasks into features — group related tasks and follow their progress.
- Pin a task — keep a task at the top of its board section, and unpin it.
- Pin a project to the top of the sidebar — keep the projects you open most under Pinned, and unpin them.
- Make a task wait for another task — add a prerequisite, see what a task blocks, re-run or remove one.
- Label tasks with tags — create a tag group and its tags, tag a task and group the board by tag.
- See everyone's drafts — as an Org Owner or Admin, show every member's drafts on the board.
- Archive or delete many tasks at once — select tasks on the board, then delete the drafts or archive the finished ones.
- Find a task on the board — search the board, or narrow it by project, person, state, period or source, then clear the filters.
- Find a finished task by searching the board — typing in the search opens every folded Done, release and Automatic row.
- Start a task when every slot is busy — stop a running task to start yours now, or let it wait in the queue.
- Accept or discard a task Jaah suggested — start or delete the drafts runners file on their own.
- Choose the agent and account a task runs on — pin a task to one agent, account, model level or node, and see what it ran on.
- Use the recommended runner for a task — read the Recommended box on a new task, select Use this, and see Accepted or Overridden.
- Read or override what routing picked for a task: the Routing tab's pick, reason and Candidates, with Use this or Change.
- Reassign a task — hand a task to another project member from its row on the board.
- Set a task's language — choose the language its questions, reports and summary are written in.
- Copy a task's link — select a task's number on the board to copy its link.
- Share a link to a tasks page view: copy the address of a project's Pipeline, Schedules or Settings tab, with its stage.
- Edit a task — change a task's description and settings from its page, then save, start or close it.
- Get back a new task you didn't finish: find the draft Jaah saved while you wrote, then save or start it.
- Rename a task — type a new title at the top of its page, or let Jaah write one with Re-generate title.
- Duplicate a task — copy a task into a new one, change what should differ, then save or start it.
- Start a task when you can't see its repository — fix your git access and start again, or run the task without the code.
- Confirm or dismiss what broke a task's change — read what happened to a merged change and decide each defect Jaah traced to it.
- Read a task's review findings — what the review checks found in a task's change, most severe first.
- See how a task's description changed — read earlier versions of the description and compare each with the next edit.
- Move a queued task up the queue — raise a waiting task's priority so it runs before the others.
- Attach files to a task — add a screenshot, log or spec to a task, then preview, download or remove it.
- Change an answer you gave a task — reopen a question you already answered, send a new answer, and see when the runner gets it.
- Choose which columns the board shows — hide the row columns you never read, such as Tokens or Cost, and show them again.
- See which persona each task runs — read the Persona column; the project's default persona shows dimmed.
- See finished tasks you haven't opened — spot the ring around a finished task's ✓ and open what you haven't read yet.
- Set how long finished tasks glow as unread — choose how many days an unopened finished task keeps its ring, for the whole organization.
- Archive a project's tasks and bring them back — clear a project's stages with Archive, then find them under Show › Archived and Restore them.
- Find finished tasks that changed no code — open the ✓ Done row at the end of the first stage to list answers, research and designs.
- Move tasks to the next stage — tick tasks, then press Start, Merge or Move to a stage.
- Switch between the tasks and pipeline views — flip the Tasks page between every task by state and one project's work by stage.
- Open the tasks automations filed: open the Automatic row that holds the tasks schedules, triggers and agents filed.
- Find what shipped in a release — open Done under Tasks, where finished tasks fold under the release that shipped them.
- Format a comment and attach files — bold, headings, lists, code and links in a comment, with files of any kind attached.
- Approve or reject tasks waiting at a step — read the step's chip, tick the waiting tasks and decide, with an optional comment.
- Find out why tasks are stuck between stages: read a pipeline step's coins and chip, list the tasks it holds or failed, and act on the reason.
- Fold finished tasks in each group — group the board by project, feature or tag and open or fold each group's ✓ Done row.
- Hide finished work from the board — take finished tasks and queued subtasks off the board while you work through the rest.
- Show a draft to a teammate — mention someone in a comment so your draft shows on their board.
- Move a tag group to draft or delete it — take a tag group out of use, delete it with its tags, or delete one tag.
- Reorder tag groups and tags — move a group or a tag up or down in Settings from its row's ⋯ menu.
- Move a task to another project — pick the right project from the name at the top of the task's page; its subtasks go with it.
- Resize a picture in a task's description — drag the corner of a pasted picture to resize it, and open it full size.
- Open an earlier version of a task's report — show the versions folded under Current on the Artifacts tab, preview one and download it.
- Open the app a task's change runs in — see how far a task's change got and open the app there.
- Open a picture in a comment full screen — select a comment's thumbnail to see it full screen, or open it in a new tab.
- Stop being asked about a repository you can't see — tick Don’t ask again so a project's tasks run without the code unasked, and how to be asked again.
- Let members pin a task to a node — turn on Node picker so a task's Node field lets people pick where it runs.
- Put an image in a task's description — pick pictures with the description's 🖼 Image button.
- Record which change caused a defect — charge a defect to the work behind it with Origin task or PR.
- Read a task's delivery record — the Outcome tab's Timeline and Gate facts, such as Lane time and Pushes after enqueue.
- Follow an agent while it works — the Agent tab's Agent activity, Jump to latest and Open in chat.
- Find out why a queued task hasn't started — read the hold reason on the board or the task's page, then clear it so the task starts by itself.
- Catch up on what changed on the board — group the board by Recency to see what is running now and what moved today or this week.
- Get a quick mockup with a sketch — pick Sketch so a runner draws a mockup, preview it on Artifacts, and ask for another take.
- Refine a mockup round by round — a Sketch task is Interactive, so it asks after each mockup until you pick Finish.
- See who changed a task and when — read Created by, Updated by and the Timeline, and open a step for the fields it changed.
- Open the session a task ran in: open a Runner started row in the Timeline for its session: and account:.
- Show a task's subtasks on the board — unfold an epic's row with ▸ or Expand subtasks to list its subtasks under it.
- Check on your tasks from your phone — pick a project, search, see why a task waits and answer it, with Console in the task's ⋯ menu.
- See which checks ran on a task's pull request: read Merge gates on the task's Summary, and a lane run's gates, time and Slow mark.
- Check whether a pipeline stage is up: read a stage's health dot in Pipeline: Healthy, Down, Not checked yet or No address.
- See whether a task used project memory: read the Project memory row, on or off, why, and how much memory the runner used.
- Cap the model every stage of a playbook uses: set Max model under Advanced on a task that runs a staged playbook.
- Hide a task from the board: tick Hidden under Advanced on a task you created, and show it again.
- Spot stopped tasks from the sidebar: read the coloured count beside a project or feature for its questions, failed and paused tasks.
What every part of the task board and the task page means is in the task board and task page reference.