cssprobe-cli 0.2.8 → 0.2.10

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.10",
       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.d.ts

@@ -1,8 +1,8 @@
 /**
- * cssprobe-cli-cli Agent Skill templates.
+ * cssprobe-cli Agent Skill templates.
  *
- * Installed into agent-specific skill directories via `cssprobe-cli-cli skill-install`.
- * Teaches agents how to use cssprobe-cli-cli for runtime CSS inspection — layout,
+ * Installed into agent-specific skill directories via `cssprobe-cli skill-install`.
+ * Teaches agents how to use cssprobe-cli for runtime CSS inspection — layout,
  * scroll, overflow, colors, backgrounds, fonts — with confidence levels.
  */
 export declare function buildSkillMd(): string;

package/dist/installer/skill-template.js

@@ -1,9 +1,9 @@
 "use strict";
 /**
- * cssprobe-cli-cli Agent Skill templates.
+ * cssprobe-cli Agent Skill templates.
  *
- * Installed into agent-specific skill directories via `cssprobe-cli-cli skill-install`.
- * Teaches agents how to use cssprobe-cli-cli for runtime CSS inspection — layout,
+ * Installed into agent-specific skill directories via `cssprobe-cli skill-install`.
+ * Teaches agents how to use cssprobe-cli for runtime CSS inspection — layout,
  * scroll, overflow, colors, backgrounds, fonts — with confidence levels.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -15,20 +15,20 @@ const BT3 = '```'; // triple backtick
 function buildSkillMd() {
     return [
         FRONTMATTER_DELIM,
-        'name: cssprobe-cli-cli',
+        'name: cssprobe-cli',
         'description: >',
-        '  Runtime CSS probe for layout/scroll/overflow inspection. Use cssprobe-cli-cli to',
+        '  Runtime CSS probe for layout/scroll/overflow inspection. Use cssprobe-cli to',
         '  diagnose CSS issues in live browsers — height chains, scroll containers,',
         '  overflow, flex constraints, containing block hijacks. Produces structured',
         '  reports with DEFINITE/INDEFINITE/UNVERIFIABLE confidence levels.',
         'metadata:',
         '  requires:',
-        '    bins: ["cssprobe-cli-cli", "playwright"]',
+        '    bins: ["cssprobe-cli", "playwright"]',
         FRONTMATTER_DELIM,
         '',
-        '# cssprobe-cli-cli -- Runtime CSS Probe Skill',
+        '# cssprobe-cli -- Runtime CSS Probe Skill',
         '',
-        'Use cssprobe-cli-cli to inspect the runtime CSS of any web page. It launches a real',
+        'Use cssprobe-cli to inspect the runtime CSS of any web page. It launches a real',
         'browser, captures computed styles and DOM structure, and produces a structured',
         'report with confidence levels.',
         '',
@@ -47,9 +47,9 @@ function buildSkillMd() {
         'Do NOT memorize all commands. Use:',
         '',
         BT3 + 'bash',
-        'cssprobe-cli-cli --help                    # all commands grouped by category',
-        'cssprobe-cli-cli inspect --help            # specific command: args, options, description',
-        'cssprobe-cli-cli state-import --help       # cookie import command',
+        'cssprobe-cli --help                    # all commands grouped by category',
+        'cssprobe-cli inspect --help            # specific command: args, options, description',
+        'cssprobe-cli state-import --help       # cookie import command',
         BT3,
         '',
         '## Core Workflow: Inspect a Page',
@@ -83,11 +83,10 @@ function buildSkillMd() {
         '### Option B: Interactive login',
         '',
         BT3 + 'bash',
-        'cssprobe-cli login https://mysite.com',
-        '# Browser opens -> complete login manually -> press Enter',
-        '# State saved to ~/.cssprobe-cli/states/mysite.com.json',
+        'cssprobe-cli open https://mysite.com --headed',
+        '# Browser opens -> complete login manually -> continue inspection',
         '',
-        'cssprobe-cli inspect https://mysite.com/page ".target" --state ~/.cssprobe-cli/states/mysite.com.json',
+        'cssprobe-cli inspect .target',
         BT3,
         '',
         '### Option C: Merge cookies into existing state',
@@ -182,6 +181,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 +224,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/docs/guide/installation.md

@@ -108,15 +108,10 @@ cssprobe-cli inspect https://mysite.com/page ".target" --state ~/.cssprobe-cli/s
 ### Option B: Interactive Login
 
 ```bash
-cssprobe-cli login https://mysite.com
-# Browser opens → complete login manually → press Enter
-# State saved to ~/.cssprobe-cli/states/mysite.com.json
-```
-
-Then use:
+cssprobe-cli open https://mysite.com --headed
+# Browser opens -> complete login manually -> continue inspection
 
-```bash
-cssprobe-cli inspect https://mysite.com/page ".target" --state ~/.cssprobe-cli/states/mysite.com.json
+cssprobe-cli inspect .target
 ```
 
 ### Option C: Merge Cookies into Existing State
@@ -125,39 +120,36 @@ cssprobe-cli inspect https://mysite.com/page ".target" --state ~/.cssprobe-cli/s
 cssprobe-cli state-import new-cookies.txt --merge existing-state.json --out updated.json
 ```
 
-### Option D: Wait for User Interaction
-
-For pages that require clicking a button or opening a dialog before inspection:
+### Option D: Open with Saved State
 
 ```bash
-cssprobe-cli inspect https://mysite.com/page ".dialog" --state ~/.cssprobe-cli/states/mysite.json --wait
-# Browser opens -> perform actions (click, open dialog) -> press Enter -> inspect
+# Import cookies first
+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
+
+# Then inspect
+cssprobe-cli inspect .target
 ```
 
 ---
 
-## Step 5: Interactive Mode (REPL)
+## Step 5: Session Mode
 
 For inspecting multiple areas of the same page without re-opening the browser:
 
 ```bash
-cssprobe-cli interactive https://mysite.com --state ~/.cssprobe-cli/states/mysite.json
-```
+cssprobe-cli open https://mysite.com --state ~/.cssprobe-cli/states/mysite.json
 
-Runtime commands:
+# Run multiple inspections
+cssprobe-cli tree .dialog-A
+cssprobe-cli layout .sidebar-B
+cssprobe-cli findings .modal
+cssprobe-cli inspect .dialog-A --json
 
-```
-inspect> tree .dialog-A               # DOM tree
-inspect> layout .sidebar-B            # ASCII layout diagram
-inspect> sketch .content              # Tree sketch (issues only)
-inspect> findings .modal              # Findings only
-inspect> json .dialog-A               # JSON output
-inspect> report .dialog-A             # Full report
-inspect> .dialog-A                    # Shorthand for report
-inspect> navigate https://other.com   # Navigate to new URL
-inspect> depth 10                     # Set depth
-inspect> help                         # Show help
-inspect> quit                         # Exit
+# Close when done
+cssprobe-cli close
 ```
 
 ---
@@ -228,7 +220,7 @@ confidence: DEFINITE 8 | INDEFINITE 0 | UNVERIFIABLE 1
 → This is expected. Declared values from blocked sheets are marked UNVERIFIABLE. Computed values from getComputedStyle() are still accurate.
 
 **Page needs login**
-→ Use `cssprobe-cli login <url>` for interactive login, or `cssprobe-cli state-import cookies.txt` to import cookies.
+→ Use `cssprobe-cli open <url> --headed` for interactive login, or `cssprobe-cli state-import cookies.txt --name mysite` to import cookies.
 
 ---
 

package/package.json

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