@webdeb/gogi 1.0.0 → 1.0.2

package/README.md

@@ -6,28 +6,27 @@ Unlike other CLI assistants that require you to manage your own paid API keys, G
 
 ## ✨ Features
 
-- **Natural Language to Shell**: Tell Gogi what you want to do (e.g., `gogi how much space is left on my machine`) and it will propose the correct terminal command.
-- **Safe Execution Loop**: Gogi intercepts the AI's proposed commands and explicitly asks for your permission (`Allow? (y/N)`) before running anything. It will capture the `stdout` and `stderr` and feed it back to the LLM so it can learn from mistakes or chain commands together.
-- **Multi-Provider OAuth**: Sign in securely using your existing AI accounts. Supported providers include:
+**Natural Language to Shell**: Tell Gogi what you want to do 
+`gogi how much space is left on my machine`
+
+**Safe Execution Loop**: Gogi intercepts the AI's proposed commands and explicitly asks for your permission (`Allow? (y/N)`) before running anything. It will capture the `stdout` and `stderr` and feed it back to the LLM so it can learn from mistakes or chain commands together.
+
+**Multi-Provider OAuth**: Sign in securely using your existing AI accounts. Supported providers include:
   - `codex` (ChatGPT Plus/Pro subscription)
   - `gemini` (Google Cloud)
   - `github` (GitHub Copilot)
-- **Auto-Generated System Context**: On first run, Gogi automatically profiles your machine (OS, architecture, shell) and generates a `~/.gogi/system.md` file. It injects this into the LLM's system prompt so the AI always knows what operating system and shell it's working with.
+
+**Auto-Generated System Context**: On first run, Gogi automatically profiles your machine (OS, architecture, shell) and generates a `~/.gogi/system.md` file. It injects this into the LLM's system prompt so the AI always knows what operating system and shell it's working with.
 
 ---
 
 ## 🚀 Installation
 
-1. Clone or download the repository.
-2. Install dependencies:
-   ```bash
-   npm install
-   ```
-3. Build the TypeScript source and link it globally:
-   ```bash
-   npm run build
-   npm link
-   ```
+Install the package globally via npm:
+
+```bash
+npm install -g @webdeb/gogi
+```
 
 You can now use the `gogi` command from anywhere in your terminal!
 
@@ -66,6 +65,11 @@ Simply type `gogi` followed by your request:
 gogi find all the .ts files in the current directory
 ```
 
+> **Tip:** If your prompt contains special shell characters like `?` or `*`, be sure to wrap your prompt in quotes so your shell doesn't try to evaluate it as a file glob:
+> ```bash
+> gogi "what time is it?"
+> ```
+
 ```bash
 🤔 Gogi is thinking...
 ✔ Gogi wants to run:

package/dist/agent.js

@@ -64,7 +64,7 @@ ${systemDetails}
     while (true) {
         let response;
         try {
-            response = await (0, pi_ai_1.complete)(model, context, { apiKey: config.openaiApiKey });
+            response = await (0, pi_ai_1.complete)(model, context, { apiKey });
         }
         catch (err) {
             console.error(`❌ API Error: ${err.message}`);

package/dist/auth.js

@@ -50,11 +50,20 @@ async function loginFlow(provider = 'codex') {
                 console.log(`\n🌐 Opening browser for sign-in... If it doesn't open automatically, visit:\n${info.url}`);
                 if (info.instructions)
                     console.log(info.instructions);
+                console.log(`\nIf you are on a headless machine or the browser doesn't redirect back:`);
+                console.log(`1. Open the URL above in any browser`);
+                console.log(`2. Complete the sign-in process`);
+                console.log(`3. Copy the URL you are redirected to (it will start with http://localhost...)`);
+                console.log(`4. Paste it here:`);
                 (0, open_1.default)(info.url);
             },
             onPrompt: async (prompt) => {
                 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
                 return new Promise((resolve) => rl.question(`${prompt.message} `, (answer) => { rl.close(); resolve(answer); }));
+            },
+            onManualCodeInput: async () => {
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                return new Promise((resolve) => rl.question(`> `, (answer) => { rl.close(); resolve(answer); }));
             }
         });
     }
@@ -63,7 +72,15 @@ async function loginFlow(provider = 'codex') {
             console.log(`\n🌐 Opening browser for sign-in... If it doesn't open automatically, visit:\n${info.url}`);
             if (info.instructions)
                 console.log(info.instructions);
+            console.log(`\nIf you are on a headless machine or the browser doesn't redirect back:`);
+            console.log(`1. Open the URL above in any browser`);
+            console.log(`2. Complete the sign-in process`);
+            console.log(`3. Copy the URL you are redirected to (it will start with http://localhost...)`);
+            console.log(`4. Paste it here:`);
             (0, open_1.default)(info.url);
+        }, undefined, async () => {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            return new Promise((resolve) => rl.question(`> `, (answer) => { rl.close(); resolve(answer); }));
         });
     }
     else if (provider === 'github') {

package/dist/index.js

@@ -30,7 +30,7 @@ program
     console.log(`✅ Active provider switched to ${provider}`);
 });
 program
-    .argument('[prompt...]', 'The task you want gogi to perform')
+    .argument('[prompt...]', 'The task you want gogi to perform. Tip: use quotes if your prompt contains ?, *, or other special shell characters.')
     .action(async (promptArr) => {
     const prompt = promptArr.join(' ').trim();
     if (!prompt) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webdeb/gogi",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Gogi CLI: An AI-powered terminal assistant with native device-code OAuth.",
   "main": "dist/index.js",
   "bin": {