Histweet

histweet is a simple CLI tool that automatically manages your Twitter timeline.

By default, due to limits in the Twitter API, histweet can only process that latest 3,200 tweets in your timeline. However, if you point histweet to an optional Twitter archive, the tool can process tweets based on your entire history.

Prerequisites

Before you can use histweet, you must first obtain a Twitter API key and access token. To do this, signup for a Twitter Developer account here.

Once you have your keys, you can either pass them in as CLI flags or define the following environment variables:

$ export HISTWEET_ACCESS_TOKEN=[YOUR_KEY]
$ export HISTWEET_ACCESS_SECRET=[YOUR_KEY]
$ export HISTWEET_CONSUMER_KEY=[YOUR_KEY]
$ export HISTWEET_CONSUMER_SECRET=[YOUR_KEY]

Quickstart

histweet comes with two basic modes: count mode and rules mode.

Count Mode

In count mode, histweet just keeps the latest N tweets. For example, we can keep the latest 300 tweets and delete everything else like so (--daemon keeps histweet running in the background).

histweet count -n 300 --daemon

Rule Mode

Rule mode is the more powerful and... practical mode. In this mode, you can specify one or more rules. histweet will delete all tweets that match the provided rule(s).

In this example, we delete all tweets that are:

1. Older than 3 months and 5 days, and;
2. Have fewer than 3 likes, and;
3. Contain the word "dt" (as a regex pattern)

histweet rule 'age > 3m5d && likes < 3 && text ~ "dt"'

To point histweet at your archive JSON, pass in the --archive flag like so:

histweet rule --archive /path/to/tweet.js 'age > 3m5d && likes < 3 && text ~ "dt"'

The tool will now run the same rules against the contents of your archive, and then use the Twitter API to delete all matching tweets.

You can view full usage by passing in the -h flag.

Build

cd cli && go build -o histweet

Test

cd lib && go test

Benches

cd lib

# Run benchmarks & dump files for CPU and mem
go test -bench=. -benchmem -memprofile=mem.out -cpuprofile=cpu.out

# Optional: analyze each file in browser using pprof
go tool pprof -http :8080 cpu.out
go tool pprof -http :8081 mem.out