batch_tag_notes
ChatGPTAdd or remove tags from multiple notes at once. Provide note_ids and at least one of add_tags or remove_tags.
cancel_write_action
ChatGPTDiscard a pending write action so it can never be committed. Use it when the preview is wrong or the user declines. Already-committed actions cannot be canceled; expired previews simply become uncommittable on their own.
commit_write_action
ChatGPTExecute a previously previewed write action. Call this after reviewing the preview from any preview_* tool. The write_action_id comes from the preview response. Previews expire after 30 minutes — if expired, create a new preview.
export_project
ChatGPTExport the whole project as one JSON document: metadata, flat notes, the note tree, tasks, ideas, comments, AI analyses, public settings, and change log. Sections your token cannot read are skipped and named in omitted_sections. Use for backups, migrations, or loading everything into another tool.
get_changes_since
ChatGPTGet all changes to a project since a timestamp. Returns change log entries, modified notes, modified tasks, and counts. Use this for incremental sync: pass the last_synced_at from .nibvine.json to see what changed remotely.
get_claude_instructions
ChatGPTSTART HERE: Get complete workflow guide for this Nibvine project. Returns current project state, available tools, data types, best practices, and step-by-step instructions. Call this first in every new session.
get_context_pack
ChatGPTGet AI-optimized context pack with notes and tasks ranked by relevance to a role profile. Profiles: 'coding' (architecture, APIs, bugs), 'founder' (vision, priorities, market), 'product' (UX, roadmap, feedback), 'marketing' (positioning, messaging), 'fundraising' (traction, metrics), 'support' (recent issues). Returns structured data + pre-rendered exports (markdown, llm_document, compact_summary).
get_idea
ChatGPTRead a single idea in full by idea_id. Call list_ideas(project_id) first to discover idea IDs.
get_note
ChatGPTRead a single note's full content by note_id. Use when you need the complete text of a specific note. To browse notes hierarchically, use get_note_tree. To search by keyword, use search_notes.
get_note_children
ChatGPTList the direct children of a note in sibling order, with each child's own children count. Cheaper than get_note_tree when you only need to walk one level at a time.
get_note_path
ChatGPTGet the breadcrumb from the project root down to a note: every ancestor in order plus a human-readable 'A / B / C' string. Use it to explain where a note lives before moving or updating it.
get_note_tree
ChatGPTGet hierarchical note tree (parent-child structure) for a project. Shows note titles, types, tags, and nesting. Use this to understand how notes are organized or to find parent_note_id for creating child notes. Use search_notes to find notes by keyword instead.
get_project
ChatGPTRead full project metadata: vision, goal, description, tech_stack, target_audience, success_metrics, constraints, completion_percentage. Use this when you need to inspect or update specific project fields. For AI-optimized context with notes and tasks, use get_context_pack instead.
get_project_context
ChatGPTRead project metadata + 5 latest notes + 5 latest changes in one call. Lightweight alternative to get_context_pack when you don't need profile-based ranking. Prefer get_context_pack(profile=...) for curated, role-specific context.
get_project_stats
ChatGPTGet counts and health metrics for a project in one call: notes by type/relation/depth, tasks by status and priority, ideas, comments, analyses, members, change count, and last activity timestamps. Use it to report progress without pulling content.
get_public_settings
ChatGPTRead the public sharing settings for a project: is_public toggle, which content is shared (notes, tasks, ideas, analyses), published note branches, and the public URL. Use before updating sharing settings.
get_quick_note
ChatGPTRead one quick note with its full AI placement analysis: general summary, branch analysis, detailed analysis, placement strategy, and confidence score.
get_recent_changes
ChatGPTRead project change log: who changed what, when, and from which source (user, AI, system). Use this to see recent activity and audit trail.
get_sync_status
ChatGPTCompare local sync state with remote to detect drift. Pass local_context_version and local_updated_at from .nibvine.json. Returns whether sync is needed, how many versions behind, active project members, and task/note counts. Use this before syncing to decide what to do.
get_task
ChatGPTRead a single task's full details by task_id. Use list_tasks(project_id) first to find task IDs.
list_ai_analyses
ChatGPTList stored AI analyses for a project (presentation, audience, strategy) with token usage and cost. Set include_content=true to get the full analysis body and prompt instead of a 500-character preview.
list_ideas
ChatGPTList a project's ideas (the lightweight idea inbox that sits next to notes and tasks). Optionally filter by implementation state or a text query. Use get_idea(idea_id) for the full body.
list_invite_links
ChatGPTList the project's one-time invite links with their tokens, paths, and consumption state. Owner-only. Use preview_create_invite_link to mint a new one.
list_notes_by_tag
ChatGPTList notes in a project that contain a given tag. Returns note summaries.
list_project_members
ChatGPTList everyone with access to a project: the owner plus each membership, with username, role, active flag, and join date. Use before removing a member or issuing an invite link.
list_projects
ChatGPTList all projects you have access to. Returns id, title, category, priority, and note/task/idea counts. Use this to discover project IDs before calling other tools.
list_quick_notes
ChatGPTList your quick notes — free-form captures waiting for AI placement in the note tree (draft, analyzing, ready_for_review, confirmed, saved, cancelled). Project-scoped tokens only ever see quick notes tied to their project.
list_tags
ChatGPTList every tag used on a project's notes with how many notes carry it, ordered by frequency. Use this to discover the project's tag vocabulary before tagging or calling list_notes_by_tag.
list_tasks
ChatGPTList project tasks, optionally filtered by status. Returns title, description, status, priority, due_date. Use get_task(task_id) to read a single task in detail.
list_write_actions
ChatGPTList write actions created with this token — by default the pending previews that are still waiting for commit_write_action. Pass status='all' to include committed, expired, and canceled ones. Use it to recover a write_action_id you lost.
preview_batch_create_notes
ChatGPTPreview creating up to 100 notes in one write action. Each entry is flat and may name an existing parent_note_id; parents created in the same batch are NOT addressable — use preview_import_notes for a new hierarchy. Returns a write_action_id — review, then commit.
preview_create_idea
ChatGPTPreview adding an idea to a project's idea list. Ideas are flat, lightweight sparks — use notes for structured knowledge and tasks for work items. Returns a write_action_id — review, then commit. Preview expires in 30 minutes.
preview_create_invite_link
ChatGPTPreview minting a new one-time invite link that lets another person join the project as a member. Owner-only. The committed result contains the token and the shareable URL. Returns a write_action_id — review, then commit.
preview_create_note
ChatGPTPreview creating a new note. Set parent_note_id to nest under an existing note (use get_note_tree to find IDs). Returns write_action_id — review, then commit. Preview expires in 30 minutes.
preview_create_project
ChatGPTPreview creating a new Nibvine project. Returns a write_action_id — review the preview, then call commit_write_action to execute. Preview expires in 30 minutes.
preview_create_quick_note
ChatGPTPreview capturing a quick note — free-form text parked for later placement in the note tree, exactly like the web quick-capture box. Optionally suggest a parent note. Use this when you have a thought worth keeping but no clear home yet; use preview_create_note when you know where it belongs. Returns a write_action_id — review, then commit.
preview_create_task
ChatGPTPreview creating a new task. Returns write_action_id — review, then commit. Preview expires in 30 minutes.
preview_delete_idea
ChatGPTPreview deleting an idea permanently. Returns a write_action_id — review, then commit. Consider preview_update_idea(is_implemented=true) instead when the idea was simply completed.
preview_delete_note
ChatGPTPreview deleting a note. By default cascades (deletes children too). Set cascade=false to reparent children to the deleted note's parent. Returns write_action_id — review, then commit.
preview_delete_project
ChatGPTPreview deleting an entire project with all of its notes, tasks, ideas, comments, analyses, and history. Owner-only and irreversible: confirm_title must exactly match the project's current title. Returns a write_action_id — review the counts in the preview, then call commit_write_action.
preview_delete_task
ChatGPTPreview deleting a task. Returns a write_action_id — review the preview, then call commit_write_action. Deletion is permanent; prefer preview_update_task(status='done') to close work you want to keep. Preview expires in 30 minutes.
preview_import_notes
ChatGPTPreview importing a whole note subtree in one call. notes is a nested array where each node may carry its own children array, so a full branch (parents and descendants) is created by a single commit. Attach it under parent_note_id or omit that for new root branches. Limits: 200 notes and 10 levels per import. Returns a write_action_id whose preview contains the outline — review, then commit.
preview_move_note
ChatGPTPreview re-parenting a note (with its whole subtree) and/or repositioning it among its siblings. Pass new_parent_note_id=null to move it to the project root; omit it to keep the current parent and only change position. position is the zero-based index among the target siblings; omit to append last. Depth and order of every descendant are recomputed on commit.
preview_remove_member
ChatGPTPreview revoking a member's access to a project by deactivating their membership. Owner-only; the owner cannot be removed. Identify the member by username or user_id from list_project_members. Returns a write_action_id — review, then commit.
preview_reorder_notes
ChatGPTPreview reordering a sibling group. note_ids is the new front-to-back order and must contain direct children of parent_note_id (omit parent_note_id to reorder the project's root notes). Siblings you leave out keep their relative order after the listed ones. Returns a write_action_id — review, then commit.
preview_update_idea
ChatGPTPreview updating an idea. Pass only the fields you want to change — typically is_implemented=true once the idea ships. Returns a write_action_id — review, then commit.
preview_update_note
ChatGPTPreview updating an existing note. Pass only the fields you want to change. Call get_note(note_id) first to see current content. Returns write_action_id — review, then commit. Preview expires in 30 minutes.
preview_update_project
ChatGPTPreview updating project metadata. Pass only the fields you want to change. Returns a write_action_id — review, then commit. Preview expires in 30 minutes. Call get_project first to see current values.
preview_update_task
ChatGPTPreview updating an existing task. Pass only changed fields. Call get_task(task_id) or list_tasks(project_id) to find task IDs. Returns write_action_id — review, then commit. Preview expires in 30 minutes.
search_notes
ChatGPTFull-text search across note titles and content. Returns matching notes with snippets. Use get_note_tree for hierarchical browsing instead, or get_context_pack for curated AI context.
update_public_settings
ChatGPTUpdate public sharing settings for a project. Toggle is_public to enable/disable the public page. Choose what to share: notes, tasks, ideas, analyses. Set published_note_ids to select which root-level note branches appear on the public page. Set regenerate_token=true to invalidate old share links. Changes apply immediately (no preview/commit needed).
whoami
ChatGPTReport the identity behind this connection: the Nibvine user, whether the credential is a scoped external token or a user token, its scopes, its project binding (if any), the accessible project IDs, and exactly which tools your scopes allow or block. Call this when a tool fails with a scope error.