netxops/docs/INSTALL.md
oliver 0fcff2d45a Document GitHub install as the default path.
Path/link installs are developer-only; users should not need link-dsh-peers.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-04 22:31:10 +08:00

1.4 KiB

Install Netx Ops on DeepSeek Harness

Prerequisites

  1. DeepSeek Harness (dsh) installed.
  2. netx API reachable (default http://127.0.0.1:8890).
  3. Python 3.11+ with netx_mcp importable:
pip install "git+https://github.com/hansjone/netx.git#subdirectory=packages/netx-mcp"
python -c "import netx_mcp; print('ok')"

No OS env vars needed for URL / token.

dsh plugin --profile web add github:hansjone/netxops
dsh web

Then: Settings → Plugins → Netx Ops → paste API token + URL → Save.

That is the whole host install. You do not run any link-dsh-peers script for GitHub installs.

Agent preset (persona + skills)

One-time (or after pull):

git clone https://github.com/hansjone/netxops.git
cd netxops
powershell -File .\scripts\link-preset.ps1

Unix: ./scripts/link-preset.sh

New session → preset Netx Ops.

Verify

  1. Settings → Plugins shows Netx Ops; token badge “Configured” after save.
  2. Tools include mcp__netx__queryUmeAlarms.
  3. Critical Top / single-host alarm queries work.

See TOOL_MAP.md.

Path / local checkout (developers only)

dsh plugin --profile web add D:\path\to\netxops
powershell -File .\scripts\link-dsh-peers.ps1   # only for path/link: installs

See examples/local-debug/README.md.