Skip to content

themtok/vis-a-vis

v1.0.0+codex.20260929181739MIT

Visualise Agent, Visualise! (vis-a-vis) - a local diagram studio powered by Excalidraw with an MCP interface, so an agent can read and edit the live diagram the user has open.

GitHub

vis-a-vis plugin (Agent Plugins 1.0.0)

Agent Plugins package for vis-a-vis ("Visualise Agent, Visualise!") — the local Excalidraw diagram studio with an MCP interface.

Contents

FilePurpose
plugin.jsonPlugin manifest (Agent Plugins 1.0.0, plugin.schema.json)
mcp.jsonRegisters the vis-a-vis MCP server (Streamable HTTP)
skills/vis-a-vis/SKILL.mdAgent skill: the 8 tools, session model, edit_diagram semantics, errors

Install

Copy this vis-a-vis folder into your client's plugins directory and restart/reload the client. It registers the MCP server vis-a-vis at http://localhost:4832/mcp and installs the vis-a-vis skill for the agent.

The vis-a-vis app itself must be running locally (npm run dev, or release/vis-a-vis.exe).

Port caveat

mcp.json assumes the default port 4832. If that port is taken at startup, vis-a-vis falls back to the next free port (up to 4852) — see the boot log (vis-a-vis listening on http://localhost:<port>/) or call get_app_url. In that case update the url in mcp.json (or your client's server config) accordingly, or pin a port with the VIS_A_VIS_PORT environment variable.