ReadLine 2.0.0

.NET Standard 2.0
There is a newer version of this package available.
See the version list below for details.
dotnet add package ReadLine --version 2.0.0
NuGet\Install-Package ReadLine -Version 2.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ReadLine" Version="2.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ReadLine --version 2.0.0
#r "nuget: ReadLine, 2.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install ReadLine as a Cake Addin
#addin nuget:?package=ReadLine&version=2.0.0

// Install ReadLine as a Cake Tool
#tool nuget:?package=ReadLine&version=2.0.0

Windows build status License: MIT NuGet version


ReadLine is a GNU Readline like library built in pure C#. It can serve as a drop in replacement for the inbuilt Console.ReadLine() and brings along with it some of the terminal goodness you get from unix shells, like command history navigation and tab auto completion.

It is cross platform and runs anywhere .NET is supported, targeting netstandard1.3 means that it can be used with .NET Core as well as the full .NET Framework.

Shortcut Guide

Shortcut Comment
Ctrl+A / HOME Beginning of line
Ctrl+B / Backward one character
Ctrl+C Send EOF
Ctrl+E / END End of line
Ctrl+F / Forward one character
Ctrl+H / Backspace Delete previous character
Tab Command line completion
Shift+Tab Backwards command line completion
Ctrl+J / Enter Line feed
Ctrl+K Cut text to the end of line
Ctrl+L / Esc Clear line
Ctrl+M Same as Enter key
Ctrl+N / Forward in history
Ctrl+P / Backward in history
Ctrl+U Cut text to the start of line
Ctrl+W Cut previous word
Backspace Delete previous character
Delete Delete succeeding character


Available on NuGet

Visual Studio:

PM> Install-Package ReadLine

.NET Core CLI:

dotnet add package ReadLine


Read input from the console

string input = ReadLine.Read("(prompt)> ");

Read password from the console

string password = ReadLine.ReadPassword("(prompt)> ");

Note: The (prompt>) is optional

History management

// Get command history

// Add command to history
ReadLine.AddHistory("dotnet run");

// Clear history

// Disable history
ReadLine.HistoryEnabled = false;

Note: History information is persisted for an entire application session. Also, calls to ReadLine.Read() automatically adds the console input to history


class AutoCompletionHandler : IAutoCompleteHandler
    // characters to start completion from
    public char[] Separators { get; set; } = new char[] { ' ', '.', '/' };

    // text - The current text entered in the console
    // index - The index of the terminal cursor within {text}
    public string[] GetSuggestions(string text, int index)
        if (text.StartsWith("git "))
            return new string[] { "init", "clone", "pull", "push" };
            return null;

ReadLine.AutoCompletionHandler = new AutoCompletionHandler();

Note: If no "AutoCompletionHandler" is set, tab autocompletion will be disabled


Contributions are highly welcome. If you have found a bug or if you have a feature request, please report them at this repository issues section.

Things you can help with:

  • Achieve better command parity with GNU Readline.
  • Add more test cases.


This project is licensed under the MIT license. See the LICENSE file for more info.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (11)

Showing the top 5 NuGet packages that depend on ReadLine:

Package Downloads

A cross platform library allowing you to run C# (CSX) scripts with support for debugging and inline NuGet packages. Based on Roslyn.

OpenMod.Core The ID prefix of this package has been reserved for one of the owners of this package by

Core service implementations for OpenMod


MinecraftBE Server


CLI Commandlet host and execution engine


Froda Console

GitHub repositories (6)

Showing the top 5 popular GitHub repositories that depend on ReadLine:

Repository Stars
Run C# scripts from the .NET CLI.
The Comprehensive Kerbal Archive Network
Our flagship Ethereum client for Linux, Windows, and macOS—full and actively developed.
ExchangeSharp is a powerful, fast and easy to use .NET/C# API for interfacing with many crypto currency exchanges. REST and web sockets are supported.
Version Downloads Last updated
2.0.1 922,250 6/12/2018
2.0.0 34,502 1/10/2018
1.2.0 5,959 5/22/2017
1.1.1 993 3/26/2017
1.1.0 864 3/4/2017
1.0.0 1,072 2/10/2017