@lucamattiazzi/sommelier
v0.2.0-beta.1
Published
Encrypted Excel bridge, native coding-harness adapters, MCP tools and local trace subscriptions
Readme
@lucamattiazzi/sommelier
sommelier connects Codex, OpenCode or Claude Code to the Excel Sommelier TaskPane. Requires
Node.js 22.12+ and a signed-in harness. The included skill, bridge and crypto are self-contained.
npm install -g @lucamattiazzi/sommelier@beta
sommelier pair --name desk
sommelier codex --name desk
# Or: opencode --name desk
# Or: claude --name desk (Channels research preview; local consent required)
sommelier list
sommelier trace --name desk --out run.jsonlSommelier asks for the private TaskPane URL once; subsequent starts use the saved profile and native
conversation, including the selected hosted or self-hosted Sommelier instance. End users do not start
a Sommelier relay. OpenCode's local harness API starts automatically on an authenticated loopback port
and stops with the adapter. Optional --server attaches an API you already manage instead.
Claude must stay open. The Codex adapter
starts App Server, not an arbitrary existing TUI. Native Codex command/file approvals are declined;
Excel writes/charts retain their TaskPane approval flow.
Public exports bridgeCommand and subscribeBridge allow local tool/eval integrations. Trace
payloads are excluded by default; includeContent: true opts in. Never commit full traces or saved
profiles. A timeout never causes mutation replay. Slow trace listeners cannot block the workbook.
sommelier-relay relay --port 4310 remains the legacy plaintext loopback relay; the native adapters
require encrypted /connect profiles from the hosted Sommelier relay instead.
