Skip to main content

bluethroat

Command-line client for BlueSkills. Log in once with the Bluethroat GitHub App, then scan waits for the report and prints it.

uv tool install .
bluethroat auth login
bluethroat blueskills scan https://github.com/owner/repository --ref <commit>

Add --json for the scan document returned by the API. Without it, the command prints text.

Configuration

Variable Purpose
BLUETHROAT_GITHUB_CLIENT_ID GitHub App client ID. Defaults to the Bluethroat app (Iv23liH0YU6oTHHz0i8O).
BLUETHROAT_GITHUB_CLIENT_SECRET Optional, for development only. Revokes directly at GitHub instead of through BlueSkills. Do not put this in the distributed client.
BLUETHROAT_API_URL BlueSkills API origin. Defaults to https://blueskills-web-hzdtf5buftehbya8.z03.azurefd.net.

The same keys can live in ~/.config/bluethroat/config.json as github_client_id, github_client_secret, and api_url. Environment variables win.

The GitHub session is stored in the operating-system credential store, or in a mode 0600 file at ~/.config/bluethroat/credentials.json when that store is unavailable.

scan sends Authorization: Bearer with the GitHub user access token. BlueSkills checks it against the Bluethroat CLI GitHub App and applies limits to the GitHub user id. The access token lasts 8 hours; the CLI refreshes it with GitHub on its own, which needs no client secret for a device-flow login. auth logout asks BlueSkills (POST /auth/github/revoke) to revoke the token, since only the server holds the secret.

Release files for bluethroat 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bluethroat 0.1.1
File Size Uploaded
bluethroat-0.1.1.tar.gz 12.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bluethroat 0.1.1
File Interpreter ABI Platform
bluethroat-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 28.2 kB

Release files / bluethroat-0.1.1.tar.gz

Download URL bluethroat-0.1.1.tar.gz
Size 12.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2cbd109bc2851608161842c074ef5dc1d15a62d078dd11da77c8dffbf53fcaf0
BLAKE2b-256 checksum
How to use checksums
67704889654a4650a1c0aa13463f3281bf8f64ee89fb98e2b6fb377f74500112
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / bluethroat-0.1.1-py3-none-any.whl

Download URL bluethroat-0.1.1-py3-none-any.whl
Size 16.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa7fd441c0011b4a424cb235d93ebea5b8406430f86fbb0c75d9355dd3d40efe
BLAKE2b-256 checksum
How to use checksums
945417d3adcac75381918bd3b31f2f64091de981bd26b737e87c7f8d5ae772a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

0.1.2

2 release files

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page