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
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.2

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.2
File Size Uploaded
bluethroat-0.1.2.tar.gz 12.2 kB Details

Built distribution (wheel)

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

Total release size: 28.4 kB

Release files / bluethroat-0.1.2.tar.gz

Download URL bluethroat-0.1.2.tar.gz
Size 12.2 kB
Tags Source
SHA-256 checksum
How to use checksums
36eeeffeedf909b01233458a028b715a6729b4dc96ca03167424049670d8bda5
BLAKE2b-256 checksum
How to use checksums
dadea21672e4abeac32dbf723b08ec98bb957edc1e861d4639fd984e66a92ec8
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.2-py3-none-any.whl

Download URL bluethroat-0.1.2-py3-none-any.whl
Size 16.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
af4ebd65f4eab5868b6f460535d091252adc8eb8411b5be98dc2965a41d88296
BLAKE2b-256 checksum
How to use checksums
8cb2504a8443b7670cc1dd625a002d05e34401932f6ac6903edfd2ffd1d201e3
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

This release

0.1.2 This release

2 release files

0.1.1

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