@hunterzhu/pulse-cli 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,55 @@
+# @hunterzhu/pulse-cli
+
+**A local-first AI assistant for coding, research, and everyday file tasks.**
+
+Pulse runs in your project folder, keeps conversations on your machine, and can resume unfinished work. Requires Node.js 22+.
+
+## Install
+
+Install the CLI globally so the `pulse` command is on your `PATH`:
+
+```bash
+npm install -g @hunterzhu/pulse-cli
+pulse --version
+```
+
+For a one-off run, use `npx @hunterzhu/pulse-cli`. Commands below assume a global installation.
+
+## Configure a model and API key
+
+Create a starter configuration:
+
+```bash
+pulse setup
+```
+
+The configuration lives at `~/.pulse/config.json` (Windows:
+`%USERPROFILE%\.pulse\config.json`). A fresh configuration includes the DeepSeek
+provider and `deepseek-chat` model. Set `activeModel` to `deepseek-chat`, or use
+`--model deepseek-chat` as below. The default `mock` model makes no API calls.
+
+Set the API key in your shell; the DeepSeek provider uses
+`apiKeyEnv: "DEEPSEEK_API_KEY"` to read it:
+
+```bash
+export DEEPSEEK_API_KEY="your-key"
+# Windows PowerShell: $env:DEEPSEEK_API_KEY="your-key"
+```
+
+## Usage
+
+```bash
+pulse --model deepseek-chat                        # interactive session
+pulse run "Summarize this project" --model deepseek-chat
+pulse sessions
+pulse resume <conversation-id> "Continue" --model deepseek-chat
+pulse doctor
+pulse --read-only
+```
+
+See `pulse --help` for all options.
+
+## Links
+
+- [Full CLI configuration guide](https://github.com/zhuhengtan/Pulse/blob/main/docs/cli-config.md)
+- [Source code and documentation](https://github.com/zhuhengtan/Pulse)

package/dist/bin.js

@@ -314,6 +314,7 @@ export async function hostOptions(parsed) {
         ...(configuredMaxTurns === undefined ? {} : { maxTurns: configuredMaxTurns }),
         ...(configuredAutoCompactPercent === undefined ? {} : { autoCompactPercent: Math.min(90, configuredAutoCompactPercent) }),
         ...(allowNetwork === undefined ? {} : { allowNetwork }),
+        ...(config.networkHosts === undefined ? {} : { networkHosts: config.networkHosts }),
         executionMode,
     };
 }

package/dist/components/App.js

@@ -183,6 +183,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
                     maxTurns: hostOptions.maxTurns ?? 32,
                     autoCompactPercent: hostOptions.autoCompactPercent ?? 90,
                     allowNetwork: hostOptions.allowNetwork ?? false,
+                    networkHosts: hostOptions.networkHosts ?? [],
                 }, null, 2),
                 createdAt: new Date().toISOString(),
             });

package/dist/config.d.ts

@@ -74,6 +74,8 @@ export interface PulseCliConfig {
     maxTurns?: number;
     /** Percent of maxContextTokens that triggers automatic history compaction. Clamped to 1–90. */
     autoCompactPercent?: number;
+    /** Explicit network destinations; workspace configuration cannot grant these. */
+    networkHosts?: string[];
     allowNetwork?: boolean;
 }
 export declare const defaultPulseConfig: PulseCliConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A local-first AI task assistant for coding, research, and file workflows.",
   "keywords": [
     "ai",
@@ -35,7 +35,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.2.0",
+    "@hunterzhu/pulse-server": "0.2.1",
     "chalk": "^5.4.1",
     "highlight.js": "^11.10.0",
     "ink": "^7.1.1",