hansjone/netxops
1
0
Fork 0
mirror of https://github.com/hansjone/netxops.git synced 2026-10-09 10:50:46 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
netxops/docs/INSTALL.md
oliver 13db99484f Fix local link: peer packages invisible outside profile tree. 
Path installs junction the checkout outside ~/.dsh/profiles/*/node_modules, so Node cannot see DSH peers; add link-dsh-peers scripts and document the one-time setup.

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

2.4 KiB
Raw Blame History

Install Netx Ops on DeepSeek Harness

Prerequisites

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

You do not need OS environment variables for NETX_API_URL / NETX_API_TOKEN.

1) Install host bridge + Plugins settings card

dsh plugin --profile <name> add github:hansjone/netxops
# or from a checkout:
dsh plugin --profile <name> add /path/to/netxops

This mounts dsh-netxops (host + browser halves):

  • Host: settings namespace netxops, credential NETX_API_TOKEN, spawns mcp__netx__*
  • Browser: Settings → Plugins → Netx Ops card (API URL / lang / python + token)

Fill in the UI (recommended)

  1. Open dsh web → Settings → Plugins → Plugin configuration
  2. Expand Netx Ops
  3. Paste API token (stored as credential NETX_API_TOKEN, never in settings JSON)
  4. Set API URL (e.g. http://127.0.0.1:8890), optional lang / python command
  5. Save — MCP remounts with the new values

Optional CLI for token only

powershell -File .\scripts\set-netx-token.ps1 -Token "nxt_…"

2) Install the agent preset (persona + skills)

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

Unix: ./scripts/link-preset.sh

Open dsh web, new session → preset Netx Ops.

Verify

  1. Settings → Plugins shows Netx Ops card; token badge becomes “Configured” after save.
  2. Tools include mcp__netx__queryUmeAlarms (and siblings).
  3. “Critical Top by host” / single host_name alarm query work.

See TOOL_MAP.md.

Local link: / path install

When you dsh plugin add D:\path\to\netxops, pnpm junctions the checkout outside the profile tree. Node then resolves imports from that checkout, so DSH peer packages (@deepseek-ai/schemastery, …) are invisible unless you link them once:

powershell -File .\scripts\link-dsh-peers.ps1

Unix: ./scripts/link-dsh-peers.sh

(Requires a prior dsh web / profile boot so ~/.dsh/profiles/node_modules exists.)

npm / GitHub installs place the package under the profile node_modules and do not need this step.