@dccxx/auggiegw 1.0.4 → 1.0.6

package/.env

@@ -1,2 +1,2 @@
 AUGMENT_GATEWAY_URL=https://augmentgateway.1app.space
-
+AUGGIEGW_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOjEsInVzZXJuYW1lIjoicm9vdCIsImVtYWlsIjoiIiwiZGlzcGxheU5hbWUiOiJSb290IFVzZXIiLCJyb2xlIjoxMDAsInN0YXR1cyI6MSwibG9jYWxSb2xlIjp7InJvbGVUeXBlIjoiQURNSU4iLCJjcmVhdGVkQXQiOiIyMDI1LTA4LTI1VDA5OjQ2OjAyLjM5M1oiLCJ1cGRhdGVkQXQiOiIyMDI1LTA4LTI1VDA5OjQ2OjAyLjM5M1oifSwidGhpcmRQYXJ0eVNlc3Npb24iOnsiYWNjZXNzVG9rZW4iOiIiLCJjb29raWVzIjpbInNlc3Npb249TVRjMU9UZ3lNelF3Tlh4RVdEaEZRVkZNWDJkQlFVSkZRVVZSUVVGQ2MxODBRVUZDUVZwNlpFaEtjR0p0WTAxRFFVRkhZek5TYUdSSVZucEJNbXgxWkVGUlEwRkJTVWRqTTFKNVlWYzFia1JCVVVGQmJXeHJRVEpzZFdSQlVVTkJRVWxIWXpOU2VXRlhOVzVFUVc5QlEwaFdlbHBZU25WWlZ6RnNRbTVPTUdOdGJIVmFkM2RIUVVGU2VXSXlPVEJDYms0d1kyMXNkVnAzZDBkQlFWSjVZako0YkVFeWJIVmtRVkZFUVZCZlNYeHlDWVdRbzF3Z3o2ZHZOUk5uQ3JYNEhlWWF6Wm91T1NPak5BTnI0c2FGSUE9PTsgUGF0aD0vOyBFeHBpcmVzPVRodSIsIjA2IE5vdiAyMDI1IDA3OjUwOjA1IEdNVDsgTWF4LUFnZT0yNTkyMDAwIl19LCJxdW90YSI6MCwidXNlZFF1b3RhIjowLCJyZXF1ZXN0Q291bnQiOjAsImdyb3VwIjoiIiwiaWF0IjoxNzU5ODIzNDA1LCJleHAiOjE3OTEzNTk0MDUsImlzcyI6ImF1Z21lbnQtZ2F0ZXdheSJ9.9FgtSkgFWl3b7HHIGL9IhP3NPZul9ESseRQogyw-KN0

package/.env.example

@@ -1,2 +1,3 @@
 AUGMENT_GATEWAY_URL=https://augmentgateway.1app.space
+AUGGIEGW_AUTH_TOKEN=
 

package/README.md

@@ -1,67 +1,238 @@
 # @dccxx/auggiegw
 
-A Node.js TypeScript package with CLI support.
+A CLI tool for managing Augment Gateway authentication, proxy configuration, and custom prompts. This tool simplifies the workflow of authenticating with Augment Gateway, fetching proxy configurations, and managing custom prompts for the Augment AI assistant.
+
+## Features
+
+- 🔐 **Authentication Management**: Login/logout with secure credential storage
+- 🌐 **Proxy Configuration**: Automatic proxy setup and authentication
+- 📝 **Custom Prompts**: Fetch and save custom prompts to `~/.augment/commands/`
+- 🔄 **Auggie Integration**: Seamlessly forward commands to the Auggie CLI
+- ⚡ **Command Execution**: Execute any command with automatic session setup
 
 ## Installation
 
-Install dependencies:
+```bash
+npm install -g @dccxx/auggiegw
+```
+
+or with Bun:
 
 ```bash
-bun install
+bun install -g @dccxx/auggiegw
 ```
 
-## Development
+## Quick Start
+
+1. **Login to Augment Gateway**:
+   ```bash
+   auggiegw login
+   ```
+   You'll be prompted for your username and password.
+
+2. **Fetch Configuration**:
+   ```bash
+   auggiegw fetch
+   ```
+   This fetches proxy configuration, authenticates, and downloads custom prompts.
+
+## Commands
+
+### `auggiegw login [username] [password]`
 
-Build the project:
+Login and store credentials securely.
 
+**Interactive Mode** (Recommended):
 ```bash
-bun run build
+auggiegw login
 ```
+You'll be prompted to enter your username and password. The password input is hidden for security.
 
-Run linter:
+**Direct Mode**:
+```bash
+auggiegw login myusername mypassword
+```
+
+**What it does**:
+- Authenticates with the Augment Gateway API
+- Stores credentials in `~/.auggiegw/auth.json`
+- Token is used for subsequent commands
+
+---
+
+### `auggiegw logout`
+
+Logout and remove stored credentials.
 
 ```bash
-bun run lint
+auggiegw logout
 ```
 
-Clean build artifacts:
+**What it does**:
+- Deletes the authentication file (`~/.auggiegw/auth.json`)
+- Removes stored credentials from your system
+
+---
+
+### `auggiegw fetch`
+
+Fetch proxy configuration, authenticate, and download custom prompts.
 
 ```bash
-bun run clean
+auggiegw fetch
 ```
 
-## Usage
+**What it does**:
+1. Retrieves proxy configuration from Augment Gateway
+2. Authenticates the proxy
+3. Saves Augment session to `~/.augment/session.json`
+4. Fetches all custom prompts from the server
+5. Saves prompts as markdown files in `~/.augment/commands/`
 
-### As a CLI tool
+**Output Example**:
+```
+✔ Successfully saved 15 prompts
+```
+
+---
 
-After building, you can run the CLI command:
+### `auggiegw auggie [args...]`
+
+Forward commands to the Auggie CLI with automatic configuration.
 
 ```bash
-node dist/cli.js
+auggiegw auggie [auggie-arguments]
 ```
 
-Or if installed globally:
+**Examples**:
+```bash
+# Run Auggie with help
+auggiegw auggie --help
+```
+
+**What it does**:
+1. Runs `auggiegw fetch` to ensure configuration is up-to-date
+2. Forwards all arguments to the `auggie` command
+3. Inherits stdio for interactive sessions
+
+---
+
+### `auggiegw exec <command> [args...]`
+
+Execute any custom command with automatic session setup.
 
 ```bash
-auggiegw
+auggiegw exec <command> [arguments]
 ```
 
-### As a library
+**Examples**:
+```bash
+auggiegw exec auggie --help
+```
+
+**What it does**:
+1. Runs `auggiegw fetch` to ensure configuration is up-to-date
+2. Executes the specified command with provided arguments
+3. Inherits stdio for interactive sessions
+
+---
 
-Import and use in your Node.js project:
+## Authentication Methods
 
-```typescript
-import '@dccxx/auggiegw';
+### Method 1: Login Command (Recommended for Local Development)
+
+```bash
+auggiegw login
 ```
 
-## Project Structure
+Credentials are stored in `~/.auggiegw/auth.json` and automatically used for subsequent commands.
 
-- `src/` - TypeScript source files
-- `dist/` - Compiled JavaScript output (generated by build)
-- `tsconfig.json` - TypeScript configuration
-- `biome.json` - Biome linter configuration
+### Method 2: Environment Variable (Recommended for CI/CD)
+
+Set the `AUGGIEGW_AUTH_TOKEN` environment variable:
+
+```bash
+export AUGGIEGW_AUTH_TOKEN=your_token_here
+```
+
+When this environment variable is set, the CLI uses it directly without requiring the login command or auth.json file.
+
+**Example in CI/CD**:
+```yaml
+# GitHub Actions example
+env:
+  AUGGIEGW_AUTH_TOKEN: ${{ secrets.AUGGIEGW_AUTH_TOKEN }}
+```
+
+---
+
+## Configuration
+
+### File Locations
+
+- **Auth Data**: `~/.auggiegw/auth.json`
+- **Augment Session**: `~/.augment/session.json`
+- **Custom Prompts**: `~/.augment/commands/*.md`
+
+---
+
+## Custom Prompts
+
+Custom prompts are fetched from the Augment Gateway and saved as markdown files in `~/.augment/commands/`. Each prompt file follows this format:
+
+```markdown
+---
+description: Prompt Name
+---
+
+Prompt content goes here...
+```
+
+The filename corresponds to the command name (e.g., `my-command.md`).
+
+---
 
 ## Requirements
 
-- Node.js >= 18.0.0
-- Bun (for package management and running scripts)
+- **Node.js**: >= 18.0.0
+- **Bun**: For package management and running scripts (development)
+- **Auggie CLI**: Required for `auggiegw auggie` command
+
+---
+
+## Troubleshooting
+
+### "Not logged in" Error
+
+```
+Error: Not logged in. Please run "auggiegw login" first.
+```
+
+**Solution**: Run `auggiegw login` to authenticate.
+
+### "Failed to get proxy" Error
+
+**Possible causes**:
+- Invalid credentials
+- Network connectivity issues
+- API endpoint unavailable
+
+**Solution**: 
+1. Verify your credentials with `auggiegw logout` then `auggiegw login`
+2. Check your network connection
+3. Verify the API URL is correct
+
+### "No proxy data available" Error
+
+**Solution**: Contact your administrator to ensure your account has proxy access configured.
+
+---
+
+## License
+
+See LICENSE file for details.
+
+## Support
+
+For issues and questions, please open an issue on the GitHub repository.
+

package/dist/cli.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
-import { exec } from 'node:child_process';
+import { exec, spawn } from 'node:child_process';
 import * as fs from 'node:fs/promises';
+import { createRequire } from 'node:module';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import * as readline from 'node:readline/promises';
 import { promisify } from 'node:util';
 import { Command } from 'commander';
+const require = createRequire(import.meta.url);
+const ora = require('ora');
 const execAsync = promisify(exec);
 const AUTH_DIR = path.join(os.homedir(), '.auggiegw');
 const AUTH_FILE = path.join(AUTH_DIR, 'auth.json');
@@ -28,6 +31,14 @@ async function saveAuthData(data) {
     await ensureAuthDirectory();
     await fs.writeFile(AUTH_FILE, JSON.stringify(data, null, 2), 'utf-8');
 }
+async function getAuthToken() {
+    const envToken = process.env.AUGGIEGW_AUTH_TOKEN;
+    if (envToken) {
+        return envToken;
+    }
+    const authData = await loadAuthData();
+    return authData.token;
+}
 async function loadAuthData() {
     try {
         const data = await fs.readFile(AUTH_FILE, 'utf-8');
@@ -75,13 +86,15 @@ async function getPrompts(token, apiUrl, page, limit) {
     }
     return data;
 }
-async function getAllPrompts(token, apiUrl) {
+async function getAllPrompts(token, apiUrl, spinner) {
     const allPrompts = [];
     const limit = 10;
     let currentPage = 1;
     let hasMorePages = true;
     while (hasMorePages) {
-        console.log(`Fetching prompts page ${currentPage}...`);
+        if (spinner) {
+            spinner.text = `Fetching prompts (page ${currentPage})...`;
+        }
         const response = await getPrompts(token, apiUrl, currentPage, limit);
         if (response.data.prompts && response.data.prompts.length > 0) {
             allPrompts.push(...response.data.prompts);
@@ -218,11 +231,9 @@ async function handleLogin(usernameArg, passwordArg) {
         const authData = {
             username,
             token: loginResponse.data.token,
-            user: loginResponse.data.user,
         };
         await saveAuthData(authData);
         console.log('Login successful! Token saved.');
-        console.log(`Welcome, ${loginResponse.data.user.display_name}!`);
     }
     catch (error) {
         console.error(`Login failed: ${error}`);
@@ -240,29 +251,30 @@ async function handleLogout() {
     }
 }
 async function handleFetch() {
+    const spinner = ora('Initializing...').start();
     try {
         const config = loadConfig();
-        const authData = await loadAuthData();
-        console.log('Fetching proxy configuration...');
-        const proxyResponse = await getProxy(authData.token, config.apiUrl);
+        const token = await getAuthToken();
+        spinner.text = 'Fetching proxy configuration...';
+        const proxyResponse = await getProxy(token, config.apiUrl);
         if (!proxyResponse.data || proxyResponse.data.length === 0) {
-            console.error('Error: No proxy data available');
+            spinner.fail('No proxy data available');
             process.exit(1);
         }
         const firstProxy = proxyResponse.data[0];
         if (!firstProxy) {
-            console.error('Error: No proxy data available');
+            spinner.fail('No proxy data available');
             process.exit(1);
         }
         const proxyId = firstProxy.http_user;
         const rawPassword = firstProxy.http_password;
         const atIndex = rawPassword.indexOf('@');
         if (atIndex === -1) {
-            console.error('Error: Invalid proxy password format');
+            spinner.fail('Invalid proxy password format');
             process.exit(1);
         }
         const proxyPassword = rawPassword.substring(0, atIndex);
-        console.log('Authenticating proxy...');
+        spinner.text = 'Authenticating proxy...';
         const authResponse = await authProxy(proxyId, proxyPassword, config.apiUrl);
         if (authResponse.success && authResponse.data) {
             const augmentSession = {
@@ -273,31 +285,62 @@ async function handleFetch() {
             await saveAugmentSession(augmentSession);
             try {
                 await execAsync('auggie session delete');
-                console.log('Session configured successfully');
             }
-            catch (error) {
-                console.warn(`Warning: Failed to run auggie session delete: ${error.message}`);
+            catch {
+                // Silently ignore auggie session delete errors
             }
-            console.log('Fetching prompts...');
-            const allPrompts = await getAllPrompts(authData.token, config.apiUrl);
+            spinner.text = 'Fetching prompts...';
+            const allPrompts = await getAllPrompts(token, config.apiUrl, spinner);
             if (allPrompts.length > 0) {
-                console.log(`Saving ${allPrompts.length} prompts...`);
+                spinner.text = `Saving ${allPrompts.length} prompts...`;
                 for (const prompt of allPrompts) {
                     await savePromptToFile(prompt);
-                    console.log(`Saved: ${prompt.command}.md`);
                 }
-                console.log('All prompts saved successfully');
+                spinner.succeed(`Successfully saved ${allPrompts.length} prompts`);
             }
             else {
-                console.log('No prompts found');
+                spinner.warn('No prompts found');
             }
         }
     }
     catch (error) {
-        console.error(`Fetch failed: ${error}`);
+        spinner.fail(`Fetch failed: ${error}`);
         process.exit(1);
     }
 }
+async function handleAuggie(args) {
+    await handleFetch();
+    const auggieProcess = spawn('auggie', args, {
+        stdio: 'inherit',
+        shell: true,
+    });
+    auggieProcess.on('error', (error) => {
+        console.error(`Failed to execute auggie: ${error.message}`);
+        process.exit(1);
+    });
+    auggieProcess.on('exit', (code) => {
+        process.exit(code ?? 0);
+    });
+}
+async function handleExec(command, args) {
+    if (!command) {
+        console.error('Error: Command is required');
+        console.error('Usage: auggiegw exec <command> [args...]');
+        process.exit(1);
+    }
+    await handleFetch();
+    const childProcess = spawn(command, args, {
+        stdio: 'inherit',
+        shell: true,
+    });
+    childProcess.on('error', (error) => {
+        console.error(`Failed to execute ${command}: ${error.message}`);
+        process.exit(1);
+    });
+    childProcess.on('exit', (code) => {
+        process.exit(code ?? 0);
+    });
+}
 const program = new Command();
 program.name('auggiegw').description('CLI tool for auggiegw authentication').version('1.0.0');
 program
@@ -309,5 +352,19 @@ program
     .command('fetch')
     .description('Fetch proxy configuration and authenticate')
     .action(handleFetch);
+program
+    .command('auggie [args...]')
+    .description('Forward command to auggie CLI')
+    .allowUnknownOption()
+    .action((args) => {
+    handleAuggie(args || []);
+});
+program
+    .command('exec <command> [args...]')
+    .description('Execute any custom command')
+    .allowUnknownOption()
+    .action((command, args) => {
+    handleExec(command, args);
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/justfile

@@ -0,0 +1,46 @@
+set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
+set shell := ["bash", "-cu"]
+
+# Default recipe - show available commands
+default:
+    @just --list
+
+# Build the TypeScript project
+build:
+    bunx tsc
+
+# Run linter with auto-fix
+lint:
+    bunx biome check --write
+
+# Clean the dist directory
+clean:
+    @{{ if os_family() == "windows" { "if (Test-Path dist) { Remove-Item -Recurse -Force dist }" } else { "rm -rf dist" } }}
+
+# Publish package to npm (auto-increments version)
+[confirm("Are you sure you want to publish to npm?")]
+publish:
+    node scripts/bump-version.js
+    npm publish --access public
+
+# Development: Run login command
+dev-login:
+    bun run src/cli.ts login
+
+# Development: Run fetch command
+dev-fetch:
+    bun run src/cli.ts fetch
+
+dev-auggie:
+    bun run src/cli.ts auggie --print "hi"
+
+# Build and then publish (recommended workflow)
+[confirm("This will build and publish. Continue?")]
+release: lint rebuild publish
+
+# Clean and rebuild
+rebuild: clean build
+
+# Run all quality checks (lint + build)
+check: lint build
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dccxx/auggiegw",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "A Node.js TypeScript package",
   "main": "./dist/cli.js",
   "types": "./dist/cli.d.ts",
@@ -25,6 +25,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "commander": "^14.0.1"
+    "commander": "^14.0.1",
+    "ora": "^5.4.1"
   }
 }

package/scripts/bump-version.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const packageJsonPath = join(__dirname, '..', 'package.json');
+
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+
+const currentVersion = packageJson.version;
+const versionParts = currentVersion.split('.');
+
+if (versionParts.length !== 3) {
+  console.error(`Invalid version format: ${currentVersion}`);
+  process.exit(1);
+}
+
+const [major, minor, patch] = versionParts.map(Number);
+
+if (versionParts.some((part) => Number.isNaN(Number(part)))) {
+  console.error(`Invalid version format: ${currentVersion}`);
+  process.exit(1);
+}
+
+const newVersion = `${major}.${minor}.${patch + 1}`;
+
+packageJson.version = newVersion;
+
+writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf-8');
+
+console.log(`Version bumped: ${currentVersion} → ${newVersion}`);
+
+try {
+  execSync('git add package.json', { stdio: 'inherit' });
+  execSync(`git commit -m "chore: bump version to ${newVersion}"`, {
+    stdio: 'inherit',
+  });
+  console.log('Committed version bump to git');
+} catch (error) {
+  console.error('Failed to commit version bump:', error.message);
+  process.exit(1);
+}