Command line client for
Matt Baer f1947e48e2
Merge pull request #40 from writeas/revert-post-list
5 days ago
.github CONTRIBUTING: Add import group conventions 6 months ago
api move to version two of go-writeas 2 weeks ago
cmd/writeas revert posts listing style to v1.2 1 week ago
commands Keep new post listing style under -v flag 5 days ago
config Bump version to 2.0 2 weeks ago
debian Bump version to 1.2 8 months ago
fileutils Fix Exists() test in fileutils 9 months ago
log Closes T592 T593 T597 splits code into packages 3 weeks ago
.gitignore :rocket: 4 years ago
.travis.yml :rocket: 4 years ago Add release date to v1.0 1 year ago Keep new post listing style under -v flag 5 days ago
LICENSE Relicense under GPL 6 months ago Link to desktop app in README 1 week ago
go.mod move to version two of go-writeas 2 weeks ago
go.sum move to version two of go-writeas 2 weeks ago


GPL Go Report Card Discuss on our forum

Command line interface for Works on Windows, macOS, and Linux.

NOTE: the master branch is currently unstable while we prepare the v2.0 release! You should install via official release channel, or build from the v1.2 tag.


  • Publish anonymously to
  • Authenticate with a account
  • A stable, easy back-end for your GUI app or desktop-based workflow
  • Compatible with our Tor hidden service
  • Locally keeps track of any posts you make
  • Update and delete posts, anonymous and authenticated
  • Fetch any post by ID
  • Add anonymous post credentials (like for one published with the Android app) for editing


The easiest way to get the CLI is to download a pre-built executable for your OS.


Latest release Total downloads

Get the latest version for your operating system as a standalone executable.

Download the 64-bit or 32-bit executable and put it somewhere in your %PATH%.

Download the 64-bit executable and put it somewhere in your $PATH, like /usr/local/bin.

Debian-based Linux

sudo apt-key adv --keyserver --recv-keys DBE07445
sudo add-apt-repository "deb xenial main"
sudo apt-get update && sudo apt-get install writeas-cli

Linux (other)
Download the 64-bit or 32-bit executable and put it somewhere in your $PATH, like /usr/local/bin.

Go get it

go get

Once this finishes, you'll see writeas or writeas.exe inside $GOPATH/bin/.


To upgrade the CLI, download and replace the executable you downloaded before.

If you previously installed with go get, run it again with the -u option.

go get -u


See full usage documentation on our User Guide.

   writeas [global options] command [command options] [arguments...]

     post     Alias for default action: create post from stdin
     new      Compose a new post from the command-line and publish
     publish  Publish a file to
     delete   Delete a post
     update   Update (overwrite) a post
     get      Read a raw post
     add      Add an existing post locally
     posts    List all of your posts
     blogs    List blogs
     claim    Claim local unsynced posts
     auth     Authenticate with
     logout   Log out of
     help, h  Shows a list of commands or help for one command

   -c value, -b value  Optional blog to post to
   --tor, -t           Perform action on Tor hidden service
   --tor-port value    Use a different port to connect to Tor (default: 9150)
   --code              Specifies this post is code
   --md                Returns post URL with Markdown enabled
   --verbose, -v       Make the operation more talkative
   --font value        Sets post font to given value (default: "mono")
   --lang value        Sets post language to given ISO 639-1 language code
   --user-agent value  Sets the User-Agent for API requests
   --help, -h          show help
   --version, -V       print the version

Contributing to the CLI

For a complete guide to contributing, see the Contribution Guide.

We welcome any kind of contributions including documentation, organizational improvements, tutorials, bug reports, feature requests, new features, answering questions, etc.

Getting Support

We're available on several channels, and prefer our forum for project discussion. Please don't use the GitHub issue tracker to ask questions.

Reporting Issues

If you believe you have found a bug in the CLI or its documentation, file an issue on this repo. If you're not sure if it's a bug or not, reach out to us in one way or another. Be sure to provide the version of the CLI (with writeas --version) in your report.