---
id: click-repl
version: "0.3.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# click-repl — REPL plugin for Click

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install click-repl
uv add click-repl
poetry add click-repl

## Description

click-repl
===

[![Tests](https://github.com/click-contrib/click-repl/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/click-contrib/click-repl/actions/workflows/tests.yml)
[![License](https://img.shields.io/pypi/l/click-repl?label=License)](https://github.com/click-contrib/click-repl/LICENSE)
![Python - version](https://img.shields.io/badge/python-3%20%7C%203.7%20%7C%203.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)
[![PyPi - version](https://img.shields.io/badge/pypi-v0.2.0-blue)](https://pypi.org/project/click-repl/)
![wheels](https://img.shields.io/piwheels/v/click-repl?label=wheel)
![PyPI - Status](https://img.shields.io/pypi/status/click)
![PyPI - Downloads](https://img.shields.io/pypi/dm/click-repl)

Installation
===

Installation is done via pip:
```
pip install click-repl
```
Usage
===

In your [click](http://click.pocoo.org/) app:

```py
import click
from click_repl import register_repl

@click.group()
def cli():
    pass

@cli.command()
def hello():
    click.echo("Hello world!")

register_repl(cli)
cli()
```
In the shell:
```
$ my_app repl
> hello
Hello world!
> ^C
$ echo hello | my_app repl
Hello world!
```
**Features not shown:**

-...

## AI interpretation — verify before relying

Adds an interactive REPL (read-eval-print loop) mode to Click command-line applications, letting users run CLI commands interactively with tab completion, command history, and persistent context between invocations.

Verdict: Lightweight, well-maintained REPL layer for Click apps with no known vulnerabilities. MIT license and low install friction make it suitable for most projects. Best suited for CLI tools where interactive session state and command history add user value.

[View on SkillFed](https://skillfed.io/packages/click-repl) · [View on PyPI](https://pypi.org/project/click-repl/)