Generate an interactive, autocompleting shell for any Cobra CLI





Leverages the Cobra completion API to generate an interactive shell for any Cobra CLI, powered by go-prompt.

  • On-the-fly autocompletion for all commands
  • Static and dynamic autocompletion for args and flags, as described here
  • Full prompt customizability



go get


package main

import (
    shell ""

func main() {
	cmd := &cobra.Command{Use: "example"}
	_ = cmd.Execute()
  • Alt + Backspace to delete complete words

    Alt + Backspace to delete complete words

    Hey Brian,

    Can't believe I'm the first person creating an issue here. This project is such a great idea! I missed this automation in other projects like ishell or promptui.

    Bug / Feature Request

    I just noticed that alt + backspace behaves strangely. It will insert question marks instead of deleting complete words as I would expect it in an interactive shell.

    As it messes with the cli-ui it might be a bug to address but also a nice feature implementation that I'd love to see!

    Edit: Also ctrl+right and ctrl+left would be a great idea in order to skip through longer commands as I just noticed :D

    Thanks in advance!

    opened by cmprmsd 3
  • [Bug] Flags are permanently removed from the autocompletion

    [Bug] Flags are permanently removed from the autocompletion


    When I have e.g. two flags like the following: image

    I can use them one time. Afterwards they will be removed. This is expected and good. image

    However, when I now press up or rewrite the commands the used completion flags are gone. image


    The flags should be re-enabled after each execution.

    Edit: I saw you already tried to fix this issue in However, I'm on 0.2.4 so maybe the fix is not complete.

    opened by cmprmsd 2
  • Autocomplete Flag Parsing Order

    Autocomplete Flag Parsing Order

    Currently flags do show up like this: image

    However, it might be a good idea to display all --flags first and after them the -f(lags). Another solution would be to show only the long version or both in one line as the description has to be the same and on autocomplete insert the long one as this is the most descriptive. This might need some conditional logic I guess if there are cases with short but no long flags or the other way round.

    opened by cmprmsd 2
  • Hide shorthand flags and sort suggestions

    Hide shorthand flags and sort suggestions

    Hide shorthand flags from the suggestion list, since they are guaranteed to have regular-length equivalents (which can just as easily be completed with ). Sort the flags so that persistent flags (like --help) aren't stuck at the top. Closes #2.

    opened by brianstrauch 0
  • Persistent History

    Persistent History


    I'm trying to get a persistent history working. However, the struggle is real :D Maybe you have an idea and better understanding of cobra.

    The command has the following additional argument

    PreRun:            WriteHistory,

    The following function does write the history line and append it to the file:

    func WriteHistory(cmd *cobra.Command, args []string) {
    	enabledFlags = nil
    	// Open history file
    	f, err := os.OpenFile(".fry_history",
    		os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
    	if err != nil {
    	defer f.Close()
    	// Parse flags
    	cmd.Flags().SortFlags = false
    	// Join flags and arguments
    	cmdLine := cmd.Parent().Use + " " + cmd.Use + " " + strings.Join(enabledFlags, " ") + " " + strings.Join(args, " ")
    	if _, err := f.WriteString(cmdLine + "\n"); err != nil {

    Reading the history does happen at the start of the program execution:

    func init...
    hist := prompt.OptionHistory(readHistory())
    	myShell := shell.New(rootCmd, keyBinds, codeBinds, number, hist)
    func readHistory() []string {
    	data, err := os.ReadFile(".fry_history")
    	if err != nil {
    		log.Println("No history yet. Nothing to parse")
    	history := strings.Split(string(data), "\n")
    	return history

    Build the flag strings (this is super weird and I look for a better solution).

    func checkFlags(f *pflag.Flag) {
    	if f.Value.Type() == "bool" {
    		enabledFlags = append(enabledFlags, "--"+f.Name)
    	} else {
    		enabledFlags = append(enabledFlags, "--"+f.Name+" \""+f.Value.String()+"\"")
    	fmt.Printf("Flags: %v\n", enabledFlags)

    This approach works fine for the first execution of a command. However, the flags do not reset after each command execution. Thus the flags add up when running multiple times in one shell.


    By any chance. Do you have experience how to parse the flags correctly in order to write them to a file?

    opened by cmprmsd 2
  • Fuzzy Suggestions for Autocomplete

    Fuzzy Suggestions for Autocomplete


    I implemented a directory walker that outputs e.g. ps1 files recursively in nested folders.

    Is it possible to do fuzzy searching on this parameter? I saw fuzzy suggestions are implemented in go-prompt ( and

    However, I'm unsure where to set this option and if it is configurable also in cobra-shell. You showed already a nice way to add keybindings. So I thought there may be an easy solution for this as well. :smile:

    opened by cmprmsd 2
Brian Strauch
Brian Strauch
Cobra CLI tool to generate applications and commands

Cobra Generator Cobra provides its own program that will create your application and add any commands you want. It's the easiest way to incorporate Co

Steve Francia 206 Sep 22, 2022
A simple CLI based rock-paper-scissors game created in GO with interactive shell prompt.

rock-paper-scissors A simple CLI (Command Line Interface) based rock-paper-scissors game with interactive shell prompt. Language Download Grab a binar

Saif Shahriar 0 Jul 17, 2022
painless task queue manager for shell commands with an intuitive cli interface (execute shell commands in distributed cloud-native queue manager).

EXEQ DOCS STILL IN PROGRESS. Execute shell commands in queues via cli or http interface. Features Simple intuitive tiny cli app. Modular queue backend

Mohammed Al Ashaal 12 Jan 29, 2022
CLI to run a docker image with R. CLI built using cobra library in go.

BlueBeak Installation Guide Task 1: Building the CLI The directory structure looks like Fastest process: 1)cd into bbtools 2)cd into bbtools/bin 3)I h

Aniruddha Chattopadhyay 0 Dec 20, 2021
Go-file-downloader-ftctl - A file downloader cli built using golang. Makes use of cobra for building the cli and go concurrent feature to download files.

ftctl This is a file downloader cli written in Golang which uses the concurrent feature of go to download files. The cli is built using cobra. How to

Dipto Chakrabarty 2 Jan 2, 2022
An interactive shell for go application

goshell An interactive shell for go application in normal mode ctrl-c break exec

null 1 Aug 4, 2022
ap 是一个 shell 工具,可以让其它 shell 命令的输出能够自动进入交互翻页模式

ap -- auto-pager ap 是一个 shell 工具,可以让其它 shell 命令的输出能够自动进入交互翻页模式。 ap 由两部分组成,一个 Go 语言编写的二进制程序,负责捕获命令的输出并支持翻页, 和一组 shell 脚本,负责为用户指定的命令清单创建与之同名的 wrapper。 经

flw 12 Apr 12, 2022
Simple CLI using spf13/cobra and Flink REST API

Flinkctl Flinkctl is a simple CLI written on Go using Cobra created to facilitate my team's daily basis work with multiple Flink clusters at Azion Tec

Tiago Krebs 3 Aug 16, 2022
Prompts users to enter values for required flags in Cobra CLI applications

Cobra Flag Prompt Cobra Flag Prompt prompts users to enter values for required flags. It is an extension of Cobra, and requires that you use Cobra to

null 1 Nov 13, 2021
A cli client-server app with cobra

cli-client-server-calculator a cli client-server app with cobra overview this project is a cli client-server app in which client gives a bunch of numb

mohammad-hossein zeynal zadeh 5 Dec 7, 2021
Cobra CLI challenge Segsalerty

Banking app done using Cobra CLI - Segsalerty challenge c/o Segun Mustafa It uses a database.json file as datastore for queries - createCustomer, Upda

Oladapo Olawale Sunday 0 Dec 14, 2021
This project is used to get familiar with GoLang cli apps, along with cobra generator.

SecretCTL SecretCTL About the project Status Getting started Layout Notes About the project This project is used to get familiar with GoLang cli apps,

Milos Folic 0 Jan 11, 2022
Run any shell command in a temporary proxy environment.

Run any shell command in a temporary proxy environment.

Wonder 4 Jun 2, 2022
The blackbean is a command tool for elasticsearch operations by using cobra.

The blackbean is a command tool for elasticsearch operations by using cobra. Besides, blackbean is the name of my lovely French bulldog.

null 23 Mar 3, 2022
Reusable golang-migrate library using cobra utility

shift Reusable golang-migrate library using cobra utility Example Usage package main import ( "sql/db" "" "

purwandi 0 Dec 16, 2021
command argument completion generator for spf13/cobra

Command argument completion generator for cobra. You can read more about it here: A pragmatic approach to shell completion.

null 49 Sep 15, 2022
It‘s a cmd-line tool like `make` and `task`, supporting nested args and alias using `cobra`

It‘s a cmd-line tool like `make` and `task`, supporting nested args and alias using `cobra`. It's a makefile alternative and a shell wrapper.

null 2 Apr 14, 2022
Abacus is a simple interactive calculator CLI

Abacus is a simple interactive calculator CLI with support for variables, comparison checks, and math functions abacus -

Viktor Danov 33 Sep 15, 2022