Configuration

Config files

File	What
~/.usebrowser/CLAUDE.md	App-managed agent instructions — see details
~/.usebrowser/CLAUDE.user.md	Your personal instructions — never overwritten by updates
~/.usebrowser/drawer.json	AI Drawer URL, name, and focus JS
~/.usebrowser/.mcp.json	MCP server connection (localhost:9225 by default)

Data directories

Path	What
~/.usebrowser/data/skills/	Your skill library (ubs: prefix)
~/.usebrowser/data/artifacts/	MCP tool outputs (screenshots, JSON, HAR)
~/.usebrowser/data/recordings/	Recording sessions from /ub:record
~/.usebrowser/bin/	Helper tools (ub-render for terminal output)
~/.usebrowser/docs/	Reference docs loaded by CLAUDE.md (extraction patterns, browser patterns, crypto skills)
~/.usebrowser/scratchpad/	Temporary working files

Drawer configuration

The AI Drawer (Cmd+/) loads the URL specified in drawer.json:

{
  "url": "https://claude.ai",
  "name": "Claude",
  "focus_js": "(function(){var e=document.querySelector('div.tiptap.ProseMirror[role=\"textbox\"]');if(e){e.click();e.focus()}})()"
}

• url — which AI chat to load (Claude, ChatGPT, Gemini, or any URL)
• name — display name in the drawer header
• focus_js — JavaScript to focus the chat input when the drawer opens (optional, varies by site)

MCP connection

The MCP server starts automatically with the browser. The default config:

{
  "mcpServers": {
    "usebrowser": {
      "type": "sse",
      "url": "http://localhost:9225/sse"
    }
  }
}

External agents can connect to the same endpoint. See MCP Overview for details.