English · 简体中文

ADS Agent Bridge

Give AI agents a safe, local, and version-aware way to understand and operate Keysight ADS.

ADS Agent Bridge is an unofficial, local-first documentation and automation bridge for Keysight Advanced Design System (ADS). It turns the ADS installation already on your machine into a version-aware documentation source, a bounded runtime context, and a safely managed automation target for general-purpose Agents such as Codex or OpenCode.

The Agent may run on the ADS host or execute ads-agent there over SSH. Live bridge endpoints remain bound to loopback on the ADS host; the package does not open ADS directly to the network.

[!IMPORTANT] This project is a public alpha. Use disposable workspaces for first trials and review the reported capability gates before relying on automation results. Keysight and ADS are trademarks of Keysight Technologies. This project is not affiliated with or endorsed by Keysight.

What it does

The initial release is deliberately small, but it is not a dummy wrapper: docs, no-GUI automation, live DE/DDS context, dialog supervision, and session lifecycle are separate, observable capability lanes.

Quick start

Prerequisites:

• a locally licensed ADS installation;
• Python 3.10 or later for the ads-agent command;
• Windows or Linux.

Install and prove the local setup:

pipx install ads-agent-bridge
ads-agent doctor
ads-agent setup
ads-agent quickstart

setup discovers installed ADS versions instead of hard-coding one release. quickstart passes only after documentation indexing and query, add-on registration, disposable workspace creation, circuit simulation, and dataset readback all pass.

Launch a real workspace only after that gate succeeds:

ads-agent --pretty launch --workspace /path/to/MyWorkspace_wrk
ads-agent --pretty status
ads-agent disconnect                 # ADS keeps running
ads-agent shutdown                   # native exit for an agent-owned session

On Linux, bind GUI work to the intended display:

ads-agent --pretty launch --workspace /path/to/MyWorkspace_wrk --display :4

curl -fsSLO https://github.com/cottman99/ads-agent-bridge/releases/download/v0.1.0a28/install.sh
sh install.sh

Invoke-WebRequest https://github.com/cottman99/ads-agent-bridge/releases/download/v0.1.0a28/install.ps1 -OutFile install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

Remote use over SSH

SSH is the recommended current remote boundary. Run the public CLI on the ADS host instead of exposing the embedded Bridge port:

ssh ads-host 'ads-agent doctor'
ssh ads-host 'ads-agent --pretty status'
ssh ads-host 'ads-agent --pretty launch --workspace /path/to/MyWorkspace_wrk --display :4'

This keeps session files, random tokens, process ownership, workspaces, and ADS itself on the same host. A direct local-client-to-remote-Bridge protocol and multi-client lease model are not yet part of the public contract.

How it works

The package has three main execution lanes:

1. Knowledge: the portable Docs Skill routes questions through the CLI to the selected installation's private, version-scoped local index, which returns matched content and source evidence.
2. Live ADS: the Session Manager coordinates the packaged ADS Agent Bridge plug-in installed inside DE or DDS. Its loopback, token-authenticated endpoint verifies the exact workspace, process, display, slot, profile, and ownership identity.
3. No-GUI automation: the selected ADS Python runtime creates a disposable example, simulates it, and reads the dataset without opening an ADS window.

On Linux, ADS Python can still require an available X display for runtime initialization. For isolation, keep the real user HOME so ADS can see its per-user state, and isolate Bridge state with ADS_AGENT_HOME.

Safety and privacy

• Documentation, indexes, workspaces, session tokens, and automation results remain local unless the user deliberately moves them.
• Bridge endpoints listen on loopback and use a random token per session.
• Reusing a session requires the selected ADS instance and exact workspace to match; the Bridge does not silently switch workspaces.
• Context handles identify a target but do not authorize editing or simulation.
• Dialog actions are bound to a fresh process/window fingerprint instead of a product title or fixed screen coordinate.
• shutdown refuses unverified or user-owned sessions and never force-kills ADS or silently discards modified work.
• Arbitrary embedded Python and dynamic AEL calls stay disabled unless both the ADS process and the client explicitly opt into unsafe mode.

See the dialog automation contract, context interaction contract, and execution context contract for the exact boundaries.

Version support

No version is fixed into the portable Docs Skill. Multiple installed versions can be discovered and selected explicitly.

Five public examples

ads-agent --pretty examples list

The current catalog covers:

1. ADS discovery and explicit version selection;
2. no-GUI minimal-AC simulation and dataset readback;
3. read-only live DE workspace context;
4. bounded DDS dataset readback into a new native DDS file;
5. a fixed read-only AEL workspace call showing the hybrid boundary.

Every runner names its prerequisites, state changes, evidence, and stop rule. See EXAMPLES.md for exact commands.

Current boundaries

The project does not yet claim a completed Momentum, RFPro, FEM, SIPro, or PIPro workflow. It also does not provide a public remote Bridge protocol: SSH execution is supported, while raw port forwarding is not the documented user path. These areas require their own runtime and solver-side acceptance evidence before they are promoted as supported capabilities.

Documentation

• CLI and installation reference
• Examples and acceptance gates
• Release contract
• Session and dialog automation
• DE/DDS context interaction
• Execution context contract
• Changelog

To remove the ADS integration while preserving unrelated add-ons:

ads-agent addon uninstall

Development

See CONTRIBUTING.md. Public claims are accepted only when the corresponding test, runtime observation, or validation gate has passed.