Owostack
CLI Reference

Authentication

How the CLI authenticates with Owostack

CLI Authentication

The Owostack CLI uses a secure, browser-based authentication flow to link your terminal session with your Owostack account.

How it works

  1. Initiate: When you run npx owo connect, the CLI generates a unique session token.
  2. Browser Flow: A browser window opens automatically, asking you to sign in to your Owostack dashboard.
  3. Approval: Once signed in, you'll see a request to authorize the CLI.
  4. Completion: After approval, the CLI receives an authentication token and stores it securely in your local machine's config directory.

Credentials Storage

The CLI stores credentials in:

  • macOS: ~/Library/Application Support/owostack/config.json
  • Linux: ~/.config/owostack/config.json
  • Windows: %AppData%\owostack\config.json

Environment Variables

For CI/CD environments where browser-based auth isn't possible, you can use the OWOSTACK_SECRET_KEY environment variable:

export OWOSTACK_SECRET_KEY=sk_test_...
npx owo sync

On this page