Docs  /  GithubRestAPI + SkillLibrary

GithubRestAPI + SkillLibrary

Module: _GithubRestAPI · Files: GithubRestAPI.cpp / GithubRestAPI.hpp
Skills store: cognitive_loop.skills via _SkillLibrary (source=github_rest_api)

GitHub REST API v3 client (https://api.github.com) using libcurl, integrated so agents can retrieve typed-command plans from SkillLibrary before LLM planning.

Auth

First non-empty wins:

  1. github config token <pat> (runtime)
  2. GITHUB_TOKEN env
  3. GH_TOKEN env

Use a fine-grained or classic PAT with the minimum scopes you need (repo, read:user, etc.). Tokens are masked in status output.

Typed commands

github status
github test
github user
github repos [user|org]
github repo owner/repo
github issues owner/repo [open|closed|all]
github pulls owner/repo [open|closed|all]
github get /rate_limit
github request GET /user
github config token <pat>
github config base https://api.github.com
github config enabled true|false
github skills install          # seed SkillLibrary

Aliases: gh, githubrest, github-rest.

SkillLibrary helpers

simple skill help
simple skill list github
simple skill intent github.user
simple skill install github
simple skill outcome github_status ok

Seeded skills (github skills install)

Skill name Trigger intent Plan
github_status github.status github status
github_whoami github.user github user
github_test github.test github test
github_list_my_repos github.repos github repos
github_list_repo_issues github.issues github issues OWNER/REPO
github_list_repo_pulls github.pulls github pulls OWNER/REPO
github_get_repo github.repo github repo OWNER/REPO
github_raw_get github.request.get github get /rate_limit

Replace OWNER/REPO when promoting real plans via RSI / PromoteFromPlan.

Lua

github_status()                 -- string
github_test()                   -- ok, details
github_user()                   -- ok, body, error
github_request(method, path, body)  -- ok, http_code, body, error
github_install_skills()         -- count stored

Globals: github_rest_enabled, github_rest_status, github_rest_last_error.

Safety notes

  • Read-only convenience wrappers only (list/get). Raw github request can mutate if you pass POST/PATCH/PUT/DELETE — treat as high-risk; prefer dry-run agent policies.
  • Do not log full PATs; status masks tokens.
  • Enterprise: github config base https://github.example.com/api/v3 if needed.
Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.