TKIT - Customizable Tool Manager

A Rust CLI tool that works like a package manager with customizable install scripts. Similar to make, it allows you to define complex installation, removal, and update procedures for any tool through simple YAML configuration.

Installation

cargo install tkit

Or build from source:

git clone https://github.com/ThembinkosiThemba/tkit
cd tkit
cargo build --release
sudo cp target/release/tkit /usr/local/bin/

Quick Start

1. Initialize configuration:

tkit init

2. List available tools:

tkit list

3. Install a tool:

tkit install node

4. Add a custom tool:

tkit add mytool

Commands

• tkit install <tool> - Install a tool using its defined install commands
• tkit remove <tool> - Remove a tool using its defined remove commands
• tkit update <tool> - Update a tool using its defined update commands
• tkit list - List all available tools and their status
• tkit add <tool> - Add a new tool configuration interactively
• tkit init - Initialize configuration with example tools

Configuration

Tools are configured in ~/.config/tkit/config.yaml. Each tool can have:

• install_commands: List of commands to install the tool
• remove_commands: List of commands to remove the tool
• update_commands: List of commands to update the tool
• description: Optional description of the tool

Example Configuration

tools:
  node:
    name: node
    description: Node.js runtime
    install_commands:
      - curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
      - sudo apt-get install -y nodejs
    remove_commands:
      - sudo apt-get remove -y nodejs
    update_commands:
      - sudo apt-get update
      - sudo apt-get upgrade -y nodejs
    installed: false

  rust:
    name: rust
    description: Rust programming language
    install_commands:
      - curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
      - source ~/.cargo/env
    remove_commands:
      - rustup self uninstall -y
    update_commands:
      - rustup update
    installed: false

Use Cases

• Development Environment Setup: Install language runtimes, databases, tools
• Server Provisioning: Automate installation of services and dependencies
• Personal Tool Management: Keep track of installed tools and their versions
• Team Onboarding: Share consistent installation procedures
• Cross-Platform Scripts: Define platform-specific installation commands

Examples

Adding a Complex Tool

tkit add kubernetes
# Follow prompts to add install/remove/update commands

Multi-Step Installation Example

When adding a tool like Docker, you might define:

Install commands:

1. curl -fsSL https://get.docker.com -o get-docker.sh
2. sudo sh get-docker.sh
3. sudo usermod -aG docker $USER
4. rm get-docker.sh

Remove commands:

1. sudo apt-get remove -y docker docker-engine docker.io containerd runc
2. sudo rm -rf /var/lib/docker

Update commands:

1. sudo apt-get update
2. sudo apt-get upgrade -y docker-ce

Features

• ✅ Interactive tool addition
• ✅ Command execution tracking
• ✅ Installation status tracking
• ✅ Colored output for better UX
• ✅ Error handling with descriptive messages
• ✅ Cross-platform configuration storage
• ✅ YAML-based configuration
• ✅ Example tools included

Publishing to crates.io

1. Update version in Cargo.toml
2. Build and test: cargo build --release && cargo test
3. Publish: cargo publish

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details.