berget 1.3.0 → 1.4.0

package/.github/workflows/publish.yml

@@ -0,0 +1,56 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches:
+      - main
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test:run
+
+      - name: Build project
+        run: npm run build
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' || github.event_name == 'release'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Publish to NPM
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test:run
+
+      - name: Build project
+        run: npm run build
+
+      - name: Check TypeScript
+        run: npx tsc --noEmit

package/README.md

@@ -1,33 +1,193 @@
 # Berget CLI
 
-A command-line interface for interacting with the Berget AI infrastructure.
+A command-line tool for interacting with Berget AI's infrastructure and AI models.
 
 ## Installation
 
 ```bash
 npm install -g berget
+# or use directly with npx
+npx berget --help
 ```
 
 ## Authentication
 
-The CLI uses OAuth-based authentication with automatic token refresh.
+Before you can use the CLI, you need to authenticate:
 
-### Login
+```bash
+# 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
+
+```bash
+# 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
+```
+
+### Practical Use Cases
+
+#### 1. Git Commit Messages
 
 ```bash
-berget auth login
+# Generate commit message from git diff
+git diff | npx berget chat run openai/gpt-oss "Create a conventional commit message for this diff. Reply with only the message:"
+
+# Use as alias
+alias gitcommit='git diff | npx berget chat run openai/gpt-oss "Generate a conventional commit message for this diff. Reply with only the commit message, nothing else:"'
 ```
 
-This will open a browser window to authenticate with Berget. After successful authentication, your access token and refresh token will be stored securely in `~/.berget/auth.json`.
+#### 2. Code Review and Explanations
 
-### Token Refresh
+```bash
+# Explain code
+cat src/main.js | npx berget chat run openai/gpt-oss "Explain what this code does:"
 
-The CLI automatically handles token refresh when:
+# Find bugs
+cat problematic-file.py | npx berget chat run openai/gpt-oss "Analyze this code and find potential bugs:"
 
-1. The access token is about to expire (within 10 minutes of expiration)
-2. A request returns a 401 Unauthorized error
+# Improvement suggestions
+git diff | npx berget chat run openai/gpt-oss "Give suggestions for improvements to this code change:"
+```
 
-The refresh mechanism uses the stored refresh token to obtain a new access token without requiring you to log in again. If the refresh token itself is expired or invalid, you'll be prompted to log in again.
+#### 3. Documentation
+
+```bash
+# Generate README
+ls -la | npx berget chat run openai/gpt-oss "Create a README.md for this project based on the file structure:"
+
+# Comment code
+cat uncommented-code.js | npx berget chat run openai/gpt-oss "Add JSDoc comments to this code:"
+```
+
+#### 4. System Administration
+
+```bash
+# Analyze logs
+tail -n 100 /var/log/nginx/error.log | npx berget chat run openai/gpt-oss "Analyze these error logs and suggest solutions:"
+
+# Explain commands
+npx berget chat run openai/gpt-oss "Explain what this bash command does: find . -name '*.js' -exec grep -l 'TODO' {} \;"
+```
+
+## Useful Bash/Zsh Aliases
+
+Add these to your `~/.bashrc`, `~/.zshrc` or similar:
+
+```bash
+# Git-related aliases
+alias gai='git diff | npx berget chat run openai/gpt-oss "Generate a conventional commit message for this diff. Reply with only the commit message, nothing else:"'
+alias gexplain='git log --oneline -10 | npx berget chat run openai/gpt-oss "Explain what these commits do:"'
+alias gsec='~/bin/security-check'
+
+# Code-related aliases
+alias explain='npx berget chat run openai/gpt-oss "Explain this code:"'
+alias review='npx berget chat run openai/gpt-oss "Review this code and give improvement suggestions:"'
+alias debug='npx berget chat run openai/gpt-oss "Find and explain potential bugs in this code:"'
+
+# Documentation aliases
+alias docgen='npx berget chat run openai/gpt-oss "Generate documentation for this code:"'
+alias readme='ls -la | npx berget chat run openai/gpt-oss "Create a README.md for this project:"'
+
+# System aliases
+alias loganalyze='npx berget chat run openai/gpt-oss "Analyze these logs and suggest solutions:"'
+alias cmdexplain='npx berget chat run openai/gpt-oss "Explain this command:"'
+
+# Quick AI assistant
+alias ai='npx berget chat run openai/gpt-oss'
+alias ask='npx berget chat run openai/gpt-oss'
+```
+
+## Advanced Examples
+
+See the `examples/` folder for complete scripts:
+
+- **smart-commit.sh** - Automatic generation of conventional commit messages
+- **ai-review.sh** - AI-driven code review
+- **security-check.sh** - Security review of commits
+
+```bash
+# Copy example scripts
+cp examples/*.sh ~/bin/
+chmod +x ~/bin/*.sh
+
+# Use them
+~/bin/smart-commit.sh
+~/bin/ai-review.sh src/main.js
+~/bin/security-check.sh
+```
+
+## Environment Variables
+
+```bash
+# 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
+```
+
+## Tips and Tricks
+
+1. **Use pipes**: Combine with other Unix tools for powerful workflows
+2. **Short prompts**: Be specific but concise in your prompts for best results
+3. **Streaming**: Streaming is enabled by default for faster responses
+4. **Model selection**: Experiment with different models for different tasks
+5. **Aliases**: Create aliases for common use cases to save time
+
+## Command Reference
+
+- `auth login` - Login to Berget
+- `auth logout` - Logout from Berget
+- `auth whoami` - Show current user information
+- `api-keys list` - List API keys
+- `api-keys create` - Create a new API key
+- `models list` - List available AI models
+- `chat run` - Start a chat session with an AI model
+- `chat list` - List available chat models
+
+For a complete list of commands, run:
+
+```bash
+npx berget --help
+```
+
+## Troubleshooting
+
+```bash
+# 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
+```
 
 ## Development
 
@@ -36,12 +196,12 @@ The refresh mechanism uses the stored refresh token to obtain a new access token
 Clone the repository and install dependencies:
 
 ```bash
-git clone https://github.com/berget/cli.git
+git clone https://github.com/berget-ai/cli.git
 cd cli
 npm install
 ```
 
-### Testing Locally
+### Test Locally
 
 Use the `start` script to test the CLI locally with the `--local` flag:
 
@@ -62,31 +222,10 @@ npm start -- auth whoami
 npm start -- auth whoami --debug
 ```
 
-The `--debug` flag provides detailed information about token refresh attempts and API responses.
-
-### Testing Token Refresh
-
-To test the token refresh mechanism:
+## Contributing
 
-1. Log in with `npm start -- auth login`
-2. Make a request that requires authentication, like `npm start -- auth whoami`
-3. To force a token refresh, you can:
-   - Wait until the token is close to expiration
-   - Manually edit `~/.berget/auth.json` and set `expires_at` to a past timestamp
-   - Use the `--debug` flag to see the token refresh process in action
+Berget CLI is open source. Contributions are welcome!
 
-## Commands
-
-- `auth login` - Log in to Berget
-- `auth logout` - Log out from Berget
-- `auth whoami` - Show current user information
-- `api-keys list` - List API keys
-- `api-keys create` - Create a new API key
-- `models list` - List available AI models
-- `chat run` - Start a chat session with an AI model
-
-For a complete list of commands, run:
-
-```bash
-berget --help
-```
+- GitHub: [berget-ai/cli](https://github.com/berget-ai/cli)
+- Issues: [Report bugs](https://github.com/berget-ai/cli/issues)
+- Documentation: [docs.berget.ai](https://docs.berget.ai)

package/dist/package.json

@@ -1,17 +1,22 @@
 {
     "name": "berget",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "main": "dist/index.js",
     "bin": {
         "berget": "dist/index.js"
     },
     "private": false,
+    "publishConfig": {
+        "access": "public"
+    },
     "scripts": {
         "start": "node --import tsx ./index.ts --local",
         "login": "node --import tsx ./index.ts --local auth login",
         "logout": "node --import tsx ./index.ts --local auth logout",
         "whoami": "node --import tsx ./index.ts --local auth whoami",
         "build": "tsc",
+        "test": "vitest",
+        "test:run": "vitest run",
         "prepublishOnly": "npm run build",
         "generate-types": "openapi-typescript https://api.berget.ai/openapi.json -o src/types/api.d.ts"
     },
@@ -19,14 +24,19 @@
     "license": "MIT",
     "description": "This is a cli command for interacting with the AI infrastructure provider Berget",
     "devDependencies": {
+        "@types/marked": "^5.0.2",
+        "@types/marked-terminal": "^6.1.1",
         "@types/node": "^20.11.20",
         "tsx": "^4.19.3",
-        "typescript": "^5.3.3"
+        "typescript": "^5.3.3",
+        "vitest": "^1.0.0"
     },
     "dependencies": {
         "chalk": "^4.1.2",
         "commander": "^12.0.0",
         "fs-extra": "^11.3.0",
+        "marked": "^9.1.6",
+        "marked-terminal": "^6.2.0",
         "open": "^9.1.0",
         "openapi-fetch": "^0.9.1",
         "openapi-typescript": "^6.7.4",