Metadata-Version: 2.4
Name: navig-github
Version: 0.2.1
Summary: NAVIG GitHub module — the full GitHub toolbox (backup, mirror, export, manage) wired into `navig github`. A first-party navig plugin (free, toggleable).
Author-email: NAVIG Development Team <opensource@navig.run>
License-Expression: Apache-2.0
Project-URL: Homepage, https://navig.run
Project-URL: Documentation, https://navig.run/docs
Keywords: navig,cli,agent,automation,plugin,github,git,backup,mirror
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: schedule>=1.2.0
Dynamic: license-file

# navig-github

NAVIG GitHub module — the **full GitHub toolbox** (backup, mirror, export, restore,
analytics, scheduling) wired natively into `navig github`. A first-party navig plugin
(free, toggleable).

**License:** Apache-2.0 · **Version:** 0.2.0

## What it is

`navig-github` is a **first-party NAVIG plugin** — it extends NAVIG itself (CLI verbs +
gateway routes), and it is free and toggleable. Plugins are different from
*blocks*: a plugin adds capabilities to the platform; a block is an outcome you
*apply* with `navig apply`.

The GitHub engine is bundled in-package (`navig_github.engine`) and
mounted **in-process**: every engine command is a `navig github` subcommand, and a
group callback injects the vault token (`github_token`) into `GITHUB_TOKEN` so the
whole surface authenticates automatically.

```
navig github token set <PAT>          # store the token in the navig vault, once
navig github backup <user> -y         # mirror every repo (curated wrapper)
navig github issues owner/repo        # export issues (in-process)
navig github releases owner/repo      # download releases + assets
navig github verify ./mirrors         # backup integrity check
navig github --help                   # the full surface, grouped by panels
```

## Install

It ships in the NAVIG monorepo and loads automatically when NAVIG is installed.
To add/enable it explicitly:

```
navig plugin add navig-github
```

Check wiring and toggle state:

```
navig store list
```

## Development

This package lives in the NAVIG monorepo under `plugins/navig-github/`. It registers via
the `navig.plugins` entry-point group; CLI verbs register via `navig.commands`.
