cssprobe-cli 0.2.8 → 0.2.9

package/AGENTS.md

@@ -56,6 +56,7 @@ src/
 ### Session Management
 - `open [url]` — Open browser in session mode (non-blocking)
   - `--viewport <WxH>` — Set viewport size (e.g. `--viewport 1280x720`)
+  - `--state <file>` — Load saved state (cookies + localStorage)
 - `close` — Close the browser session
 - `status` — Show current session status
 
@@ -76,6 +77,9 @@ src/
 
 ### State
 - `state-import [file]` — Import cookies from Netscape format
+  - `--out <file>` — Output state file path (default: `~/.cssprobe-cli/states/imported.json`)
+  - `--name <name>` — Custom name for the state file (e.g. `mysite` or `mysite.json`)
+  - `--merge <file>` — Existing state file to merge into
 
 ### Config
 - `config-show` / `config-set` / `config-list` / `config-use` / `config-new` / `config-path`

package/README.md

@@ -71,6 +71,12 @@ cssprobe-cli close
 ```bash
 # Import cookies from browser export (Netscape format)
 cssprobe-cli state-import cookies.txt --out ~/.cssprobe-cli/states/mysite.json
+
+# Or use --name for simpler syntax
+cssprobe-cli state-import cookies.txt --name mysite
+
+# Open browser with saved state
+cssprobe-cli open https://mysite.com --state ~/.cssprobe-cli/states/mysite.json
 ```
 
 ### 4. JSON Output
@@ -117,6 +123,7 @@ cssprobe-cli close
 ```bash
 cssprobe-cli open [url]           # Open browser in session mode (non-blocking)
 cssprobe-cli open [url] --viewport 1280x720  # Open with custom viewport
+cssprobe-cli open [url] --state ~/.cssprobe-cli/states/mysite.json  # Open with saved state
 cssprobe-cli close                # Close browser session
 cssprobe-cli status               # Show session status
 ```
@@ -214,6 +221,9 @@ Import cookies from Netscape format (browser export standard) into a Playwright
 # From file
 cssprobe-cli state-import cookies.txt --out mystate.json
 
+# From file with custom name (saves to ~/.cssprobe-cli/states/<name>.json)
+cssprobe-cli state-import cookies.txt --name mysite
+
 # From stdin
 cat cookies.txt | cssprobe-cli state-import --out mystate.json
 

package/dist/cli/commands.js

@@ -56,6 +56,7 @@ const open = (0, command_1.declareCommand)({
         browser: z.enum(['chromium', 'firefox', 'webkit']).optional().describe('browser engine (default chromium)'),
         headed: z.boolean().optional().describe('show the browser window'),
         viewport: z.string().optional().describe('viewport size as WxH (e.g. 1280x720)'),
+        state: z.string().optional().describe('path to saved state file (cookies + localStorage)'),
     }),
 });
 const close = (0, command_1.declareCommand)({
@@ -162,6 +163,7 @@ const stateImport = (0, command_1.declareCommand)({
     }),
     options: z.object({
         out: z.string().optional().describe('output state file path (default: ~/.cssprobe-cli/states/imported.json)'),
+        name: z.string().optional().describe('custom name for the state file (e.g. mysite or mysite.json)'),
         merge: z.string().optional().describe('existing state file to merge into'),
     }),
 });

package/dist/cli/program.js

@@ -112,6 +112,7 @@ async function handleOpen(command, args, output) {
         const browser = parsed.browser || 'chromium';
         const headed = !!parsed.headed;
         const viewportStr = parsed.viewport;
+        const state = parsed.state;
         // Parse viewport
         let viewport;
         if (viewportStr) {
@@ -133,6 +134,7 @@ async function handleOpen(command, args, output) {
             browser,
             headed,
             viewport,
+            state,
             _: ['open', url],
         }, 'open');
         // Wait a bit for daemon to start
@@ -394,7 +396,16 @@ async function handleStateImport(command, args, output) {
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
         const filePath = parsed.file;
-        const outPath = parsed.out || path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', 'imported.json');
+        const name = parsed.name;
+        let outPath = parsed.out;
+        if (!outPath && name) {
+            // Use custom name in default states directory
+            const fileName = name.endsWith('.json') ? name : `${name}.json`;
+            outPath = path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', fileName);
+        }
+        else if (!outPath) {
+            outPath = path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', 'imported.json');
+        }
         const mergePath = parsed.merge;
         let content;
         if (filePath) {

package/dist/daemon/daemon.d.ts

@@ -11,5 +11,6 @@ export interface DaemonOptions {
         width: number;
         height: number;
     };
+    state?: string;
 }
 export declare function startDaemon(sessionName: string, clientInfo: ClientInfo, options: DaemonOptions): Promise<string>;

package/dist/daemon/daemon.js

@@ -34,6 +34,7 @@ async function startDaemon(sessionName, clientInfo, options) {
         browser: options.browser || 'chromium',
         headed: options.headed !== false,
         viewport: options.viewport,
+        state: options.state,
     });
     const server = net_1.default.createServer(socket => {
         const connection = new socketConnection_1.SocketConnection(socket);

package/dist/daemon/daemonEntry.js

@@ -12,6 +12,7 @@ const sessionName = args[0] || 'default';
 const options = {
     headed: args.includes('--headed'),
     browser: args.find(a => a.startsWith('--browser='))?.split('=')[1],
+    state: args.find(a => a.startsWith('--state='))?.split('=')[1],
 };
 async function main() {
     try {

package/dist/daemon/session.js

@@ -84,6 +84,8 @@ class Session {
             daemonArgs.push('--headed');
         if (args.browser)
             daemonArgs.push(`--browser=${args.browser}`);
+        if (args.state)
+            daemonArgs.push(`--state=${args.state}`);
         const child = require('child_process').spawn(process.execPath, daemonArgs, {
             detached: true,
             stdio: ['ignore', 'pipe', err],

package/dist/daemonEntry.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "cssprobe-cli",
-      version: "0.2.8",
+      version: "0.2.9",
       description: "Runtime CSS probe \u2014 inspect layout, colors, backgrounds, fonts and more in a live browser. AI agents and shell automation.",
       keywords: [
         "css",
@@ -1184,7 +1184,8 @@ async function startDaemon(sessionName2, clientInfo, options2) {
   const launcher = new BrowserLauncher({
     browser: options2.browser || "chromium",
     headed: options2.headed !== false,
-    viewport: options2.viewport
+    viewport: options2.viewport,
+    state: options2.state
   });
   const server = import_net.default.createServer((socket) => {
     const connection = new SocketConnection(socket);
@@ -1452,7 +1453,8 @@ var args = process.argv.slice(2);
 var sessionName = args[0] || "default";
 var options = {
   headed: args.includes("--headed"),
-  browser: args.find((a) => a.startsWith("--browser="))?.split("=")[1]
+  browser: args.find((a) => a.startsWith("--browser="))?.split("=")[1],
+  state: args.find((a) => a.startsWith("--state="))?.split("=")[1]
 };
 async function main() {
   try {

package/dist/help.json

@@ -2,11 +2,12 @@
   "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
   "commands": {
     "open": {
-      "help": "cssprobe-cli open [url]\n\nOpen browser in session mode (non-blocking)\n\nArguments:\n  [url]                       url, file:// path, or local html file path\nOptions:\n  --browser                   browser engine (default chromium)\n  --headed                    show the browser window\n  --viewport                  viewport size as wxh (e.g. 1280x720)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "help": "cssprobe-cli open [url]\n\nOpen browser in session mode (non-blocking)\n\nArguments:\n  [url]                       url, file:// path, or local html file path\nOptions:\n  --browser                   browser engine (default chromium)\n  --headed                    show the browser window\n  --viewport                  viewport size as wxh (e.g. 1280x720)\n  --state                     path to saved state file (cookies + localstorage)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
       "flags": {
         "browser": "string",
         "headed": "boolean",
-        "viewport": "string"
+        "viewport": "string",
+        "state": "string"
       },
       "args": [
         "url"
@@ -94,9 +95,10 @@
       "args": []
     },
     "state-import": {
-      "help": "cssprobe-cli state-import [file]\n\nImport cookies from Netscape format file\n\nArguments:\n  [file]                      netscape cookie file path (reads from stdin if omitted)\nOptions:\n  --out                       output state file path (default: ~/.cssprobe-cli/states/imported.json)\n  --merge                     existing state file to merge into\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "help": "cssprobe-cli state-import [file]\n\nImport cookies from Netscape format file\n\nArguments:\n  [file]                      netscape cookie file path (reads from stdin if omitted)\nOptions:\n  --out                       output state file path (default: ~/.cssprobe-cli/states/imported.json)\n  --name                      custom name for the state file (e.g. mysite or mysite.json)\n  --merge                     existing state file to merge into\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
       "flags": {
         "out": "string",
+        "name": "string",
         "merge": "string"
       },
       "args": [

package/dist/installer/skill-template.js

@@ -182,6 +182,9 @@ function buildSkillMd() {
         '# From file',
         'cssprobe-cli state-import cookies.txt --out mystate.json',
         '',
+        '# From file with custom name (saves to ~/.cssprobe-cli/states/<name>.json)',
+        'cssprobe-cli state-import cookies.txt --name mysite',
+        '',
         '# From stdin',
         'cat cookies.txt | cssprobe-cli state-import --out mystate.json',
         '',
@@ -222,7 +225,7 @@ function buildSkillMd() {
         '',
         BT3 + 'bash',
         '# Import cookies first',
-        'cssprobe-cli state-import exported-cookies.txt --out ~/.cssprobe-cli/states/app.json',
+        'cssprobe-cli state-import exported-cookies.txt --name app',
         '',
         '# Then inspect with state',
         'cssprobe-cli inspect https://app.example.com/dashboard ".main-panel" --state ~/.cssprobe-cli/states/app.json',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cssprobe-cli",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Runtime CSS probe — inspect layout, colors, backgrounds, fonts and more in a live browser. AI agents and shell automation.",
   "keywords": [
     "css",