Your account

Your account key

Your account is a key that woodls init --invite CODE made on your computer. It signs everything your account does, and it holds your credits. There’s no password, and no email or phone number tied to it, so nobody at woodls can reset it or give it back.

• On a Mac, it’s in the macOS Keychain.
• On Linux, it’s in ~/.woodls, in a file only you can read.
• On Windows, it’s inside Ubuntu, in ~/.woodls.

woodls whoami shows your account, by the first characters of its id, and your balances.

Keep a recovery file

woodls account recovery

Writes your key to a file, locked with a passphrase you choose: woodls-recovery-ACCOUNT.json in the folder you’re in, or where --out FILE says. Then:

1. Copy the file somewhere other than this computer: a USB drive, another computer, or a place you keep important files.
2. Keep the passphrase apart from the file. Anyone with both can use your account.
3. To take your account back on any computer: woodls account recover FILE, and type the passphrase.

woodls doctor reminds you until a recovery file has been written.

On Windows

Your key lives inside Ubuntu, so removing Ubuntu (wsl --unregister), resetting Windows, or moving to a new PC deletes it. Write the recovery file to Windows’ side, where your other files are:

woodls account recovery \
  --out /mnt/c/Users/NAME/woodls-recovery.json

with your Windows user’s folder for NAME, then copy it off the PC as above. woodls account recover takes a Windows path too, such as E:\woodls-recovery.json.

A second computer

On the computer that holds your account:

woodls account add-computer --label laptop

It shows a command with a number and two words, such as woodls init --device "47 river lantern": run it on the new computer. The new computer takes a key of its own and proves it has it, and only then may it spend for your account, within its daily limit: 20 credits a day for 30 days unless you give --daily and --days.

woodls account devices

The computers that may spend for you, with their limits

woodls account revoke laptop

Stop one spending, by its label

woodls account authorize KEY --daily 50

Change a device’s daily limit

For scripts, woodls init --device-of ACCOUNT on the new computer prints its key, and this on yours lets it spend:

woodls account authorize KEY --label laptop

A device spends for your account but doesn’t lend for it. To lend from a second computer for the same account, that computer needs the account’s own key: sign the device out there, then take the account back with your recovery file.

Signing in on woodls.com

woodls web

Opens woodls.com signed in, for 12 hours: your credits, your lending computers and what each earned, your devices and your latest entries. woodls web --qr shows the link as a QR code for a phone. The session can’t spend credits or change anything. Sign in has more.

Signing out of a computer

woodls account sign-out

Forgets the account’s key and settings on this computer, and stops lending here. Your groups, history and receipts stay. For the account’s own key, it asks for a recovery file first, so the account isn’t lost; on a device, the account’s computer then revokes it. To come back: woodls account recover FILE, or a new code from woodls account add-computer.

A lost or stolen computer

• A device: on the computer that holds your account, woodls account revoke with its label. Until then it can spend only within its daily limit.
• The computer that holds your account, with a recovery file: install woodls on another computer and run woodls account recover FILE. Then revoke any devices you no longer have.
• Without a recovery file: the account and its credits can’t be recovered, by you or by woodls.
• If someone else may be using your key: write to hello@woodls.com from the address your invite came to. woodls’ server can stop an account from spending and lending. An account can’t be moved to a new key yet.

Leaving woodls

woodls account delete

Closes your account: woodls’ server forgets your country and reserves nothing more for you, its computers stop lending, and this computer forgets your key. Credits left in it can’t be spent again. It asks you to type the account’s first 8 characters first.

Then, to take woodls off this computer:

woodls forget

Delete your history and the key that sealed it

woodls uninstall

Take woodls’ programs away

rm -rf ~/.woodls

Remove everything else woodls kept

On a Mac, this removes every woodls item from the Keychain:

while security delete-generic-password \
  -s woodls >/dev/null 2>&1; do :; done

To see, correct or delete what woodls’ server holds about you, write to hello@woodls.com; the privacy page lists what’s kept and for how long.