add_features_bulk
ChatGPTAdd many features (and optional tasks) at once — same as the app bulk import. Duplicate names on the project are uniquified. Returns created features with task ids.
add_task
ChatGPTAdd a task to a feature (appended at the end). Default completion is 0. If you set completion, use 10% half-box steps (0, 10, … 100) like the app.
create_project
ChatGPTCreates a project in the user’s primary workspace (same as in-app New project): unique name/slug, start and end dates, optional tags. Include features to create its feature/task tree in one transaction. For creation plus a live card, prefer create_project_with_progress. Optional template_id copies features and task titles from a project saved as a template; task completion resets to 0. Default color is Trackiverse red #ef4444.
create_project_section
ChatGPTCreate a named feature section on a project. Create the section first, then pass its id as section_id to upsert_feature.
create_project_snapshot
ChatGPTSave a version-history backup of the project (same idea as in-app history): metadata, tags, features, and tasks. Use before risky edits.
create_project_with_progress
ChatGPTUse when the user asks to create a project with features/tasks and show its live progress card. Creates the entire project atomically and returns the interactive card in one call. Do not create or read the project with separate tools first. Identical retries return the same project.
create_share_link
ChatGPTCreate a client report / share link. Progress is frozen at creation time (same as in-app share). Modes: public (free), public_password/standard (Pro+), team (Team). Returns the board URL and the printable report URL. role is usually viewer.
delete_feature
ChatGPTDeletes a feature and all of its tasks. Saves a version-history snapshot first. Only after the user clearly asked to delete: set user_confirmed_destructive=DELETE.
delete_project
ChatGPTPermanently deletes a project and its features, tasks, and tags. Saves a version-history snapshot first so it can be recovered. Only after the user clearly asked to delete: set user_confirmed_destructive=DELETE.
delete_project_section
ChatGPTDelete a named project section and move its features to Main. Only after the user clearly asked to delete: set user_confirmed_destructive=DELETE.
delete_project_snapshot
ChatGPTPermanently delete one version-history snapshot (frees a snapshot slot). Only after the user clearly asked to delete: set user_confirmed_destructive=DELETE.
delete_task
ChatGPTDelete one task from its feature. Only after the user clearly asked to delete: set user_confirmed_destructive=DELETE. No automatic snapshot — call create_project_snapshot first if they may want to undo.
duplicate_feature
ChatGPTDuplicate a feature and its tasks in the same project (name becomes “… (Copy)”). Task completions are copied. Same idea as duplicate in the app.
get_feature_detail
ChatGPTLoad one feature by id, including all tasks. Use when you already have feature_id. The widget refreshes with this after edits. In ChatGPT, call render_feature_panel for the interactive card.
get_feature_status
ChatGPTLook up one feature by project + feature name. Returns tasks, roll-up %, and what’s incomplete. Use when the user named a feature. If several match, returns AMBIGUOUS_FEATURE. In ChatGPT, then call render_feature_panel with feature_id. Prefer get_feature_detail when you already have feature_id.
get_progress
ChatGPTUse for “how is the project going?” Returns rolled-up completion (mean of task completions, 0–100), feature/task counts, and the feature list. In ChatGPT, then call render_project_progress_widget with the same project_id to show the card.
get_project
ChatGPTLoad one project by id with the full feature and task tree, plus progressPercent (average of task completions). Use after you have a project_id. Prefer get_progress for “how is it going?” and get_project_by_slug when the user gave a URL slug.
get_project_by_slug
ChatGPTLook up a project from its URL slug (the path segment in the Trackiverse URL). Same full tree as get_project. Use when the user pasted a project URL, not as the default “how is it going?” tool. Fails with AMBIGUOUS_SLUG if more than one project matches.
get_project_snapshot
ChatGPTLoad one version-history snapshot (full v1 JSON) to inspect or prepare a restore.
list_project_snapshots
ChatGPTList version-history snapshots you created. Snapshots remain after a project is deleted (project_id may be null). Filter by project_id or list all for this account.
list_projects
ChatGPTLists projects the signed-in user can open, newest first. Includes archived projects — skip archived:true unless the user asked about archived work. Each row: id, slug, name, dates, color, template_saved, archived, tags. Does not expand features or tasks. There is no star/favorite filter; starring is app-only.
list_share_links
ChatGPTList client report / share links for a project (mode, role, expiry, revoked, report URL when available).
render_feature_panel
ChatGPTShow the inline feature card in ChatGPT (tasks with the same 10% half-box controls as the app). Call get_feature_detail or get_feature_status first, then pass that feature_id. Do not use this as the first lookup.
render_project_progress_widget
ChatGPTRead current project progress and show the inline card in ChatGPT (features and overall %). Pass the known project UUID directly. If you only know the name, resolve it first. Reply in one short sentence after rendering.
reorder_features
ChatGPTReorder features on a project (same as drag-and-drop in the app). ordered_feature_ids must list every feature id on the project exactly once.
reorder_tasks
ChatGPTReorder tasks on a feature (same as drag-and-drop in the app). ordered_task_ids must list every task on that feature exactly once.
resolve_project_and_feature
ChatGPTTurn a spoken project or feature name into ids. project_query may be an id, URL slug, or distinctive name. Optional feature_query matches a feature in that project. On AMBIGUOUS_PROJECT or AMBIGUOUS_FEATURE, show candidates and do not guess. Omit feature_query to resolve only the project.
restore_project_snapshot
ChatGPTRestore a version-history snapshot onto target_project_id (overwrites name, tags, features, and tasks). Destructive. Only after the user confirms: set user_confirmed_destructive=RESTORE. Prefer a throwaway project, or snapshot first.
revoke_share_link
ChatGPTTurn off a share or client-report link so it can no longer be opened.
save_as_template
ChatGPTMarks a project as a template (same as Save as template in the app) so New project / create_project can copy its features and task titles. Completions on copies start at 0.
search_tasks
ChatGPTFind tasks in a project by name, or list what’s left (incomplete_only). Same as scanning feature lists in the app. project_query is a name, slug, or id. Use before update_task when you need a task id.
update_project
ChatGPTEdit a project’s name (slug updates), color, start/end dates (YYYY-MM-DD; start on or before end), and/or tags — same fields as the in-app edit dialog. Omit a field to leave it unchanged; pass tag_names (including []) to replace the full tag set.
update_project_section
ChatGPTRename a named project section.
update_task
ChatGPTRename a task and/or set its completion. Completion uses the same 10% half-box steps as the app (0, 10, … 100). Pass at least one field. Does not create, delete, or reorder tasks.
upsert_feature
ChatGPTAdd a feature to a project (omit feature_id; name required) or edit an existing one (set feature_id; pass name and/or description). New features append at the end of the list, same as New feature in the app.