beckett

Use this when the user wants a saved recipe removed. Archives it; it isn't permanently deleted.

beckett_archive_recipe

Use this when the user no longer needs a task but doesn't want it deleted. Archives it out of their open tasks. To delete one permanently, use beckett_prepare_delete.

beckett_archive_task

Archive one saved beckett media item identified by ref. This removes it from the active library but does not permanently delete it.

beckett_archive_media

Use this when the user wants a file, image, or link kept with a project. Attaches files or images shared in the conversation, or a link.

beckett_attach_to_project

Use this when the user wants a grocery list for a meal plan and no grocery list is active. Creates a list from the plan's meals. When a list is already active, add to it with beckett_add_groceries instead.

beckett_build_grocery_list

Use this when the user bought items, or wants them unchecked again. Checks or unchecks items on a grocery list.

beckett_check_off_groceries

Use this when the user finished a task. Marks it complete.

beckett_complete_task

Use this when the user says how two saved people, places, or organizations are related, such as family, work, or friends. Saves the connection, with optional context.

beckett_connect_people

Use this when the user wants a separate calendar for a set of events, such as family or work. Creates a private beckett calendar with a name and color.

beckett_create_calendar

Use this when the user wants a recurring prompt or nudge in beckett, such as a weekday nudge to log a run or a Sunday prompt to plan the week. Schedules a check-in with its type, time, label, frequency, and the question to ask. A one-time reminder is a task; use beckett_create_task.

beckett_create_check_in

Use this when the user asks for a new grocery list or none is active. Creates a list, optionally with items and saved recipes' ingredients. Otherwise add to the active list with beckett_add_groceries.

beckett_create_grocery_list

Use this when the user plans meals for a week or a set of dates. Creates a plan with its dates and meals, each tied to a saved recipe or just named.

beckett_create_meal_plan

Use this when the user starts planning something with several parts, such as a trip, a move, or a renovation. Creates a project with a name, description, and icon; then add checklists, tables, and other blocks with beckett_add_project_block.

beckett_create_project

Use this when the user wants a to-do or a reminder, even one with a time. Creates a task with an optional due date, reminder, priority, people, project, recurrence, and subtasks. For a reminder, set due_at and reminder_minutes_before. Appointments and other scheduled occurrences are events; use beckett_create_event.

beckett_create_task

Use this when the user mentions an appointment, meeting, or other plan with a day or time. Adds it to their calendar with an optional end time or all-day flag, location, recurrence, reminder, people, notes, and project. A to-do with a due date is a task; use beckett_create_task.

beckett_create_event

Permanently delete the record a prepared deletion names, using its short-lived confirmation.

beckett_execute_delete

Use this when the user wants an attached file, image, or link removed from a project.

beckett_detach_from_project

Use this when the user asks about the people, places, or organizations they've saved, or to find someone's ref. Lists saved people and other named subjects, filtered by name or type.

beckett_find_people

Use this when the user asks who someone is or what they know about them, or wants to get ready to see them. Looks up a saved person, place, or organization by name or ref, with the notes saved about them and how they're connected to others.

beckett_get_person

Use this when the user asks about a project or where they left off. Returns its details: summary, linked people, and pinned notes. For its checklists, tables, and other blocks, use beckett_list_project_blocks.

beckett_get_project

Get one saved beckett media item by its ref.

beckett_get_media

Use this when saved people or notes belong with a project. Links the people to it and pins the notes.

beckett_link_to_project

Use this when the user asks for a link they saved. Lists saved links with their titles, sites, and status, filtered by text or status.

beckett_list_bookmarks

Use this when the user asks which calendars they have, or before adding an event to a particular calendar. Lists their beckett calendars.

beckett_list_calendars

Use this when the user asks which check-ins they have, or before changing one. Lists their scheduled check-ins with full details.

beckett_list_check_ins

Use this when the user asks about their schedule or a particular appointment. Lists events with full details for a date range, calendar, or project, including recurring occurrences and multi-day events. Give from_at and to_at as ISO 8601 times with UTC offsets; to_at is exclusive. Without a range, returns upcoming and in-progress events. Returns up to 50; if truncated is true, the list is incomplete.

beckett_list_events

Use this when the user asks what they need to buy, or before adding groceries. Lists grocery lists with their items, filtered by name or status. Add to the active list rather than starting a new one.

beckett_list_grocery_lists

Use this when the user asks about planned meals, or before changing a meal plan. Lists meal plans with every planned meal.

beckett_list_meal_plans

Use this when the user asks about a project's checklists, tables, text, or files, or before changing a block. Lists the project's blocks and attachments with their full content. Needs the project's ref from beckett_list_projects.

beckett_list_project_blocks

Use this when the user asks about their projects or plans, or to find a project's ref. Lists projects, filtered by name, optionally including archived ones.

beckett_list_projects

Use this when the user asks what's due, what they need to do, or about a particular to-do. Lists tasks with full details, filtered by text, status, priority, due date, project, or parent task. Defaults to open top-level tasks; set due to none for undated ones. Date filters take ISO 8601 times with UTC offsets. Returns up to 50; if truncated is true, the list is incomplete.

beckett_list_tasks

Prepare the permanent deletion of one task, event or recurring event series, check-in, project block, grocery list, or bookmark, and obtain its short-lived confirmation.

beckett_prepare_delete

Use this when the user wants to decide what to work on first today or on another day. Sets up to four priority tasks for that day: the ones the user names, in their order, or beckett's picks from their open tasks when they don't name any.

beckett_prioritize_tasks

Use this when a saved connection is wrong or no longer true. Removes the link between two saved people or subjects, or between two linked notes.

beckett_remove_connection

Use this when the user no longer needs items on a grocery list. Removes them by ref or by name.

beckett_remove_groceries

Use this when the user takes meals off a meal plan.

beckett_remove_meals

Use this when the user wants checklist items or table rows taken out of a project block.

beckett_remove_project_items

Use this when the user wants a project's blocks in a different order. Give the block refs in the new order.

beckett_reorder_project_blocks

Use this when the user wants an archived project back.

beckett_restore_project

Use this when the user shares a link to keep for later. Saves it, and beckett reads the page in the background. Saving a link that's already saved returns it, and tries reading the page again if that failed. Recipe links go to beckett_save_recipe, and books, movies, and shows to beckett_add_media.

beckett_save_bookmark