donebear.com

Done Bear is a GTD-style task manager. Tasks live in views: Inbox, Today, Upcoming, Anytime, Someday, Logbook (completed), and Trash (archived). get_context is orientation, not a warm-up. Call it when you need to resolve a project, label, team, or member by name, or when the user asks what is in their workspace, and skip it otherwise: going straight to the tool that answers the question is faster and the tools resolve names themselves. Pass the user's IANA timezone (e.g. Australia/Melbourne) to every tool that accepts it — Today and Upcoming are calendar-day dependent, and without a timezone the server resolves "today" in UTC. A new task goes to Today by default: task_add without a `when` schedules it for the caller's today. Pass `when: "inbox"` when the user is only capturing something. This makes the timezone matter on every create, not just on reads. Three things change that default when you do not state a `when`: no `timezone` and it lands in anytime, because today cannot be resolved; a `deadline` and it lands in anytime, because the work is due later rather than now; a `project` or `team` and it lands in inbox, because the task is already filed and should not also fill up Today. Dates are YYYY-MM-DD. Tasks use a workspace-scoped positive number in the `task` parameter, and every task write also takes `tasks` for up to 50 of them at once. Checklist item ids accept a full UUID or a prefix of 4+ characters; projects, teams, labels, and members also resolve by name. Failed lookups name the candidates, so read the error before retrying. The tools are shaped by what you are working on rather than by operation: `checklist`, `comment`, `attachment` and `project` each take an `action`, and `task_show` returns a task's checklist, labels and (via `include`) its comments and files. Confirm with the user before anything that touches many tasks at once or is hard to undo: a `tasks` array, archiving, removing a comment, and clearing fields. Call `guide` for the detail on a topic before working in it for the first time: - `views`: Placing a task in Inbox/Today/Upcoming/Anytime/Someday, reading a view, or working out why Today looks wrong. - `dates`: Setting or clearing a due date, or deciding between a deadline and a start date. - `editing`: Changing a task's fields, clearing a value, appending to notes, or moving a task between projects. - `bulk`: Completing, moving, or editing more than one task at a time, or sweeping a whole view. - `checklists`: Adding sub-steps to a task, building a list inside a task, or ticking items off. - `comments`: Discussing a task with teammates: reading its thread, replying, or correcting a comment. - `projects`: Deciding where a task belongs, creating a project or label, changing a project's status, or joining/leaving a project. - `search`: Looking a task up, listing a view, paging through results, or orienting in a new workspace. - `workspaces`: Working across multiple workspaces, hitting a permission or rate-limit error, or making retries safe. - `agents`: Starting work in a Done Bear workspace for the first time. - `importing`: The user asks how to move their tasks in from Todoist, Things, Trello or a CSV.