CLI guide
GitHub

Accounts

source-coop account shows and changes accounts: yours, and the organizations you belong to. It also creates organizations. An account's ID is the first part of its products' names and of its page, source.coop/ID.

List and view

# your account, then each organization you're a member of
source-coop account list

# each one's whole record, as JSON
source-coop account list --json

# move through them full screen (see "Browsing with -i")
source-coop account list -i

# one account: its name, websites, email, bio and dates
source-coop account view my-org

# open its page in the browser
source-coop account view my-org -w

list shows one row for each account: its ID, its type (individual or organization) and its name. On a terminal, it shows them in your pager (--no-pager prints directly). When piped, the rows are tab-separated, with no header. A disabled organization is left out, with a note, unless you are one of its owners or maintainers: source.coop doesn't show it to its other members. list and view show only some of an account's fields. --json has all of them, such as its flags.

account list, view, then list --json

Create an organization

# prompts for the ID, name and bio, then asks you to confirm
source-coop account create

# from flags; --website can be repeated
source-coop account create my-org --name "My Org" --bio "Open climate data" --website my-org.example

# from a file or stdin; flags win
echo '{"name": "My Org", "email": "data@my-org.example"}' | source-coop account create my-org -F - --json

You become the organization's owner. You can create organizations only if source.coop has given your account permission. Otherwise the API refuses with exit code 4.

The name defaults to one made from the ID, as on the web: my-org becomes My Org. If the ID is taken, the CLI asks for another. Going back, drafts and the sign-in check work as for products (see Prompts). create prints the organization's page on stdout, so url=$(source-coop account create …) works.

People get their accounts when they sign up on the website. To create an account for software, use service-account create.

account create: prompts, going back, a review, then a taken ID

Edit

# the edit form: name, bio and location
source-coop account edit my-org

# select the account first
source-coop account edit -i

# from flags; an empty string clears a field
source-coop account edit my-org --bio "Open climate data" --location ""
source-coop account edit my-org --website my-org.example --website docs.my-org.example   # replaces the websites
source-coop account edit my-org --email data@my-org.example --ror-id 05abc1234
source-coop account edit my-ada --orcid 0000-0002-1825-0097

# turn an organization off, or back on
source-coop account edit my-org --disable
source-coop account edit my-org --enable

You can edit your own account and the organizations you own or maintain. Only owners can disable or enable an organization. A disabled account can't sign in, and nothing new can be attached to it.

There is no account delete: source.coop never deletes people or organizations. Use --disable.

account edit: the edit form, then flags