Write.as CLI Manual

NAME: post - Alias for default action: create post from stdin

USAGE: writeas post [command options] [arguments...]

DESCRIPTION: Create a new post on Write.as from stdin.

Use the --code flag to indicate that the post should use syntax highlighting. Or use the --font [value] argument to set the post's appearance, where [value] is mono, monospace (default), wrap (monospace font with word wrapping), serif, or sans.

OPTIONS: -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


NAME: writeas - Publish text quickly

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

VERSION: 2.0

AUTHOR: Write.as hello@write.as

COMMANDS: 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 Write.as 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 Write.as logout Log out of Write.as help, h Shows a list of commands or help for one command

GLOBAL OPTIONS: -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


NAME: new - Compose a new post from the command-line and publish

USAGE: writeas new [command options] [arguments...]

DESCRIPTION: An alternative to piping data to the program.

On Windows, this will use 'copy con' to start reading what you input from the prompt. Press F6 or Ctrl-Z then Enter to end input. On *nix, this will use the best available text editor, starting with the value set to the WRITEAS_EDITOR or EDITOR environment variable, or vim, or finally nano.

Use the --code flag to indicate that the post should use syntax highlighting. Or use the --font [value] argument to set the post's appearance, where [value] is mono, monospace (default), wrap (monospace font with word wrapping), serif, or sans.

If posting fails for any reason, 'writeas' will show you the temporary file location and how to pipe it to 'writeas' to retry.

OPTIONS: -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


NAME: delete - Delete a post

USAGE: writeas delete [command options] [arguments...]

OPTIONS: --tor, -t Delete via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --verbose, -v Make the operation more talkative


NAME: publish - Publish a file to Write.as

USAGE: writeas publish [command options] [arguments...]

OPTIONS: -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


NAME: get - Read a raw post

USAGE: writeas get [command options] [arguments...]

OPTIONS: --tor, -t Get from Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --verbose, -v Make the operation more talkative


NAME: update - Update (overwrite) a post

USAGE: writeas update [command options] [arguments...]

OPTIONS: --tor, -t Update via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --code Specifies this post is code --font value Sets post font to given value --verbose, -v Make the operation more talkative


NAME: posts - List all of your posts

USAGE: writeas posts [command options] [arguments...]

DESCRIPTION: This will list only local posts.

OPTIONS: --id Show list with post IDs (default) --md Use with --url to return URLs with Markdown enabled --tor, -t Get posts via Tor hidden service, if authenticated --url Show list with URLs --verbose, -v Show verbose post listing, including Edit Tokens


NAME: add - Add an existing post locally

USAGE: writeas add [arguments...]

DESCRIPTION: A way to add an existing post to your local store for easy editing later.

This requires a post ID (from https://write.as/[ID]) and an Edit Token (exported from another Write.as client, such as the Android app).


NAME: claim - Claim local unsynced posts

USAGE: writeas claim [command options] [arguments...]

DESCRIPTION: This will claim any unsynced posts local to this machine. To see which posts these are run: writeas posts.

OPTIONS: --tor, -t Authenticate via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --verbose, -v Make the operation more talkative


NAME: blogs - List blogs

USAGE: writeas blogs [command options] [arguments...]

OPTIONS: --tor, -t Authenticate via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --url Show list with URLs


NAME: logout - Log out of Write.as

USAGE: writeas logout [command options] [arguments...]

OPTIONS: --tor, -t Authenticate via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --verbose, -v Make the operation more talkative


NAME: auth - Authenticate with Write.as

USAGE: writeas auth [command options] [arguments...]

OPTIONS: --tor, -t Authenticate via Tor hidden service --tor-port value Use a different port to connect to Tor (default: 9150) --verbose, -v Make the operation more talkative