## About
kftray and kftui manage Kubernetes port forwards from your desktop or terminal. Both apps share configurations and a Rust backend that reconnects forwards when pods restart or connections drop.
- [kftray](https://kftray.app/docs/interfaces/desktop) runs as a desktop app with system tray integration.
- [kftui](https://kftray.app/docs/interfaces/terminal) runs in the terminal, with a CLI for scripts and headless use.
Watch the [app overview](https://www.youtube.com/watch?v=j2NnhIIFYHw) or the [HTTP logging demo](https://www.youtube.com/watch?v=73PyGbMnNSY).
## Features
- Run multiple forwards across Kubernetes contexts without `kubectl`.
- Forward TCP and UDP traffic to services or pods, or reach other hosts through a cluster proxy.
- Expose local services to the cluster or through an ingress.
- Inspect HTTP traffic and replay requests in kftui.
- Share configs through GitHub or discover services from Kubernetes annotations.
- Organize configs with tags, filters and grouping.
See the [documentation](https://kftray.app/docs) for configuration options and app behavior.
## Get started
Download [kftray or kftui](https://kftray.app/downloads), follow the [installation guide](https://kftray.app/docs/getting-started/installation) and create your [first port forward](https://kftray.app/docs/getting-started/quick-start).
- [Configuration](https://kftray.app/docs/configuration): fields, workload types and shared settings.
- [CLI reference](https://kftray.app/docs/resources/cli-reference): flags and commands for kftui.
- [Architecture](https://kftray.app/docs/resources/architecture): the shared core and cluster relay.
- [Security](https://kftray.app/docs/resources/security): vulnerability reporting and release verification.
- [Releases](https://github.com/hcavarsan/kftray/releases): changes and release assets.
## Contributing
Read the [contribution guide](https://kftray.app/docs/resources/contributing) and [code of conduct](https://kftray.app/docs/resources/code-of-conduct). For local builds, see [development](https://kftray.app/docs/resources/development) and [building from source](https://kftray.app/docs/resources/building-from-source).
Release scans block publication on High or Critical vulnerabilities. Each Grype step prints its findings in the job log and saves a JSON report.
Report bugs or request features through [GitHub issues](https://github.com/hcavarsan/kftray/issues). Use [Discussions](https://github.com/hcavarsan/kftray/discussions) or [Slack](https://join.slack.com/t/kftray/shared_invite/zt-2q6lwn15f-Y8Mi_4NlenH9TuEDMjxPUA) for questions.
## License
kftray is licensed under [GPL-3.0](LICENSE).
## Star History
## Contributors
Contributors are listed below using the [all-contributors](https://allcontributors.org/docs/en/emoji-key) contribution types.
