ktools

ktools is a command line application that provides useful developer tools. It's built as a kotlin multiplatform project and is currently available for macos (both X64 and ARM), linux and windows targets.

Commands

• ktools --help - View all available commands
• ktools uuid - Creates a random UUID (v4 or v7), or inspects one with uuid inspect
• ktools unixtime - Unix time conversions
• ktools hash - Provides hash value for given file or string
• ktools encode - Encodes some text content to specified format
• ktools decode - Decodes some text content from specified format
• ktools prettyprint - Pretty print commonly used text like json
• ktools update - Updates ktools to the latest release
• ktools init - Installs the ktools skills into your AI coding agents
• ... and growing

Commands are written using Clikt and have help messages that can be viewed using --help option. Learn more about these commands here.

Agent skills

ktools ships skills that teach AI coding agents (Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, OpenCode and others) when and how to use it. Run ktools init to install them into every agent on your machine; run it again after ktools update to pick up the skills for the new version. See plugins/ktools for the skills and other ways to install them.

Docs

The function definitions for common code can be viewed here.

Installation

Download the latest executable from the releases page. You may have to provide executable permission for the file based on your setup.

To update an installed ktools, run ktools update. It downloads the latest release for your platform, checks it against the release's SHA-256 checksums to catch a corrupted or truncated download, and replaces the executable. Run ktools update --check to only see whether an update is available.

Note for MacOS: The OS may prevent opening the executable since the app has not been notarized. You can temporarily override the settings to allow execution by heading to privacy and security settings and allowing execution as mentioned here.

Why?

For fun, mostly. I use the terminal extensively but often have to switch away from it to do time unit conversions, hashing, etc. I wanted a handy tool that runs in the terminal and also wanted to test kotlin multiplatform as a solution for scalable cross-platform applications.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details