Context-Aware
CLI Framework.

Building interactive command-line tools with fuzzy search menus and modular command architecture. Works like Git, Poetry, or Terraform—install once, use everywhere.

01 // The Philosophy

Automation meets interaction.

Building CLI tools often feels like choosing between two extremes: a rigid, complex framework that takes days to learn, or a messy collection of scripts that are impossible to maintain. Clingy solves "CLI fatigue" by providing a framework where you build the logic once, and the framework provides the interface.

02 // Core Architecture

Zero-Boilerplate

Just drop a file in your commands/ folder, and it's instantly available in your CLI. No manual registration, no complex routing.

Interactive by Default

Every command you write automatically gains a fuzzy-searchable menu powered by fzf.

Submenu Architecture

Use our intuitive node-based system to build complex, nested menus that feel like professional-grade software.

Context-Aware

Like Git, Clingy automatically detects your project root. Run it from any subdirectory, and it knows exactly where it is.

03 // Installation

Using uv (recommended):

uv pip install clingy

Using pip:

pip install clingy

Required Dependency

fzf (fuzzy finder). Install via brew, apt, pacman, etc.

04 // Quick Start

Step 1: Initialize

mkdir my-tool && cd my-tool
clingy init

Step 2: Run

clingy                # Interactive mode
clingy greet --name User  # CLI mode

Step 3: Update Framework

clingy --update-template

05 // Documentation Hub

Framework Reference

Project Templates

> Basic Template (Prototyping)
> Konfig Template (Dotfiles)
> Serverless Template (AWS Lambda)

06 // Development

# Install in editable mode
pip install -e .

# Run tests
pytest tests/

# Format code
black . --line-length 100
isort . --profile black