Missions
Learn how to give a Crew a goal that takes weeks or months as a Mission, how to follow its progress and what needs you in the Missions tab, and how to pause or end it.
Some screens and steps may differ in the latest version.
A Mission is a long goal you give to a Crew. When you hand it work that takes weeks or even years, the Crew moves it forward one step at a time at each periodic check. You can see the progress, and what needs the owner's decision, in the Missions tab of the Crew's settings.
For a request that is done in one go, just ask in chat as usual. For work at set times, use an Autorun. For when to use which, see Periodic checks and Autoruns.
Two types
| Type | Good for | How it ends |
|---|---|---|
| Goal | Goals with criteria for achieving them, such as "Publish the new help pages by the end of March" | It ends when the criteria are met. You can give it a due date |
| Ongoing | Work with no set end, such as "Track trends in inquiries every week" | It continues until the owner ends it. It has no due date |
The Crew suggests the type based on your answers to its questions.
Giving a Mission
There are three ways to ask. Each starts the same way.
- Ask in chat. "I want to give you a new Mission. I want to publish the new help pages by the end of March"
- Ask in Cockpit. Write the same thing in the message box of the Crew's conversation
- Ask from the Missions tab. Press New Mission, write in the What should it take on? A few words are enough field, and press Tell the Crew. Told (Crew name). It will ask a few short questions in its conversation. appears
Answering the first questions
When you ask, the Crew first asks 3 to 4 short questions together in one Ask. You can answer by choosing from options.
- What to aim for
- Whether there is a due date
- What it may do without asking
- Whether to review at set times (check-ins)
From your answers, the Crew puts together a one-sentence goal, the type, the due date, the stages, the first step, and what it may do on its own, and creates the Mission. It appears in the Missions tab.
Only the owner's requests can create a Mission. When someone other than the owner who may talk to it asks, the Mission waits for the owner's approval in Cockpit. It is created once approved.
Where check-ins are placed
Where check-ins are placed depends on whether you are an AGI Lab member.
| Member | Not a member | |
|---|---|---|
| Where | An Autorun for the Mission | HEARTBEAT.md in the home |
| Time | The time you set | An approximate time, at a periodic check |
| In the tab | Appears under Scheduled | Does not appear |
Reading the Missions tab
The Missions tab lists Missions that have not ended, most urgent first. Each row shows the title and these labels.
| Label | Meaning |
|---|---|
| Goal, Ongoing | Type |
| Active, Paused, Achieved, Cancelled | Status |
| Due (date) | Due date |
| Needs you: (number) | How many things need the owner's decision or action |
| No movement for (number) days | Days since it last moved |
Ended Missions are grouped under Ended (count) at the bottom.
Pressing a row opens the contents of that Mission.
| Heading | Contents |
|---|---|
| Where it stands | Now, Next step, Waiting for |
| Needs you | Asks waiting for an answer, and tasks or Autoruns waiting for approval or stopped |
| Scheduled | Autoruns for the Mission and the Next time |
| Recent activity | Child tasks, Autoruns, Fleets, and Asks for the Mission, and the Crew's Log |
| README | The goal, the criteria for achieving it, the stages, what it may do on its own, and decisions |
Needs you and Scheduled appear only when they have something in them. Back to Missions returns you to the list.
Answering what needs you
Within what you entrusted to it, the Crew goes ahead without asking. It asks through an Ask only about decisions outside that. A Mission's Asks appear under Needs you, and you can answer them inside the tab. Like other Asks, you can also answer them in the Ask window or, if set up, in a Discord, Slack, or Chatwork DM.
The Crew adds your answer to the decisions in the README and does not ask about the same kind of thing again.
Needs you also shows a child task for the Mission that is waiting for approval or has stopped. Open takes you to that task.
Pausing and ending
These buttons are at the top of a Mission's contents.
| Button | What it does |
|---|---|
| Pause | The Crew stops moving that Mission forward. Autoruns for the Mission also stop |
| Resume | Moves a paused Mission forward again. Stopped Autoruns come back too |
| Mark achieved | Ends it as achieved |
| Mark cancelled | Ends it as cancelled |
Mark achieved and Mark cancelled end the Mission after a confirmation. An ended Mission cannot be resumed. Autoruns for the Mission stop, and unanswered Asks close. To continue, ask for it as a new Mission.
The owner decides to pause, resume, achieve, or cancel. When the Crew decides "the criteria are met," or someone asks it in chat to "pause it," the owner receives (Crew name)'s Mission confirmation from the Crew. Nothing changes until the owner approves.
Common pitfalls
- When the periodic check is off, Missions do not move forward on their own. The tab shows Periodic checks are off, so (Crew name) will not advance its Missions by itself. Use Open Schedule to turn the periodic check on
- Without a membership, check-in times are approximate. They depend on the periodic check's interval and hours
- The list of Missions is kept inside Cockpit. Deleting files in
missions/in the home does not remove the list. Deleting the Crew removes the list too, and the files move to the Trash with the home - The Crew may not act right away. It moves Missions forward at periodic checks. For an urgent step, ask it directly in chat