Start a task
A task is a piece of work for Jaah: describe the goal, and a runner does it and reports back. You don't write a title — Jaah generates one from your description.
Who can do this: creating tasks needs the create-tasks permission. Without it, the board doesn't offer the controls below.
From the board
The quickest way, for a task that fits in a sentence.
- In the sidebar, select the project or feature the task belongs to.
- Select the row New task… under the board's toolbar.
- Type what needs to happen.
- Press Enter, or select ▶. The task is saved and started at once.
The task lands in the project or feature you selected. Under All projects, it goes to your organization's default project.
Need more room? Select ⤢ to open the full editor with what you typed. Double-clicking the row does the same.
In the full editor
-
On the board, select New task. The new task opens beside the board.

-
In the description box, write the goal and any context. Use the formatting bar for bold, headings, lists, checklists, quotes, code, links and images. Paste or drop screenshots straight in. What makes a description work is in Write a good task description.
-
Optional: select Attach to add files.
-
Choose how big the task is in the first list, which shows its current pick (hover it for what that pick means):
Pick Means Sketch A quick mockup to look at. Task One runner ships it as a merged change. Epic Analysed and split into subtasks first. Playbook Runs one of your organization's playbooks. Shown only when your organization's plan includes Playbooks. -
Choose how involved you want to be in the second list:
Pick Means Unattended The runner decides everything itself. Guided The runner asks you before key decisions. Interactive Asks like Guided, then asks you to Finish or Request changes once the work is done. Not offered on an epic. Your organization's settings choose what each list starts on.
-
Check Assigned to: the person the task is for. It starts as you.
-
Select Go to save the task and start it. Or select Save to keep it as a draft and start it later. Either way the form closes and the board shows your new task: after Go on the build stage (Building), after Save on the first stage (Ideas).
Save and Go stay unavailable until the description has text. Select Discard to leave without creating the task.
While you type, Jaah keeps your work as a draft, so a closed tab doesn't lose it.
Advanced settings
Select Advanced for the settings most tasks never need: Persona, Agent, Model, Priority and Depends on, plus Throttle on an epic. What each one does is in New task.
After you start
The task appears on the board under Queued, then In progress once a runner starts. When it needs you, it moves to Questions with a question mark: see Answer a task's question. What each state and tab means is in Task board and Task page. Every field of the form is described in New task.
For the ideas behind tasks and their states, see How tasks work.