Command line client for
Matt Baer f82016a3b2 Merge branch 'develop' 3 weeks ago
.github CONTRIBUTING: Add import group conventions 10 months ago
api get tokens for update and delete 1 month ago
cmd Fix wf-cli download links 3 weeks ago
commands wf/post list: draft posts not anonymous 1 month ago
config remove default collection of username 3 weeks ago
debian Bump version to 1.2 1 year ago
executable Show correct executable name in user messages 2 months ago
fileutils Clean up directories on `wf logout` 2 months ago
log log.Info will respect global flags 2 months ago
.gitignore :rocket: 4 years ago
.travis.yml :rocket: 4 years ago Add release date to v1.0 1 year ago Split up READMEs and GUIDEs 3 weeks ago
LICENSE Relicense under GPL 10 months ago Fix README links 3 weeks ago
go.mod add accounts command in wf 3 weeks ago
go.sum add accounts command in wf 3 weeks ago

writeas-cli / wf-cli

GPL Go Report Card Discuss on our forum

Command line utility for publishing to and any other WriteFreely instance. Works on Windows, macOS, and Linux.


  • Authenticate with a / WriteFreely account
  • Publish anonymous posts or drafts to or WriteFreely, respectively
  • A stable, easy back-end for your GUI app or desktop-based workflow
  • Compatible with the Tor hidden service
  • Update and delete posts
  • Fetch any post by ID
  • ...and more, depending on which client you're using (see respective READMEs for more)


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. CLI
See the writeas-cli README

WriteFreely CLI
See the wf-cli README

Usage CLI
See full usage documentation on our writeas-cli User Guide.

WriteFreely CLI
See full usage documentation on our wf-cli User Guide.

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 or wf --version) in your report.