untaped-github 0.13.0

GitHub user and search CLI built on the untaped SDK.

untaped-github

untaped-github is a standalone GitHub CLI built on the untaped SDK. It provides authenticated user inspection, complete org/team repository inventory, GitHub REST search across repositories, code, issues/PRs, and users/orgs, and a local Git corpus scanner for repeated team-wide code scans. It also ships the shared config, profile, and skills command groups every untaped tool ships.

Install

uv tool install untaped-github

Configure

untaped-github config set token --prompt   # bare key → this tool's section
untaped-github whoami
untaped-github --profile work whoami        # --profile works in any position

For GitHub Enterprise Server, configure the API base URL explicitly:

untaped-github config set base_url https://github.example.com/api/v3

Settings are stored per profile in ~/.untaped/config.yml (shared with the other untaped tools). Shared SDK settings such as ui.theme and http.* are per-profile keys too (e.g. untaped-github config set http.verify_ssl false).

Commands

untaped-github whoami
untaped-github repos list [PATTERN] [--org ORG]... [--team ORG/SLUG|SLUG]...
untaped-github scan sync --org ORG|--team ORG/SLUG|--repo OWNER/NAME
untaped-github scan grep PATTERN --org ORG|--team ORG/SLUG|--repo OWNER/NAME
untaped-github scan list|worktree ...
untaped-github scan clean --repo OWNER/NAME|--all [--yes|-y]
untaped-github search repos [QUERY]
untaped-github search code [QUERY]
untaped-github search issues [QUERY]
untaped-github search users [QUERY]
untaped-github config|profile|skills ...

See docs/github.md for command details and examples.

Public Client API

Sibling untaped tools may import GithubClient, GithubSettings, GithubGraphqlError, repository inventory helpers such as ResolveRepositoryInventory, and the batched ref-probe result models from untaped_github. GithubClient.batch_repo_refs(...) probes branch/tag refs; GithubClient.batch_default_branch_refs(...) probes only default branches with a connection-free GraphQL query. Both return BatchRepoRefsResult, including GraphQL cost, remaining, reset metadata, and per-repo transient failures from bounded GraphQL retry/adaptive-split handling.

Development

uv sync
uv run pytest
uv run mypy
uv run ruff check --fix
uv run ruff format
uv run untaped-github --help

See AGENTS.md for architecture rules and GitHub-specific contracts. See docs/release.md for the PyPI/TestPyPI release workflow.

Security

Please report suspected vulnerabilities privately. See SECURITY.md.

Contributing

See CONTRIBUTING.md and AGENTS.md for the local workflow, architecture rules, and GitHub-specific contracts.

License

MIT. See LICENSE.