Berget CLI

A command-line tool for interacting with Berget AI.

Installation

npm install -g berget
# or use directly with npx
npx berget --help

Authentication

Before you can use the CLI, you need to authenticate:

# Login with OAuth
npx berget auth login

# Create an API key
npx berget api-keys create --name "My CLI Key"

# Or use environment variable
export BERGET_API_KEY=sk_ber_your_api_key_here

Chat Command

Basic Usage

# Interactive chat session
npx berget chat run

# Use specific model
npx berget chat run openai/gpt-oss

# Send direct message
npx berget chat run openai/gpt-oss "Explain what Docker is"

# Use pipe for input
echo "What is Kubernetes?" | npx berget chat run openai/gpt-oss

Environment Variables

# API key (recommended)
export BERGET_API_KEY=sk_ber_your_api_key_here

# Debug mode
export LOG_LEVEL=debug

# Custom API base URL (if using your own instance)
export API_BASE_URL=https://your-custom-api.example.com

Command Reference

For a complete list of commands, run:

npx berget --help

Troubleshooting

# Enable debug mode
npx berget --debug chat run openai/gpt-oss "test"

# Check authentication
npx berget auth whoami

# List available models
npx berget chat list

# Check API key status
npx berget api-keys list

Contributing

See CONTRIBUTING.md for development instructions.