Command line interface for [Write.as](https://write.as) and [Write.as on Tor](http://writeas7pm7rcdqg.onion/). Works on Windows, OS X, and Linux.
Like the [Android app](https://play.google.com/store/apps/details?id=com.abunchtell.writeas), the command line client keeps track of the posts you make, so future editing / deleting is easier than [doing it with cURL](http://cmd.write.as/). The goal is for this to serve as the backend for any future GUI app we build for the desktop.
It is currently **alpha**, so a) functionality is basic and b) everything is subject to change — i.e., watch the [changelog](https://write.as/changelog-cli.html).
post Alias for default action: create post from stdin
new Compose a new post from the command-line and publish
delete Delete a post
update Update (overwrite) a post
get Read a raw post
add Add an existing post locally
list List local posts
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--tor, -t Perform action on Tor hidden service
--tor-port "9150" Use a different port to connect to Tor
--help, -h show help
--version, -v print the version
```
### Examples
These are a few common uses for `writeas`. If you get stuck or want to know more, run `writeas [command] --help`. If you still have questions, [ask us](https://write.as/contact).
#### Share something
Without any flags, `writeas` creates a post with a `monospace` typeface that doesn't word wrap (scrolls horizontally):
```bash
$ echo "Hello world!" | writeas
Posting...
Copied to clipboard.
https://write.as/aaaaaaaaaaaa
```
This is generally more useful for posting terminal output or code, like so (the `--code` flag turns on syntax highlighting):
OS X / *nix: `cat writeas/cli.go | writeas --code`
+This outputs any Write.as post with the given ID.
+
+```bash
+$ writeas get aaaaaaaaaaaa
+Getting...
+Hello world!
+```
+
+#### List all published posts
+
+This lists all posts you've published from your device. Pass the `--url` flag to show the list with full URLs.
+
+```bash
+$ writeas list
+aaaaaaaaaaaa
+```
+
+#### Delete a post
+
+This permanently deletes a post you own.
+
+```bash
+$ writeas delete aaaaaaaaaaaa
+Deleting...
+Post deleted.
+```
+
+#### Update a post
+
+This completely overwrites an existing post you own.
+
+```bash
+$ echo "See you later!" | writeas update aaaaaaaaaaaa
+Updating...
+Post updated.
+```
+
+### Composing posts
If you simply have a penchant for never leaving your keyboard, `writeas` is great for composing new posts from the command-line. Just use the `new` subcommand.
`writeas new` will open your favorite command-line editor, as specified by your `WRITEAS_EDITOR` or `EDITOR` environment variables (in that order), falling back to `vim` on OS X / *nix.
Customize your post's appearance with the `--font` flag:
| Argument | Appearance (Typeface) | Word Wrap? |
| -------- | --------------------- | ---------- |
| `sans` | Sans-serif (Open Sans) | Yes |
| `serif` | Serif (Lora) | Yes |
| `wrap` | Monospace | Yes |
| `mono` | Monospace | No |
| `code` | Syntax-highlighted monospace | No |
Put it all together, e.g. publish with a sans-serif font: `writeas new --font sans`