keybase.io command line client
Go
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api api: fix build Mar 31, 2015
openpgp
LICENSE Initial import. Mar 31, 2014
README.md Add TODO list and clarify upload docs. Mar 31, 2014
keybase.go keybase: fix missing printf argument Mar 31, 2015
keyring.go Signatures work properly now, working on post auth. Apr 3, 2014

README.md

keybase

keybase.io command line client

This is an attempt at rewriting the keybase.io command line client in Go.

Currently supported:

  • logging in
  • look up a user
  • fetch a user's public key

The api/ subpackage contains an interface to the keybase.io API; it will have a better record of supported features during development.

Things you should know about this package:

  • As long as I own this code, you will not be able to upload a private key to Keybase. Sorry, but at this time, I am unwilling to upload a private key to someone else's computer; this is non-negotiable.

Usage

keybase [-u user] [-out file] [-pub file] command [arguments]

The -u flag tells keybase what username to log in as; this is only used for authenticated commands.

Unauthenticated commands

These commands do not require logging in.

  • lookup: lookup takes a list of one or more users, and prints information about them to standard out. It will print out most available information, but it won't print out their public key to declutter standard output.
  • fetch: fetch takes a username and attempts to download the public key for the user. The file is saved in the file specified by -out, or ".pub". If the output file is "-", the key is printed to standard output.

Authenticated commands

These commands require logging in: your username should be specified with "-u", and keybase will read your password from the terminal.

  • testlogin: this command takes no arguments and just attempts to login. This is primarily useful as a test command to ensure logins work.
  • upload: this command uploads the public key specified by the -pub flag to the account; it will replace any existing key there. This public key should be an ASCII-armoured OpenPGP-exported public key.
  • delete: this command removes the user's public key from the account.

TODO

  1. Hook upload into an OpenPGP key ring, and allow the user to specify the key ID to upload by default (while allowing files.)
  2. Figure out the Go OpenPGP package to allow for signatures (i.e. the sig/post_auth endpoint.
  3. Pester the Keybase folks about verifying using this client (and encrypting and so forth).

License

This program is currently not very useful, but it (and the current API implementation) are open sourced under the ISC license. See the LICENSE file in either the project root or in the api package for the full text.