Gist

20 tools available

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.

developer tools

Connect Gist Visit Gist ↗

Connect Gist to Definable to triage issues, review pull requests, monitor builds. Personas call Gist's 20 tools directly from chat or scheduled flows. Wire it into a triage, review, or release-management persona — every action runs scoped, reviewable, and logged.

Common workflows with Gist

Triage incoming issues

Webhook fires on every new issue
Persona summarises and labels it
Assigns the right engineer

Auto-review PRs

Pull the diff
Run a code-review persona
Post structured feedback as PR comment

Failing-build alerts

CI sends a failure event
Agent inspects logs and stack trace
Drops a debug summary in Slack

Release notes from commits

Read commits since last tag
Group by type with the model
Post to a changelog channel

Gist actions 20

Every Gist action below is a callable tool any Definable persona can invoke.

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

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.

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

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

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 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.

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.

Frequently asked questions

What can I automate with Gist on Definable?

Anything Gist exposes through its API. Common developer tools workflows on Definable include triage issues, review pull requests, monitor builds. Personas can call any of the 20 Gist tools directly, then chain the result into another integration without you writing code.

How does Gist authentication work?

Gist uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Gist integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 20 Gist tools. You only need a separate Gist subscription if Gist itself charges per seat or per API call.

Is using Gist through Definable secure?

Every call from a persona to Gist is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Gist on Definable?

Sign up for Definable, open the integrations page, find Gist, and connect via OAuth or API key. You can immediately attach Gist to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Gist actions does Definable expose?

Definable exposes all 20 Gist actions as callable tools — including `Check Gist Star`, `Create Gist`, `Create Gist Comment`, plus 17 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Gist?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations