Skip to content

Repository files navigation

Kantrip

CI status MIT License Sponsor on GitHub
PyPI version

Kantrip securely manages local Kafka profiles for command-line tools and compatible applications.

Kantrip is in active pre-release development. The current CLI provides help, version information, presentation behavior, a profile schema, and a documented application environment. Profile and session commands are not implemented yet.

Features

Secure profile model

  • Versioned, non-secret Kafka profile schema
  • Operating-system credential-store references instead of plaintext secrets
  • Explicit TLS, SASL, OAuth, Schema Registry, Strimzi, and MSK IAM models
  • Classified values and safe diagnostic redaction

Application environment

  • Child-process KAFKA_* and SCHEMA_REGISTRY_* variables
  • Java, librdkafka, and Schema Registry configuration paths
  • Child-only credential exposure with no parent-shell export
  • Explicit opt-in for compatible applications

Terminal experience

  • Rich-based Arcana theme with semantic colors
  • Clean stdout/stderr separation
  • NO_COLOR, TERM=dumb, --no-color, and non-TTY behavior

Current limitations

  • Profile creation and secure-store integration are not implemented yet
  • kantrip exec, kantrip ping, adapters, and temporary-session cleanup are not available yet
  • Linux and macOS are the only planned MVP platforms
  • No Docker distribution or hosted service is planned

Quick start

pipx

pipx install kantrip

Planned MVP workflow

These commands describe the intended workflow and are not all available yet:

kantrip add local
kantrip use local
kantrip current
kantrip ping local
kantrip exec local -- kaskade admin

Usage

For configuration and usage examples, see the Kantrip usage guide.

Development

For development instructions, see the Kantrip development guide.

Releases

See GitHub Releases for release notes and downloadable artifacts.

Questions

For Q&A, go to GitHub Discussions.

Security

Report suspected vulnerabilities privately by following the Kantrip security policy.

Donations

If Kantrip is useful to you, consider supporting its development on GitHub Sponsors.

AI Assistance

This project uses AI-assisted development tools. Some code and documentation may be generated or revised with AI assistance. All AI-assisted changes are reviewed and tested by the maintainer before they are included.

Acknowledgements

Sponsored by LittleHorse Built with Rich

About

A CLI for managing and switching between Kafka environments

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Contributors

Languages