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.bluethroatlabs.com.

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

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.0
File Size Uploaded
bluethroat-0.1.0.tar.gz 12.0 kB Details

Built distribution (wheel)

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

Total release size: 28.0 kB

Release files / bluethroat-0.1.0.tar.gz

Download URL bluethroat-0.1.0.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
bcac26c82016f9cb54d34c315043ad738c303683707290f52d9178474229e2e1
BLAKE2b-256 checksum
How to use checksums
0b5b8daa964334fffa83c53d191fdda192209d4c9a2d058ef33237e5f34766c8
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.0-py3-none-any.whl

Download URL bluethroat-0.1.0-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ac4b36553fdc269803deaa5541fa0f7e36dd68c9ff205f630fc87050dd58a83b
BLAKE2b-256 checksum
How to use checksums
f49e9e63b239ad8aebddbd5db3f05c0932b9ffc3441d868146716afe235658a7
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

0.1.1

2 release files

This release

0.1.0 This release

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