Metadata-Version: 2.4
Name: neuralcleave-github
Version: 0.1.3
Summary: NeuralCleave plugin — list recent GitHub repository events (pushes, PRs, issues).
Author-email: Amit Chandra <amit.vervebot@gmail.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: neuralcleave-sdk>=0.1.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.2.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Dynamic: license-file

﻿# neuralcleave-github

Example NeuralCleave plugin: a `github_events` tool that lists recent events
(pushes, PRs, issues) for a GitHub repository via the public REST API.

## Install

```bash
pip install -e ./NeuralCleave-sdk        # not yet on PyPI
pip install -e examples/plugins/neuralcleave-github
```

## Usage

Set `GITHUB_TOKEN` in your environment for authenticated requests (raises the
rate limit from 60/hr to 5000/hr) — optional, the tool works without it.

```python
from neuralcleave_github import GitHubEventsTool

tool = GitHubEventsTool()
result = await tool.execute(owner="TheAmitChandra", repo="NeuralCleave", limit=5)
print(result.output)
```

Once installed alongside the NeuralCleave gateway, `neuralcleave hub install
neuralcleave-github` (or simply having it installed in the same environment)
makes `PluginRegistry.discover()` find it via the `NeuralCleave.plugins` entry
point declared in `pyproject.toml`.
