Gist for AI agents
Agents read Gist at once. Changes and sends are held for a person's approval by default.
About Gist
GitHub Gist is a service provided by GitHub that allows users to share code snippets, notes, and other text-based content. It supports both public and private gists, enabling easy sharing and collaboration.
What an agent can do in Gist
Every Gist action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Gist without asking first. 11 actions.
- Get GistTool to retrieve a specific gist by its ID. Use when you have a gist_id and need complete gist details.
- List GistsTool 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 StarCheck 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 requ
- Get Gist CommentTool 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 RevisionTool to retrieve a specific gist revision. Use when you need details of a past state for an existing gist by commit SHA.
- List Gist CommentsTool 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 CommitsTool to list the commit history of a gist. Use after you have the gist ID to review its revisions.
- List Gist ForksTool to list forks of a gist. Use after obtaining a gist_id to retrieve all forks for the gist.
- List Public GistsTool 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 GistsTool to list the authenticated user's starred gists. Use when you need to retrieve all gists the user has starred.
- List User GistsTool to list public gists for a specified GitHub user. Use when you have a username and need their gists.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 9 actions.
- Create GistTool 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.
- Create Gist CommentTool to create a comment on a gist. Use when you need to add a comment to an existing gist.
- Delete GistTool 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 CommentTool 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 GistTool to fork a gist. Use when you need to create a copy of an existing gist under your own account.
- Star a GistStar a GitHub gist. This operation is idempotent and will succeed even if the gist is already starred.
- Unstar a GistUnstar a GitHub gist. This operation is idempotent and will succeed even if the gist is not currently starred.
- Update GistTool 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 CommentTool to update a Gist comment. Updates an existing comment on a gist. You must be the author of the comment to update it.
Changes wait in Needs you
Changes and sends in Gist are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Gist questions
Can an agent change data in Gist on its own?
Not by default. Changes and sends in Gist are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Gist?
This connector lists 11 read actions. Reads run at once, without waiting for approval.
How does Gist connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.