Skip to content

Cachebro fails to initialize on Windows #9

@SquareHatLtd

Description

@SquareHatLtd

Error: EACCES: permission denied, mkdir...
[Error: failed to open database: Invalid argument supplied: experimental multiprocess WAL is not supported by the active IO backend]

Environment

  • OS: Windows 11 x64
  • Node.js: v20.20.2
  • cachebro: v0.2.2
  • Attempted: Native Windows, WSL2 Ubuntu

Expected Behavior

Cachebro should initialize and run on Windows without WAL-related errors, or gracefully fall back to a compatible journal mode.

Current Behavior

Database initialization fails due to Turso's SQLite implementation using "experimental multiprocess WAL mode" which isn't supported by the Windows IO backend.

Attempted Solutions

  1. Running natively on Windows → WAL error
  2. Running in WSL2 Ubuntu → Works, but MCP stdio transport can't reach it from Windows clients

Request

Please either:

  • Add Windows-compatible SQLite configuration (disable multiprocess WAL on Windows)
  • Add --no-wal or --journal-mode flag to override WAL mode
  • Document Windows limitations and recommend WSL2 with HTTP transport

This would enable Windows developers using Claude Code/Cursor to use cachebro locally.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions