Repo brief: defunkt/dotjs

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T21:41:18.120Z · commit 434eaba374b0

Verdict

Mixed — Stale — last commit 8y ago

• 30+ active contributors
• MIT licensed

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

dotjs is a macOS-only Chrome extension that automatically executes user-written JavaScript files from ~/.js against websites based on domain matching. When you visit google.com, it loads and runs ~/.js/google.com.js; for subdomains like gist.github.com, it tries gist.github.com.js, github.com.js, and com.js in sequence. It includes jQuery 1.9 by default and runs a Ruby web server on localhost:3131 to serve these files to the extension. Simple two-tier architecture: (1) Ruby backend (bin/djsd) runs a tiny web server on port 3131 serving files from ~/.js. (2) Chrome extension (ext/manifest.json, ext/dotjs.js) injects jQuery and makes AJAX requests to localhost:3131 to fetch and…

Start here

Open these first:

• ext/manifest.json — Chrome extension manifest that defines permissions, content scripts, and extension metadata—required for the extension to…
• ext/dotjs.js — Core content script that executes user JavaScript files from ~/.js based on domain matching logic—the heart of the extension.
• bin/djsd — Daemon script that serves JavaScript files from ~/.js directory to the extension—handles local file serving and…
• ext/jquery.js — jQuery 1.9 dependency bundled with extension to ensure jQuery is available in all injected scripts regardless of site…
• README.markdown — Documents the core concept, usage patterns, and subdomain resolution logic that inform how the extension matches domains to…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/defunkt/dotjs
cd dotjs
rake install

Then open https://localhost:3131 in Chrome, manually trust the self-signed certificate via Keychain, and install the extension from the Chrome Web Store (http://bit.ly/dotjs). Requires macOS, Ruby, rake, and Google Chro…

Daily commands:

The Rakefile contains install/uninstall targets. Post-install, the LaunchAgent (~/Library/LaunchAgents/com.github.dotjs.plist) auto-starts the Ruby server. Manual start: ruby bin/djsd. The extension communicates with…

…shortened for this brief.

Key cautions & unknowns

• Stale — last commit 8y ago
• Concentrated ownership — top contributor handles 56% of recent commits
• (1) Self-signed certificate required: Ruby server uses HTTPS on port 3131 with a self-signed cert; you must manually trust it in macOS Keychain or the extension will fail silently. (2) macOS LaunchAgent path:…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.