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
- Initiate: When you run
npx owo connect, the CLI generates a unique session token. - Browser Flow: A browser window opens automatically, asking you to sign in to your Owostack dashboard.
- Approval: Once signed in, you'll see a request to authorize the CLI.
- 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