agentskit.js
ToolsIntegrations

githubActions

GitHub Actions — list runs and trigger workflow_dispatch events.

import { githubActions } from '@agentskit/tools/integrations'

const tools = githubActions({
  token: process.env.GITHUB_TOKEN!,
  defaultRepo: 'AgentsKit-io/agentskit',
})

Bundled: githubActions(config) returns both sub-tools. Calls GitHub API v2022-11-28 at https://api.github.com.

#Sub-tools

NamePurpose
github_actions_list_runsList recent workflow runs, optionally filtered by file and status
github_actions_dispatchTrigger a workflow_dispatch event on a named workflow

#Schema

#github_actions_list_runs

ParameterTypeRequiredDescription
repostringnoowner/name. Defaults to config.defaultRepo
workflowFilestringnoe.g. ci.yml. If omitted, all workflows
statusstringnoqueued | in_progress | completed
perPagenumbernoResults per page (default 20)

#github_actions_dispatch

ParameterTypeRequiredDescription
repostringnoowner/name. Defaults to config.defaultRepo
workflowFilestringyese.g. release.yml
refstringyesBranch or tag to run against
inputsobjectnoWorkflow inputs map (workflow_dispatch.inputs)

#Example — CI status agent

import { createRuntime } from '@agentskit/runtime'
import { githubActions } from '@agentskit/tools/integrations'

const runtime = createRuntime({
  adapter,
  systemPrompt: 'You monitor CI. List failing runs and optionally re-trigger them after a fix lands.',
  tools: githubActions({
    token: process.env.GITHUB_TOKEN!,
    defaultRepo: 'my-org/my-repo',
  }),
})

await runtime.run('Show me all failed runs on the main branch from today.')

#Security

  • Env var required: GITHUB_TOKEN — a GitHub personal access token (classic) or a fine-grained token.
  • Scopes required: actions:read for listing runs; actions:write for dispatching. Fine-grained tokens should be scoped to specific repositories.
  • Triggering workflow_dispatch can deploy code or modify infrastructure — always gate via HITL in production.
  • GitHub enforces REST API rate limits of 5,000 requests/hour per authenticated token.

Explore nearby

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

On this page

Ask the docs

Ask anything about AgentsKit. Answers come from the docs corpus via OpenRouter free-tier models. Rate limited per IP.