JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 31
  • Score
    100M100P100Q79983F
  • License MIT

CLI for the Dassi Chrome extension — run browser automation from the terminal

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dassi_ai/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    dassi-cli

    Standalone CLI for the Dassi Chrome extension — run browser automation from the terminal.

    Installation

    # Zero-install
npx dassi-cli --help

# Or install globally
npm install -g dassi-cli

    Or, for local development from a clone of this repo:

    cd cli
npm install
npm link    # exposes `dassi` on PATH

    Prerequisites

    • Node.js >= 20.11.1
    • Dassi Chrome extension installed and running
    • External Bridge enabled in Dassi Options (options.html?dev)

    Usage

    # List all open Chrome tabs
dassi list-tabs

# Run an agent prompt on a specific tab
dassi run "summarize the top issues" --tab 456

# Run with a timeout (ms)
dassi run "check inbox" --tab 123 --timeout 60000

# Send a raw JSON command
dassi raw '{"id":"1","action":"list_tabs"}'

# Output as JSON (for scripting)
dassi list-tabs --json

# Use a named session
dassi list-tabs --session work

# Show version / help
dassi --version
dassi --help

    Tab groups

    # List all tab groups
dassi list-groups

# Run agent against every tab in a group (sequential)
dassi run "summarize each page" --group 7

# Use a group title instead of id (errors if title is ambiguous)
dassi run "extract prices" --group-title "Shopping"

# Tool commands also accept --group / --group-title
dassi screenshot --group-title "Research" -o shot.png

    When --group/--group-title is used, the CLI expands to member tab ids and runs them sequentially in one daemon session. True parallel execution is not currently supported — the daemon binds a fixed WebSocket port (18790 by default, override with DASSI_BRIDGE_PORT), so multiple daemon processes can't coexist regardless of --session. Sequential dispatch is the only supported pattern.

    Claude Code Plugin

    This package also ships as a Claude Code plugin under the dassi namespace. After installation (via either npm install -g dassi-cli or npm link from this directory), Claude Code auto-discovers two skills:

    • dassi:pick-tabs — a reusable tab/group picker. Lists open tabs and Chrome tab groups, asks the user to pick, returns the selected Chrome tab IDs.
    • dassi:operate — main entry point. Translates natural-language browser asks ("summarize my Research group", "screenshot the active tab", etc.) into dassi CLI invocations.

    The plugin manifest lives at .claude-plugin/plugin.json; skill content is under skills/<name>/SKILL.md. No additional configuration is required — installing the CLI is sufficient.

    How It Works

    The CLI (dassi.mjs) auto-spawns a background daemon (dassi-daemon.mjs) that:

    • Hosts a WebSocket server on port 18790 for the Chrome extension to connect to
    • Exposes a Unix socket (~/.dassi/<session>.sock) for CLI commands via NDJSON protocol
    • Serializes concurrent run commands via a FIFO queue
    • Handles first-run onboarding (extension install detection, login flow)
    • Shuts down after 30 minutes of idle

    Dependencies

    • ws — WebSocket server for extension communication
    • open — Opens browser for onboarding/install flow

    Development

    # Run tests
npm test

    License

    MIT