Jeeves Server 🎩

Turn AI-authored documents into business-ready deliverables.

A self-hosted file browser, document viewer, and webhook gateway. Author documents in Markdown with your AI assistant, then share them as beautifully rendered pages, PDFs, or Word documents — no friction, no external dependencies.

Packages

This is a monorepo with two published packages:

Package	Description
@karmaniverous/jeeves-server	The server — file browser, document renderer, export engine, event gateway
@karmaniverous/jeeves-server-openclaw	OpenClaw plugin — gives AI agents tools for browsing, sharing, and exporting

Quick Start

# Install globally
npm install -g @karmaniverous/jeeves-server

# Create a config file (JSON only)
# See guides/setup.md for full config reference
mkdir -p jeeves-server
cat > jeeves-server/config.json << 'EOF'
{
  "chromePath": "/usr/bin/chromium-browser",
  "auth": {
    "modes": ["keys"]
  },
  "keys": {
    "_internal": "generate-a-random-hex-string",
    "primary": "another-random-hex-string"
  }
}
EOF

# Start the server (default port: 1934)
jeeves-server start

Generate key seeds with:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Features

• File Browser — Navigate drives and directories through a modern React UI, with directory item counts
• Markdown Rendering — Prose with collapsible TOC sidebar, collapsible frontmatter, adjustable reading width, dark/light themes
• CSV Table Rendering — .csv files render as HTML tables with a Rendered/Raw tab
• PDF & DOCX Export — One-click, perfectly rendered, business-ready
• Code Highlighting — Syntax highlighting with copy buttons
• SVG, Mermaid & PlantUML Diagrams — Rendered inline with pan/zoom; Mermaid is bundled, PlantUML uses a fallback pipeline (local jar → private servers → community server)
• Embedded Diagrams in Markdown — mermaid and plantuml fenced code blocks render as inline SVGs
• Secure Sharing — Expiring links with HMAC signatures, scoped access
• Named Access Scopes — Define reusable scope policies, reference them by name across insiders and keys
• Event Gateway — Webhook receiver with JSON Schema validation and durable queue
• Semantic Search — Full-text search via jeeves-watcher integration
• OpenClaw Plugin — AI agents can browse, share, export, and query server status via tools
• CLI — start, status, config [jsonpath], config validate, config apply, init, service install/start/stop/restart
• Zero CDN — All assets served locally, no external dependencies

Configuration

Jeeves Server uses JSON-only configuration. The config file follows the path convention <configDir>/jeeves-server/config.json. Legacy paths (jeeves-server.config.json) are auto-migrated on first use.

# Generate a starter config
jeeves-server init --config /path/to/config-dir

# Or specify explicitly
jeeves-server start --config /path/to/jeeves-server/config.json

Configuration is validated at startup against a Zod 4 schema. The schema in packages/service/src/config/schema.ts is the single source of truth.

Environment variable substitution: Use ${VAR_NAME} in string config values and they'll be replaced from process.env at load time.

See the Setup & Configuration guide for full details.

CLI

# Start the server
jeeves-server start [--config <path>]

# Query running server status
jeeves-server status

# Query resolved configuration (supports JSONPath)
jeeves-server config [jsonpath] [--config <path>]

# Validate configuration
jeeves-server config validate [--config <path>]

# Apply a config patch to the running server
jeeves-server config apply [--config <path>]

# Generate a starter config file
jeeves-server init [--config <path>]

# Service management (executes directly — NSSM on Windows, systemd on Linux)
jeeves-server service install [--config <path>] [--name <service-name>]
jeeves-server service uninstall [--name <service-name>]
jeeves-server service start|stop|restart|status [--name <service-name>]

Guides

• Setup & Configuration — Installation, auth modes, config structure, named scopes
• Insiders, Outsiders & Sharing — Access model, share links, key derivation, expiry, rotation
• Exporting & Downloads — PDF, DOCX, SVG, PNG, and ZIP export
• Event Gateway — Webhook receiving, JSON Schema matching, body mapping, durable queue
• Deployment — Running as a service, reverse proxy, HTTPS, updates
• API & Integration — Endpoint reference, path conversion, share link generation
• OpenClaw Integration — Plugin installation, configuration, tool reference

Platform Support

• Windows: File browser auto-discovers drive letters (A–Z). Chrome path defaults to Program Files.
• Linux: File browser uses configurable roots (e.g. { home: '/home', projects: '/opt/projects' }). Chromium path is typically /usr/bin/chromium-browser.

Both platforms are tested in CI (GitHub Actions on Ubuntu, Node 22+). Node.js 22 or later is required.

Development

git clone https://github.com/karmaniverous/jeeves-server.git
cd jeeves-server
npm install

# Build everything
npm run build

# Run all checks
npm run typecheck
npm run lint
npm test
npm run knip

The monorepo uses npm workspaces. The dev server runs on port 19340 by default.

License

BSD-3-Clause

---

Built for you with ❤️ on Bali by Jason Williscroft & Jeeves.