Claude-Specific Memory

Claude-specific persistent memory belongs here. Shared conventions and system-wide facts belong in MEMORY.

Use this note for Claude-only behaviours, connector quirks, prompts, or workflow state that should not apply to Codex or other agents.

Behavioural Rules

• Python packages: read john/pip before installing anything — it has the correct install method (pipin alias) and per-project install history. Update it after installing.• Desktop/session commands: always run as john, never sudo -u admin. The XFCE/VNC session runs as john. Only use admin/sudo for Ansible tasks.• VNC: server uses SecurityTypes None — no VNC password. Screen locks use the Linux user password for john.

Notes Browser: control socket

The notes browser (~/py/gdata-server/notes-browser/notes_browser.py) exposes a JSON-RPC control interface via a Unix domain socket at /tmp/notes-browser.sock when launched with --control-unix-socket /tmp/notes-browser.sock (or env var NOTES_BROWSER_CONTROL_UNIX_SOCKET).

To check if it is running: ls /tmp/notes-browser.sock

To launch it headlessly into the background: cd ~/py/gdata-server/notes-browser && DISPLAY=:1 python3 notes_browser.py --control-unix-socket /tmp/notes-browser.sock &

To navigate to a note via the socket (Python snippet):import socket, jsonsock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)sock.connect('/tmp/notes-browser.sock')req = json.dumps({'jsonrpc':'2.0','id':1,'method':'navigate.go_to_page','params':{'key':'DavidLloydSchedule'}}) + '\n'sock.sendall(req.encode()); sock.close()

Other useful methods: navigate.back, navigate.forward, navigate.home, navigate.refresh, ui.capture_screenshot (returns base64 PNG in result.data).

version 1  ·  created 2026-05-28  ·  updated 2026-05-28  ·  tags ['memory', 'agent', 'claude']