Managed runtimes
Start, stop, restart and test connections. State survives conversation changes and is projected into the right-sidebar panel.
DEEPSEEK HARNESS · CADENCE VIRTUOSO
Your agent's hands inside Virtuoso.
The DeepSeek Harness plugin around Virtuoso Bridge, the upstream tool that connects an agent to a Cadence Virtuoso CIW. This plugin deploys that bridge in one click — isolated venv, pinned source, CIW daemon setup — and keeps it live across sessions: conversations, forks and subagents share one managed tunnel and daemon, and automatic-session discovery picks the right instance or workdir.
WHAT THE PLUGIN OWNS
Runtimes, tunnels, daemons and the isolated Python environment are managed by the Host half of the plugin. Every conversation, fork and subagent in the profile talks to the same live bridge.
Start, stop, restart and test connections. State survives conversation changes and is projected into the right-sidebar panel.
Describe and call any public virtuoso-bridge target — schematic, layout, library, Maestro, dialogs, Spectre — without plugin wrappers.
Run Python in a fresh venv process with the connected client, jobs, progress and cancellation. A bad batch cannot break the connection.
Warnings and *Error* lines printed during a call come back with the result, so a quiet failure is not silent.
FOUR TOOLS, ONE BRIDGE
The tools are registered on the Host and are available in every conversation of the profile. Long work becomes a job; a big answer becomes a file the agent can grep.
Status, start, stop, restart, ping, instance discovery, daemon deployment, host-key trust and connection edits.
virtuoso_bridge_runtime action=status virtuoso_bridge_runtime action=start connection=lab
Three zoom levels over the installed bridge: target index, one target's methods, one method's full documentation. Then invoke it.
virtuoso_bridge_api action=describe target=client.layout virtuoso_bridge_api action=call target=client method=execute_skill
Inline code or a workspace file, one job per run, with connect(), emit() and a persisted result.
client = connect()
result = {"windows": client.schematic.list_windows()}
Install, update, diagnose, switch source mode and clear caches, with the install log kept in the configuration page.
virtuoso_bridge_setup action=status virtuoso_bridge_setup action=diagnose
THE AGENTIC LOOP
The plugin is deliberately not another runner, job store, dialog manager or scheduler. It exposes the bridge, and the bridge owns the logic.
One status call reports setup, tunnel, daemon, instance, attached agents and running actions.
The installed bridge is the source of truth; describe it before calling instead of guessing a signature.
One larger script beats many round trips. Point path at a file you can edit and rerun.
The returned block carries warnings and errors from the shared transcript — read it before guessing why nothing happened.
FIRST RUN
The npm package carries the pinned bridge source, so an install needs neither git nor the submodule checkout. Python 3.9+ and OpenSSH are the only local prerequisites worth checking first.
@nekomona/dsh-virtuoso-bridge through the plugin manager.load("...") line in the CIW; the health poll flips the runtime to running.load("/home/username/.virtuoso-bridge/daemon/virtuoso_setup.il")
virtuoso_bridge_runtime({ action: "status" })
virtuoso_bridge_api({
action: "call", target: "client", method: "execute_skill",
args: ["1+1"], description: "Check the daemon answers"
})
DOCUMENTATION
Every chapter is self-contained and links back to the canonical Markdown in the repository.
Requirements, install from npm or a checkout, the venv, and the first running daemon.
Read → 02 · NETWORKFixed ports versus automatic sessions, host keys, sub-instances, credentials and daemon deployment.
Read → 03 · APIEvery action and argument of the four tools, with the answer shapes the agent sees.
Read → 04 · PRACTICEDurable Maestro runs, dialog inspection, history conflicts, CIW diagnostics and failure rules.
Read → 05 · ARCHITECTUREStates, the Host-owned SSH tunnel, health polling, environment isolation and cache layout.
Read → 06 · OPERATIONSWaiting, trust, blocked dialogs, legacy daemons, deployment conflicts and security notes.
Read →Ask the agent to install the bundle, then let it read the bridge instead of guessing it.
Open the guide →