nagient-tool-github-api

Official Nagient GitHub API tool plugin. It keeps GitHub credentials and API behavior outside the core package while preserving approval checks for writes.

Install

Install the latest Nagient runtime first:

curl -fsSL https://ngnt-in.ruka.me/install.sh | bash
nagient version

Install the verified GitHub API plugin from Plugin Hub:

nagient plugin install nagient.github_api

For a direct, reproducible install from this repository, pin the plugin tag:

nagient plugin install https://github.com/KOSFin/nagient-tool-github-api.git --ref v0.2.1

Configure

Create a GitHub personal access token in the environment, then enable the external plugin profile:

nagient setup tool github_api --plugin nagient.github_api --enable \
--set token_secret=GITHUB_TOKEN
nagient preflight

The token_secret value is the secret name, not the token itself. Read operations include get_authenticated_user and list_repositories, so the agent can verify the connected account before claiming GitHub access. Issue creation and comments remain approval-gated by the manifest.

Development

Run the contract tests from a checkout where Nagient is installed:

python -m unittest discover -s tests -p 'test_*.py' -v