You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Amjith Ramanujam f3442f40d6
Merge pull request #880 from earboxer/emptypass
20 hours ago
.github Update 3 years ago
mycli Merge branch 'master' into emptypass 21 hours ago
screenshots [ImgBot] optimizes images 1 year ago
test Fix test 6 days ago
.coveragerc Move coverage config back to coveragerc. 3 years ago
.git-blame-ignore-revs Add git-blame-ignore revs in anticipation of hyper-blame. 2 years ago
.gitignore added .vscode to .gitignore 10 months ago
.travis.yml support python 3.8 (#837) 4 months ago
AUTHORS.rst Add AUTHORS.rst and SPONSORS.rst with links to the text files 3 years ago Update contributing guide for test changes. 2 years ago
LICENSE.txt Remove the copyright year. 2 years ago Merge branch 'master' of into tsroten/pin_correct_pep8radius 3 years ago Update 1 month ago
SPONSORS.rst Add AUTHORS.rst and SPONSORS.rst with links to the text files 3 years ago Merge branch 'master' into emptypass 21 hours ago Update to remove unnecessary checks. 3 months ago
requirements-dev.txt Merge branch 'master' into feature/ssh_config 3 months ago
setup.cfg Move pep8radius config to setup.cfg. 3 years ago Merge pull request #870 from laixintao/highlight-null 21 hours ago
tox.ini support python 3.8 (#837) 4 months ago


Build Status PyPI Join the chat at

A command line client for MySQL that can do auto-completion and syntax highlighting.

HomePage: Documentation:

Completion CompletionGif

Postgres Equivalent:

Quick Start

If you already know how to install python packages, then you can install it via pip:

You might need sudo on linux.

$ pip install -U mycli


$ brew update && brew install mycli  # Only on macOS


$ sudo apt-get install mycli # Only on debian or ubuntu


$ mycli --help
Usage: mycli [OPTIONS] [DATABASE]

  A MySQL terminal client with auto-completion and syntax highlighting.

    - mycli my_database
    - mycli -u my_user -h my_database
    - mycli mysql://

  -h, --host TEXT               Host address of the database.
  -P, --port INTEGER            Port number to use for connection. Honors
  -u, --user TEXT               User name to connect to the database.
  -S, --socket TEXT             The socket file to use for connection.
  -p, --password TEXT           Password to connect to the database.
  --pass TEXT                   Password to connect to the database.
  --ssh-user TEXT               User name to connect to ssh server.
  --ssh-host TEXT               Host name to connect to ssh server.
  --ssh-port INTEGER            Port to connect to ssh server.
  --ssh-password TEXT           Password to connect to ssh server.
  --ssh-key-filename TEXT       Private key filename (identify file) for the
                                ssh connection.
  --ssh-config-path TEXT        Path to ssh configuation.
  --ssh-config-host TEXT        Host for ssh server in ssh configuations (requires paramiko).
  --ssl-ca PATH                 CA file in PEM format.
  --ssl-capath TEXT             CA directory.
  --ssl-cert PATH               X509 cert in PEM format.
  --ssl-key PATH                X509 key in PEM format.
  --ssl-cipher TEXT             SSL cipher to use.
  --ssl-verify-server-cert      Verify server's "Common Name" in its cert
                                against hostname used when connecting. This
                                option is disabled by default.
  -V, --version                 Output mycli's version.
  -v, --verbose                 Verbose output.
  -D, --database TEXT           Database to use.
  -d, --dsn TEXT                Use DSN configured into the [alias_dsn]
                                section of myclirc file.
  --list-dsn                    list of DSN configured into the [alias_dsn]
                                section of myclirc file.
  --list-ssh-config             list ssh configurations in the ssh config (requires paramiko).
  -R, --prompt TEXT             Prompt format (Default: "\t \u@\h:\d> ").
  -l, --logfile FILENAME        Log every query and its results to a file.
  --defaults-group-suffix TEXT  Read MySQL config groups with the specified
  --defaults-file PATH          Only read MySQL options from the given file.
  --myclirc PATH                Location of myclirc file.
  --auto-vertical-output        Automatically switch to vertical output mode
                                if the result is wider than the terminal
  -t, --table                   Display batch output in table format.
  --csv                         Display batch output in CSV format.
  --warn / --no-warn            Warn before running a destructive query.
  --local-infile BOOLEAN        Enable/disable LOAD DATA LOCAL INFILE.
  --login-path TEXT             Read this path from the login file.
  -e, --execute TEXT            Execute command and quit.
  --init-command TEXT           SQL statement to execute after connecting.
  --help                        Show this message and exit.


mycli is written using prompt_toolkit.

  • Auto-completion as you type for SQL keywords as well as tables, views and columns in the database.
  • Syntax highlighting using Pygments.
  • Smart-completion (enabled by default) will suggest context-sensitive completion.
    • SELECT * FROM <tab> will only show table names.
    • SELECT * FROM users WHERE <tab> will only show column names.
  • Support for multiline queries.
  • Favorite queries with optional positional parameters. Save a query using \fs alias query and execute it with \f alias whenever you need.
  • Timing of sql statments and table rendering.
  • Config file is automatically created at ~/.myclirc at first launch.
  • Log every query and its results to a file (disabled by default).
  • Pretty prints tabular data (with colors!)
  • Support for SSL connections


If you’re interested in contributing to this project, first of all I would like to extend my heartfelt gratitude. I’ve written a small doc to describe how to get this running in a development setup.

Please feel free to reach out to me if you need help.

My email:

Twitter: @amjithr

Detailed Install Instructions:


Fedora has a package available for mycli, install it using dnf:

$ sudo dnf install mycli

RHEL, Centos

I haven’t built an RPM package for mycli for RHEL or Centos yet. So please use pip to install mycli. You can install pip on your system using:

$ sudo yum install python-pip

Once that is installed, you can install mycli as follows:

$ sudo pip install mycli


Follow the instructions on this blogpost:


  1. Make sure the following Cygwin packages are installed: python3, python3-pip.
  2. Install mycli: pip3 install mycli


This project was funded through kickstarter. My thanks to the backers who supported the project.

A special thanks to Jonathan Slenders for creating Python Prompt Toolkit, which is quite literally the backbone library, that made this app possible. Jonathan has also provided valuable feedback and support during the development of this app.

Click is used for command line option parsing and printing error messages.

Thanks to PyMysql for a pure python adapter to MySQL database.


Mycli is tested on macOS and Linux.

Mycli is not tested on Windows, but the libraries used in this app are Windows-compatible. This means it should work without any modifications. If you’re unable to run it on Windows, please file a bug.

Configuration and Usage

For more information on using and configuring mycli, check out our documentation.

Common topics include: