source-coop CLI

The command line for Source Cooperative. Use it to:

• Get data credentials. Sign in through your browser once. AWS tools then get temporary S3 credentials for the Source Cooperative data proxy, and the CLI renews them when they expire.
• Manage source.coop. List, view, create, edit and delete products, members and service accounts, and create and edit organizations. The source.coop API applies the same rules as the web UI.

All commands work the same way:

• At a terminal, a command asks for the values that you do not give.
• -i shows records full screen, for you to move through.
• --json and the exit codes are stable, for scripts and AI agents.

This guide is also a website, with a page for each section and docs for each release, plus next for what's on main and not yet released: https://cli.source.coop/.

The demos in this guide use a stand-in for the API with made-up records (demo-org, demo-user), and a made-up session where they show you signed in. They show production's addresses (source.coop, data.source.coop), but demo-org and demo-user don't exist there.

Quick start

# sign in through your browser, once
source-coop auth login

# an account's products
source-coop product list my-org

# asks for each value a new product needs
source-coop product create

# after you add the AWS profile (below)
aws s3 ls s3://my-org/my-data --profile source-coop

source-coop --help lists the commands. source-coop <command> --help lists the flags of a command, with examples.

Contents

• Get started: Install, Signing in
• Work with data: Reading data with AWS tools, Uploading data with AWS tools
• Manage source.coop: Accounts, Products, Members, Invitations, Service accounts
• How commands work: Prompts, Browsing with -i, Shell completion
• Automate: Scripts and AI agents, Any API request
• Reference: Configuration, Credential storage, Troubleshooting