piclaw 0.0.4 → 0.0.6

package/.output/server/node_modules/@mongodb-js/zstd/lib/index.js

@@ -0,0 +1,55 @@
+'use strict';
+const { promisify } = require('util');
+const { isUint8Array } = require('util/types');
+
+function load() {
+  try {
+    return require('../build/Release/zstd.node');
+  } catch {
+    // Webpack will fail when just returning the require, so we need to wrap
+    // in a try/catch and rethrow.
+    /* eslint no-useless-catch: 0 */
+    try {
+      return require('../build/Debug/zstd.node');
+    } catch (error) {
+      throw error;
+    }
+  }
+}
+
+const zstd = load();
+
+const _compress = promisify(zstd.compress);
+const _decompress = promisify(zstd.decompress);
+// Error objects created via napi don't have JS stacks; wrap them so .stack is present
+// https://github.com/nodejs/node/issues/25318#issuecomment-451068073
+
+exports.compress = async function compress(data, compressionLevel) {
+  if (!isUint8Array(data)) {
+    throw new TypeError(`parameter 'data' must be a Uint8Array.`);
+  }
+
+  if (compressionLevel != null && typeof compressionLevel !== 'number') {
+    throw new TypeError(`parameter 'compressionLevel' must be a number.`);
+  }
+
+  try {
+    return await _compress(data, compressionLevel ?? 3);
+  } catch (e) {
+    throw new Error(`zstd: ${e.message}`);
+  }
+};
+
+exports.decompress = async function decompress(data) {
+  if (!isUint8Array(data)) {
+    throw new TypeError(`parameter 'data' must be a Uint8Array.`);
+  }
+  try {
+    return await _decompress(data);
+  } catch (e) {
+    throw new Error(`zstd: ${e.message}`);
+  }
+};
+
+/** used for testing */
+exports.getDefinedNapiVersion = zstd.getDefinedNapiVersion;

package/.output/server/node_modules/@mongodb-js/zstd/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@mongodb-js/zstd",
+  "version": "7.0.0",
+  "main": "lib/index.js",
+  "types": "index.d.ts",
+  "repository": "https://github.com/mongodb-js/zstd",
+  "files": [
+    "index.d.ts",
+    "lib/index.js",
+    "addon/*",
+    "binding.gyp"
+  ],
+  "dependencies": {
+    "node-addon-api": "^8.5.0",
+    "prebuild-install": "^7.1.3"
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@mongodb-js/zstd": "^1.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@wasm-fmt/clang-format": "^21.1.4",
+    "chai": "^4.5.0",
+    "eslint": "^9.37.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "mocha": "^11.7.4",
+    "node-gyp": "^11.4.2",
+    "prebuild": "^13.0.1",
+    "prettier": "^3.6.2"
+  },
+  "engines": {
+    "node": ">= 20.19.0"
+  },
+  "scripts": {
+    "install": "prebuild-install --runtime napi || npm run clean-install",
+    "clean-install": "npm run install-zstd && npm run compile",
+    "compile": "node-gyp rebuild",
+    "test": "mocha test/*.js",
+    "install-zstd": "bash etc/install-zstd.sh",
+    "check:eslint": "ESLINT_USE_FLAT_CONFIG=false eslint *ts lib/*.js test/*.js .*.json",
+    "clang-format": "clang-format --style=file:.clang-format --Werror -i addon/*",
+    "check:clang-format": "clang-format --style=file:.clang-format --dry-run --Werror addon/*",
+    "prebuild": "prebuild --runtime napi --strip --verbose --all"
+  },
+  "binary": {
+    "napi_versions": [
+      9
+    ]
+  },
+  "mongodb:zstd_version": "1.5.6"
+}

package/.output/server/package.json

@@ -4,6 +4,7 @@
   "type": "module",
   "private": true,
   "dependencies": {
+    "@mongodb-js/zstd": "7.0.0",
     "node-pty": "1.2.0-beta.11",
     "tslib": "2.8.1",
     "undici": "7.22.0"

package/README.md

@@ -1,55 +1,148 @@
-# π PiClaw
+<p align="center">
+  <img src="./public/icon.svg" alt="PiClaw icon" width="96" height="96" />
+</p>
 
-PiClaw is a personal AI OS you can access from your browser.
+# PiClaw
 
-It runs in the background and gives each chat its own AI agent with memory and a workspace. You can use it from your browser or connect to Telegram.
+**PiClaw is your personal AI ops OS in the browser.**
+Spin it up, open a chat, and you’ve got a persistent coding agent with memory, tools, files, terminal tabs, and external channels.
 
 > [!NOTE]
 > This project is in private beta. Feel free to try it at your own risk, but please don't share it publicly.
 >
 > Please share your feedback with me ([@pi0](https://pi0.io)).
 
-## ✨ What you can do
+## 🚀 Quick Start
 
-### 🖥️ Desktop-style interface
+Choose one of the options below.
 
-A clean, simple desktop-like UI with draggable windows, a dock, wallpapers, and keyboard shortcuts.
+### Option A: Run on host (fastest)
 
-### 💬 Separate chats, groups, and @-trigger control
+**Prerequisite:** [Node.js](https://nodejs.org/en/download) or [Bun](https://bun.sh/)
 
-Each chat group has its own agent, memory, and workspace, so conversations stay organized.
+```sh
+# Node.js
+npx piclaw@latest
 
-For multi-user/group chats, you can use an `@` trigger system:
+# Bun
+bunx piclaw@latest
+```
 
-- **Trigger off:** every message is processed
-- **Trigger on:** only messages that start with `@assistant-name` are processed
+Then open: **http://localhost:3737**
 
-### 🤖 Configure your AI agents
+> [!TIP]
+> PiClaw stores state in `~/.pi/claw`.
 
-Connect providers and change models and settings from the UI, without editing config files in terminal.
+### Option B: Run with Docker (recommended)
 
-- **OAuth providers:** Anthropic (Claude Pro/Max), GitHub Copilot, Antigravity (Gemini 3, Claude, GPT-OSS), Google Cloud Code Assist (Gemini CLI), ChatGPT Plus/Pro (Codex Subscription).
-- **API key providers:** Anthropic, OpenAI, Vercel AI Gateway, OpenRouter, Kimi, OpenCode Zen, Azure OpenAI, Google Gemini, Mistral, Groq, Cerebras, xAI, ZAI, MiniMax, Hugging Face.
+**Prerequisite:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) or [OrbStack](https://orbstack.dev/)
 
-### 📁 Built-in file manager and editor
+This keeps PiClaw isolated from your host environment.
 
-Browse files, open them quickly, and edit code or notes directly in the app.
+> [!IMPORTANT]
+> By default, Docker binds ports to all interfaces (`0.0.0.0`), making the service accessible from your network. The examples below bind to `127.0.0.1` so only your machine can reach it. Remove the `127.0.0.1:` prefix if you intentionally want to expose it.
+
+```sh
+docker run -it --rm \
+  --user "$(id -u):$(id -g)" \
+  -p 127.0.0.1:3737:3737 \
+  -v "$HOME/.pi:/home/pi/.pi" \
+  ghcr.io/pi0/piclaw:latest
+```
+
+Then open: **http://localhost:3737**
+
+**Docker Compose:**
+
+```yaml
+services:
+  piclaw:
+    image: ghcr.io/pi0/piclaw:latest
+    ports:
+      - "127.0.0.1:3737:3737"
+    user: "${UID:-1000}:${GID:-1000}"
+    volumes:
+      - ${HOME}/.pi:/home/pi/.pi
+    restart: unless-stopped
+```
+
+## ⚡ Feature tour
+
+### 🖥️ AI + Desktop
+
+- Desktop-like UI multi window system
+- Launcher + taskbar workflow
+- Mobile-friendly full-screen experience
+- Quick welcome screen to get you online fast
+- Optional PWA install prompt for app-like usage
+
+### 💬 Multi-chat, multi-group, multi-context
+
+Each group/chat has its own:
+
+- agent session
+- workspace folder
+- persisted memory + session state
+- model + thinking settings
+
+Trigger behavior is configurable:
+
+- **Trigger off:** process every message
+- **Trigger on:** process only `@assistant-name ...`
+
+### 🤖 Serious agent controls
+
+Configure providers and model behavior from the UI (no config-file spelunking needed):
+
+- **OAuth providers:** Anthropic (Claude Pro/Max), GitHub Copilot, Antigravity (Gemini 3, Claude, GPT-OSS), Google Cloud Code Assist (Gemini CLI), ChatGPT Plus/Pro (Codex Subscription)
+- **API key providers:** Anthropic, OpenAI, Vercel AI Gateway, OpenRouter, Kimi, OpenCode Zen, Azure OpenAI, Google Gemini, Mistral, Groq, Cerebras, xAI, ZAI, MiniMax, Hugging Face
+
+Per-chat command controls include:
+
+- `/model` → list/set model
+- `/thinking` → tune reasoning depth
+- `/compact` → compact active context
+- `/stop` + `/new` → immediate session control
+- `/info` + `/help` → inspect current runtime state
+
+### 📡 Real-time streaming + tool telemetry
+
+- Token-by-token response streaming into chat UI
+- Live tool lifecycle events (tool start/end)
+- Crash-safe cursor/session recovery after restarts
+- Logs window for fast diagnosis
+
+### 📁 Files + editor + viewer built in
+
+- Group-scoped file browser
+- In-app editor and file viewer windows
+- Live file change watching (SSE)
+- Keyboard navigation in file explorer
 
 ### ⬛ Persistent terminal tabs
 
-Run terminal sessions that stay alive in the background, even if you close the tab or connect from multiple places.
+- Real PTY terminal sessions in the dashboard
+- Sessions survive window close/reopen
+- Label sync + reconnect across views
+- Optional virtual/sandbox-style terminal mode
 
-### ⏰ Task scheduler
+### ⏰ Scheduler + automation hooks
 
-Set one-time or repeating tasks and attach them to a specific chat group to run by agent.
+- One-time and recurring task scheduling
+- Attach tasks to specific chat groups
+- Automated prompts executed by the right agent context
 
-### 📲 Telegram support
+### 📲 External channels + notifications
 
-Connect a Telegram bot and chat with your agents from Telegram DMs or groups.
+- Telegram bot integration (DMs + groups)
+- Adaptive Telegram streaming throttling
+- ntfy push notifications
 
-### 📋 System logs
+### 🎨 Personalization
 
-View live app logs to monitor activity and troubleshoot issues.
+- Wallpapers + desktop appearance settings
+- Dash density/size preferences
+- Clean, modern typography and icon set
 
 ## 🧱 Built with
 
@@ -58,6 +151,7 @@ View live app logs to monitor activity and troubleshoot issues.
 - [Vite](https://vite.dev/) and [Rolldown](https://rolldown.rs/) — Builder
 - [Vue.js](https://vuejs.org/) — UI
 - [WinBox](https://nextapps-de.github.io/winbox/) — window manager (modernized fork)
+- [Md4x](https://github.com/pi0/md4x) - Markdown rendering and parsing
 - [Modern Monaco](https://github.com/esm-dev/modern-monaco) — code editor
 - [Visual JSON](https://github.com/vercel-labs/visual-json) — schema-aware JSON editor
 - [Xterm.js](https://github.com/xtermjs/xterm.js) and [node-pty](https://github.com/microsoft/node-pty) — terminal

package/bin/piclaw.mjs

@@ -1,4 +1,34 @@
 #!/usr/bin/env node
+import { parseArgs } from "node:util";
+
+process.removeAllListeners("warning");
+process.on("warning", (warning) => {
+  if (warning.name === "ExperimentalWarning") return;
+  console.warn(warning);
+});
+
+const { values } = parseArgs({
+  options: {
+    help: { type: "boolean", short: "h", default: false },
+    "no-open": { type: "boolean", default: false },
+  },
+  strict: false,
+});
+
+if (values.help) {
+  const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+  const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+  const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+  console.log(`${bold("piclaw")} ${dim("— multi-channel chat bot orchestrator")}
+
+${bold("Usage:")} ${cyan("piclaw")} [options]
+
+${bold("Options:")}
+  ${cyan("--no-open")}  Do not open the browser on start
+  ${cyan("-h, --help")} Show this help message`);
+  process.exit(0);
+}
+
 globalThis.__piclaw_start_time__ = performance.now();
 
 console.log(
@@ -7,4 +37,12 @@ console.log(
 
 const { startServer } = await import("../.output/server/index.mjs");
 
-startServer();
+const server = await startServer();
+
+// Open browser
+if (server.url && !values["no-open"]) {
+  const { exec } = await import("node:child_process");
+  const cmd =
+    process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open2";
+  exec(`${cmd} ${server.url}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "piclaw",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "bin": {
     "piclaw": "./bin/piclaw.mjs"
   },
@@ -14,7 +14,6 @@
     "build": "vite build",
     "fmt": "oxlint . --fix && oxfmt .",
     "lint": "oxlint . && oxfmt --check .",
-    "prepack": "pnpm build",
     "start": "pnpm build && ./bin/piclaw.mjs",
     "test": "pnpm lint && pnpm typecheck",
     "release": "pnpm build && changelogen --release --push",
@@ -24,33 +23,37 @@
     "@fontsource-variable/geist": "^5.2.8",
     "@fontsource-variable/geist-mono": "^5.2.7",
     "@iconify/vue": "^5.0.0",
-    "@mariozechner/pi-coding-agent": "^0.55.3",
+    "@mariozechner/pi-ai": "^0.55.4",
+    "@mariozechner/pi-coding-agent": "^0.55.4",
     "@tailwindcss/vite": "^4.2.1",
     "@types/node": "^25.3.3",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
     "@typescript/native-preview": "latest",
-    "@visual-json/core": "^0.1.0",
-    "@visual-json/react": "^0.1.0",
+    "@visual-json/core": "^0.3.0",
+    "@visual-json/vue": "^0.3.0",
     "@vitejs/plugin-vue": "^6.0.4",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "changelogen": "^0.6.2",
     "geist": "^1.7.0",
+    "just-bash": "^2.11.6",
+    "md4x": "^0.0.12",
     "mime": "^4.1.0",
-    "modern-monaco": "^0.3.8",
-    "nitro": "npm:nitro-nightly@latest",
+    "modern-monaco": "^0.4.0",
+    "nitro": "latest",
     "node-pty": "1.2.0-beta.11",
     "obuild": "^0.4.31",
-    "oxfmt": "^0.35.0",
-    "oxlint": "^1.50.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "oxfmt": "^0.36.0",
+    "oxlint": "^1.51.0",
     "srvx": "^0.11.8",
     "tailwindcss": "^4.2.1",
     "vite": "beta",
     "vitest": "^4.0.18",
     "vue": "^3.5.29"
   },
+  "resolutions": {
+    "@visual-json/core": "^0.3.0",
+    "nitro": "npm:nitro-nightly@latest",
+    "vite": "beta"
+  },
   "packageManager": "pnpm@10.30.3"
 }