@pikaa-ai/pikaa 0.2.3 → 0.2.4

package/bin/pikaa.js

@@ -105,14 +105,15 @@ async function downloadBinary(url, dest, redirects = 0) {
 }
 
 async function main() {
-  const existing = findExistingBinary();
-  if (existing) {
-    launchBinary(existing);
+  // 1. If local bun and dist/cli.js are available in the package, run immediately
+  if (tryLaunchWithBun()) {
     return;
   }
 
-  // If local bun and dist/cli.js are available, run immediately with 0 download
-  if (tryLaunchWithBun()) {
+  // 2. Otherwise use existing native binary if present
+  const existing = findExistingBinary();
+  if (existing) {
+    launchBinary(existing);
     return;
   }
 

package/dist/cli.js

@@ -468,12 +468,16 @@ function buildSystemPrompt(params) {
   const sections = [];
   sections.push(params.basePrompt || "You are Groupy, an expert autonomous AI coding assistant. You think step-by-step, act surgically, and write clean, correct code.");
   sections.push([
-    "## Operational Guidelines",
-    "1. Think before acting. Understand the task and the code it touches before making edits.",
-    "2. Simplicity first: write the minimum code that solves the problem. No unnecessary abstractions.",
-    "3. Use `apply_patch` for surgical code replacements rather than overwriting whole files.",
-    "4. Execute shell commands with `shell` to inspect environment, run tests, or build targets.",
-    "5. Always verify your changes with tests or execution checks."
+    "## Editing Constraints & Guidelines",
+    "- Use `apply_patch` for surgical single-file edits. TargetContent must match existing file content exactly.",
+    "- Use `write_file` for creating new files or when completely replacing the full content of a file.",
+    "- Use `read_file` to inspect files and `grep_search` / `find_files` to discover symbols and locate files across the project.",
+    "- NEVER create temporary scripts, scratch files, or chunk files (e.g. `_tmp_*.ps1`, `_tmp_*.txt`, `split_*.py`) in the workspace to manipulate, split, or read files.",
+    "- NEVER execute shell or PowerShell scripts as a workaround for reading, writing, or editing text files.",
+    "- Use the `shell` tool ONLY for running tests, build targets, package installations, or checking environment/git status.",
+    "- You may be in a dirty git worktree. NEVER revert existing changes made by the user.",
+    "- NEVER use destructive commands like `git reset --hard` or `git checkout --`.",
+    "- Be concise, direct, and act surgically. Write clean, correct code with minimal necessary modifications."
   ].join(`
 `));
   if (params.memoriesPrompt) {
@@ -769,7 +773,7 @@ class ExecPolicy {
   }
   initDefaultRules() {
     this.addRule(/^(git\s+(status|log|diff|branch|show|rev-parse))/i, "allow", "Safe git query");
-    this.addRule(/^(ls|dir|cat|grep|rg|find|pwd|echo|head|tail|wc|which|where)\b/i, "allow", "Safe read-only shell command");
+    this.addRule(/^(ls|dir|cat|type|grep|rg|find|pwd|echo|head|tail|wc|which|where)\b/i, "allow", "Safe read-only shell command");
     this.addRule(/^(bun\s+(test|--version|-v)|npm\s+(test|--version|-v)|node\s+-v)\b/i, "allow", "Testing & runtime check");
     this.addRule(/^(rm|del|rmdir|format|mkfs)\b/i, "prompt", "Destructive file removal");
     this.addRule(/^(git\s+(push|reset\s+--hard|clean\s+-fd|rebase))\b/i, "prompt", "Destructive git operation");
@@ -5906,6 +5910,8 @@ async function main() {
   let model = process.env.GROUPY_MODEL || process.env.OPENAI_MODEL || "groupy";
   let baseUrl = process.env.GROUPY_BASE_URL || process.env.OPENAI_BASE_URL || savedCreds?.baseUrl;
   let apiKey = process.env.GROUPY_API_KEY || process.env.OPENAI_API_KEY || savedCreds?.accessToken;
+  let explicitBaseUrl;
+  let explicitApiKey;
   let cwd = process.cwd();
   let role = "default";
   let mcpConfigFile;
@@ -5930,7 +5936,7 @@ async function main() {
       printWhoami2(credStore);
       process.exit(0);
     } else if (arg === "models" || arg === "--models") {
-      await printAvailableModels(baseUrl || "http://localhost:8090/v1", apiKey);
+      await printAvailableModels(baseUrl || "https://api.groupy-hub.store/v1", apiKey);
       process.exit(0);
     } else if (arg === "list" || arg === "sessions" || arg === "--list") {
       printSessionsList(storageManager);
@@ -5949,15 +5955,20 @@ async function main() {
     } else if (arg === "--model" || arg === "-m") {
       model = args[++i] || model;
     } else if (arg === "--base-url" || arg === "-u") {
-      baseUrl = args[++i] || baseUrl;
+      explicitBaseUrl = args[++i];
+      baseUrl = explicitBaseUrl || baseUrl;
     } else if (arg === "--api-key" || arg === "-k") {
-      apiKey = args[++i] || apiKey;
+      explicitApiKey = args[++i];
+      apiKey = explicitApiKey || apiKey;
     } else if (arg === "--cwd" || arg === "-C") {
       cwd = resolve13(args[++i] || cwd);
     } else if (arg === "--role" || arg === "-r") {
       role = args[++i] || role;
     } else if (arg === "--mcp") {
       mcpConfigFile = args[++i];
+    } else if (arg === "--version" || arg === "-v" || arg === "version") {
+      console.log(`pikaa v0.2.4`);
+      process.exit(0);
     } else if (arg === "--help" || arg === "-h") {
       printCliHelp();
       process.exit(0);
@@ -5966,8 +5977,8 @@ async function main() {
     }
   }
   const modelClient = new ModelClient({
-    baseUrl,
-    apiKey,
+    baseUrl: explicitBaseUrl,
+    apiKey: explicitApiKey,
     defaultModel: model
   });
   const tools = createDefaultTools({ skillsLoader, memoryStore, worktreeManager });
@@ -6223,6 +6234,7 @@ ${style.bold("OPTIONS:")}
   -C, --cwd <path>         Working directory for agent operations (default: current dir)
   -r, --role <role>        Initial agent role (default, reviewer, researcher, tester, planner)
       --mcp <path>         Path to MCP server configuration JSON file
+  -v, --version            Show CLI version
   -h, --help               Show this help message
 
 ${style.bold("EXAMPLES:")}

package/dist/index.js

@@ -453,7 +453,7 @@ class ExecPolicy {
   }
   initDefaultRules() {
     this.addRule(/^(git\s+(status|log|diff|branch|show|rev-parse))/i, "allow", "Safe git query");
-    this.addRule(/^(ls|dir|cat|grep|rg|find|pwd|echo|head|tail|wc|which|where)\b/i, "allow", "Safe read-only shell command");
+    this.addRule(/^(ls|dir|cat|type|grep|rg|find|pwd|echo|head|tail|wc|which|where)\b/i, "allow", "Safe read-only shell command");
     this.addRule(/^(bun\s+(test|--version|-v)|npm\s+(test|--version|-v)|node\s+-v)\b/i, "allow", "Testing & runtime check");
     this.addRule(/^(rm|del|rmdir|format|mkfs)\b/i, "prompt", "Destructive file removal");
     this.addRule(/^(git\s+(push|reset\s+--hard|clean\s+-fd|rebase))\b/i, "prompt", "Destructive git operation");
@@ -1438,12 +1438,16 @@ function buildSystemPrompt(params) {
   const sections = [];
   sections.push(params.basePrompt || "You are Groupy, an expert autonomous AI coding assistant. You think step-by-step, act surgically, and write clean, correct code.");
   sections.push([
-    "## Operational Guidelines",
-    "1. Think before acting. Understand the task and the code it touches before making edits.",
-    "2. Simplicity first: write the minimum code that solves the problem. No unnecessary abstractions.",
-    "3. Use `apply_patch` for surgical code replacements rather than overwriting whole files.",
-    "4. Execute shell commands with `shell` to inspect environment, run tests, or build targets.",
-    "5. Always verify your changes with tests or execution checks."
+    "## Editing Constraints & Guidelines",
+    "- Use `apply_patch` for surgical single-file edits. TargetContent must match existing file content exactly.",
+    "- Use `write_file` for creating new files or when completely replacing the full content of a file.",
+    "- Use `read_file` to inspect files and `grep_search` / `find_files` to discover symbols and locate files across the project.",
+    "- NEVER create temporary scripts, scratch files, or chunk files (e.g. `_tmp_*.ps1`, `_tmp_*.txt`, `split_*.py`) in the workspace to manipulate, split, or read files.",
+    "- NEVER execute shell or PowerShell scripts as a workaround for reading, writing, or editing text files.",
+    "- Use the `shell` tool ONLY for running tests, build targets, package installations, or checking environment/git status.",
+    "- You may be in a dirty git worktree. NEVER revert existing changes made by the user.",
+    "- NEVER use destructive commands like `git reset --hard` or `git checkout --`.",
+    "- Be concise, direct, and act surgically. Write clean, correct code with minimal necessary modifications."
   ].join(`
 `));
   if (params.memoriesPrompt) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikaa-ai/pikaa",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "PIKAA CLI - AI coding agent that runs locally in your terminal.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",