Goals

What is a Goal?

A Goal is a personal, self-paced objective owned solely by you. It has a title and an optional description, but unlike Challenges it has no end date — you work on it at your own pace until you decide it is complete.

Because Goals are personal, they are never visible to your partner. Only you can see your Goals and the Tasks attached to them.

Status Lifecycle

Every Goal moves through three statuses:

• pending — The Goal has been created but you have not started working on it yet. This is the default status when a Goal is first saved.
• active — You are actively working on the Goal. Mark a Goal active when you are ready to begin making progress.
• completed — You have finished the Goal. Once marked completed, the Goal is archived and no longer appears in your active list.

The lifecycle flows in one direction: pending → active → completed.

Goal Tasks

Tasks are the individual action items that make up a Goal. Each Task is linked to its parent Goal via the goalId field on the Task record.

Goal Tasks support two optional scheduling fields:

• dueDate — An optional date by which you intend to complete the Task. Tasks with a past due date that have not been completed are counted as missed and affect your Karma score.
• recurrenceRule — An optional rule (in iCalendar RRULE format) that causes the Task to repeat on a defined schedule, such as daily or weekly.

Privacy

Goals and their Tasks are completely private. Only the owning user can see and complete their own Goal Tasks. Your partner cannot view your Goals, cannot see your Goal Tasks, and cannot mark them complete on your behalf.

This is the key difference between Goals and Challenges — if you want shared accountability with your partner, use a Challenge instead.

Example

Suppose you set a Goal: "I want to run a marathon."

1. You create the Goal with the title "Run a marathon". Its status starts as pending.
2. You add three Goal Tasks linked via goalId: "Run 5 km without stopping", "Complete a 10 km race", and "Finish a half-marathon". The first task has a dueDate four weeks from now; the third has a weekly recurrenceRule for long runs.
3. You mark the Goal active and start completing Tasks one by one.
4. Once all Tasks are done and you have crossed the finish line, you mark the Goal completed.

Throughout this entire journey, your partner sees none of it — the Goal and its Tasks are yours alone.