A blazing-fast, simple and easy to use command-line client for Twitter written in Go. πŸš€πŸ“¨
Clone or download
Latest commit b3686c0 Dec 31, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue templates Dec 30, 2018
.img Initialize Dec 28, 2018
cmd Initialize Dec 28, 2018
docs Initialize Dec 28, 2018
pkg Fix invalid regex for checking twitter handles Dec 30, 2018
scripts Initialize Dec 28, 2018
.drone.yml Initialize Dec 28, 2018
.gitignore Initialize Dec 28, 2018
CONTRIBUTING.md Initialize Dec 28, 2018
LICENSE Initialize Dec 28, 2018
Makefile Initialize Dec 28, 2018
README.md Fix index Dec 28, 2018
VERSION Initialize Dec 28, 2018
go.mod Initialize Dec 28, 2018
go.sum Initialize Dec 28, 2018
main.go Initialize Dec 28, 2018



go-t logo

GoDoc Build Status Go Report Card

A blazing-fast, simple and easy to use command-line client for Twitter written in Go. πŸš€πŸ“¨


  1. Demo
  2. Features
  3. Installation
  4. Configuration
  5. Usage Examples
  6. Credit & License
  7. Contributing
  8. Acknowledgements


go-t demo

Features & Roadmap

Please have a look at docs/features.md for an extensive list of all features along with several usage examples.

Feature Status Description
Multi-account support βœ” [beta] Manage multiple twitter accounts
Tweets βœ” [beta] Post, (un)retweet tweets, list retweets from command line or stdin
Favorites βœ” [beta] (Dis)like tweets from the command line or stdin
Friendships βœ” [beta] (Un)follow users, show friendship satus from command line or stdin from the command line or stdin
Timelines βœ” [beta] List tweets of your personal-, mentions- and retweets- timeline
Users βœ” [beta] Retrieve user information, Mute users, search users from command line or stdin
Followers βœ” [alpha] List friends, groupies and leaders
Ouput formats βœ” [alpha] Support different output formats for commands such as JSON, YAML, lists or CSV
Sorting βœ” [alpha] Support sorting for output
Trends 🚧 [planned] Retrieve trend information from different countries
Searching βœ” [alpha] Search for specifific tweet content , hashtags, links, ... keywords via regex
Direct Messages 🚧 [planned] List, send and delete direct messages from command line or stdin
List support 🚧 [planned] Create/Delete from command line or stdin
Auto-Completion 🚧 [planned] Auto-completion different shells like bash, zsh, fish, ...
  • 🚧 [planned] = Feature is planned, a concept is still being worked on or not yet started.
  • βœ” [alpha] = Commands / Flags / Arguments can change incompatibly with a new release.
  • βœ” [beta] = Commands / Flags / Arguments are considered to be mostly stable and backwards compatible to an earlier released version.
  • βœ” [stable] = Commands / Flags / Arguments are stable and will not change with a new release.


In case you have Go 1.11+ installed:

go get github.com/cbrgm/go-t

You can also download precompiled binaries. See Releases.


Create a configuration directory with a default configuration for go-t.

t init

The configuration file can be found at ~/.trc/config.json.

go-t communicates with the Twitter API v1.1 to retrieve information. You will need to create an account on the Twitter developer website and credentials to use the Twitter API. Twitters API requires OAuth for all of its functionality, so you'll need a registered Twitter application.

Creating a developer account is quickly done.

  1. Go to https://dev.twitter.com/user/login and log in with your Twitter username and password. If you don't have a Twitter account yet, click on the Sign up link below the Username field.

  2. Go to the Twitter application page at https://dev.twitter.com/apps and click Create a new application. Follow the instructions on the screen. Enter an application name, description and website.

  3. Click the Key and Access Tokens tab to collect the credentials for your Twitter developer account. Click Create my access token at the bottom of the page. The following values are needed to add your Twitter account to go-t:

  • Consumer Key
  • Consumer Secret
  • Access Key
  • Access Secret

With the following command you add an account with the alias foo to be used by go-t (Important: foo is not your Twitter account name, but just an alias used by go-t to identify your credentials).

Follow the setup instructions and add your account:

t accounts add foo

Usage Examples

Here you will find some examples as an introduction how to use go-t. You can find more examples at docs/examples .

Do you have any other examples of using go-t? Please share them with others! See the Contributing Guide.

Send a tweet

t status update "First tweet with go-`t`! Whoop!"

Send a tweet from stdin

echo "First tweet with go-`t` from stdin! Whoop!" | t status update -f -

Send a tweet and like it after beeing published

echo "Instant like!" | t status update -v -l -y -f - | awk '{print $1}' | t fav like -y -f -

Delete a tweet

t status rm <tweet id>

Retweet a tweet

t status retweet <tweet id>

Show all retweets of a tweet

t status retweets <tweet id>

like a tweet

t favorites like <tweet id>

dislike a tweet

t favorites dislike <tweet id>

follow users

t friendships follow @foo

Show all likes of user foo as a list

t favorites list @foo

Like the last 4 tweets liked by user foo

 t favorites list @foo -l -c 4 | awk '{print $1}' | xargs -I tweet t favorites like -y tweet

Show your latest timeline

t timeline

Show your latest timeline as list, sorted by favorites count, descending

t timeline -l --sort likes,asc

Show your latest mentions

t timeline mentions

Favorite the last 10 tweets that mention you

t timeline mentions -c 10 -l | awk '{print $1}' | xargs -I tweet t fav like tweet

Show latest retweets

t timeline retweets

Show the 50 latest tweets of user foo's timeline as list

t timeline user @foo -l -c 50

Search for term foo in your timeline

t timeline -l | grep @foo

Get detailed user information

t users whois foo

Search for users with name golang and output json

t users search "golang" -o json

list all followers of user foo

t followers @foo

list all followers of user foo as list, sorted by follower's recent tweet activity

t followers @foo -l --sort tweeted

Unfollow the last 10 persons you are following, who tweeted less then all your other followers

t followers @foo -l --sort tweeted | awk '{print $1}' | xargs -I user t users unfollow user -y

list all followers of user foo as list, sorted by follower's registration date

t followers @foo -l --sort tweeted

Credit & License

go-t is open-source and is developed under the terms of the Apache 2.0 License.

Maintainer of this repository is:

Please refer to the git commit log for a complete list of contributors.


See the Contributing Guide.


go-t was initially started by Christian Bargmann.

This project is inspired by sferik/t, a command-line power tool for Twitter. go-t uses the dghubble/go-twitter library to communicate with the Twitter API. Many thanks to both projects, you are doing a great job!