Skip to main content

Use Twitter from your terminal!

Project description


Ever wanted to tweet straight from your terminal? Wait, is it just me?

How to install it?

Install Clitt using pip or pipx

    pip install --user clitt \\ pipx install clitt

How to use it?

Clitt is meant to be simple (or at least as simple as a command line client for Twitter can be), so you just need to call clitt or tt, choose an action and pass the required parameters to perform the action.

Running clitt or tt for the first time will open a new tab on your browser with an authorization consent from Twitter, hit the authorize button, copy the code that will pop-up and paste it into the terminal. After the first time, your authorization token will be saved on your computer (and only there) for further uses.

What can i do with Clitt?

Read your timeline

$ clitt read

Clitt read

Write a Tweet

$ clitt post "Hey, i'm using Clitt to write this!"

DM someone

$ clitt dm @target "Hey, i'm using Clitt to send you this DM!"

Read your chat with another user

$ clitt chat @target

Future features

  • Search for tweets using keywords
  • Display and attach images to tweets
  • Implement filters and other customization options
  • Support theme colors


Have you thought about any cool features you wanted to see in Clitt? Send a PR. Found any bugs in the current implementation? Feel free to open an issue. Here's a guide to some things you might need to work on Clitt.

Twitter dev account

You will need to make an application for a Twitter developer account if you want to publish your own version of Clitt, but for testing and development within this project you can use my key that is already included with this repository. If you have you own key, put it on the config/keys.json file inside the package.


Tweepy is a Python wrapper for the Twitter REST API, it really makes life much more easier, you can check their docs and probably will find what you looking for, but if you don't, search in the Twitter docs.

Clitt project structure

If you want to implement a new feature, write it in the file and if you need to, add a new argument treatment in Write simple and multiplatform code.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for clitt, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size clitt-1.2.1-py3-none-any.whl (7.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size clitt-1.2.1.tar.gz (6.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page