Gist

These are the Gist actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create Gist

  Tool to create a new gist with one or more files. Use when you need to create a code snippet or text file to share. Note: Do not name your files 'gistfile' with a numerical suffix.

• Get Gist

  Tool to retrieve a specific gist by its ID. Use when you have a gist_id and need complete gist details.

• List Gists

  Tool to list the authenticated user's gists or all public gists if called anonymously. Use after setting a valid GitHub token in headers.

• Check Gist Star

  Check if the authenticated user has starred a specific gist. Returns True if the gist is starred, False if not starred or if the gist doesn't exist. This is a read-only, idempotent operation that requires authentication but no special permissions.

• Create Gist Comment

  Tool to create a comment on a gist. Use when you need to add a comment to an existing gist.

• Delete Gist

  Tool to delete a gist. Use when you have a gist_id and want to permanently remove that gist. Example prompt: "Delete gist 'aa5a315d61ae9438b18d'".

• Delete Gist Comment

  Tool to delete a comment on a gist. Use when you have both the gist_id and comment_id and want to remove that comment. Example prompt: "Delete comment 42 from gist 'aa5a315d61ae9438b18d'".

• Fork Gist

  Tool to fork a gist. Use when you need to create a copy of an existing gist under your own account.

• Get Gist Comment

  Tool to get a specific comment on a gist. Use when you need to retrieve details of a particular comment given gist_id and comment_id.

• Get Gist Revision

  Tool to retrieve a specific gist revision. Use when you need details of a past state for an existing gist by commit SHA.

• List Gist Comments

  Tool to list comments on a gist. Use after confirming the gist_id to retrieve comments for a specific gist. Example: 'List comments for gist abc123'.

• List Gist Commits

  Tool to list the commit history of a gist. Use after you have the gist ID to review its revisions.

• List Gist Forks

  Tool to list forks of a gist. Use after obtaining a gist_id to retrieve all forks for the gist.

• List Public Gists

  Tool to list public gists sorted by most recently updated. Use when you need to discover recent public gists. Note: with pagination, you can fetch up to 3000 gists.

• List Starred Gists

  Tool to list the authenticated user's starred gists. Use when you need to retrieve all gists the user has starred.

• List User Gists

  Tool to list public gists for a specified GitHub user. Use when you have a username and need their gists.

• Star a Gist

  Star a GitHub gist. This operation is idempotent and will succeed even if the gist is already starred.

• Unstar a Gist

  Unstar a GitHub gist. This operation is idempotent and will succeed even if the gist is not currently starred.

• Update Gist

  Tool to update a gist's description and files. Use when you need to modify gist content, rename files, or delete files from a gist.

• Update Gist Comment

  Tool to update a Gist comment. Updates an existing comment on a gist. You must be the author of the comment to update it.