Tech Matrix Agent · v0.1

Bring Tech Matrix into your network

Install a small, secure agent on a host inside your network. Tech Matrix can then troubleshoot your routers, switches, and firewalls in real time — without exposing your devices to the internet, and without storing your credentials.

Why install the agent?

Without an agent, Tech Matrix answers general networking questions. With one, it diagnoses your environment directly.

🔌

Live device access

Run show commands on real Cisco / Juniper / Arista / Fortinet / Palo Alto / F5 gear during a chat. No more pasting CLI output back and forth.

🛡️

No inbound holes

The agent dials out to Tech Matrix over WebSocket+TLS. Your firewall stays sealed; no port forwarding, no public IP needed.

✋

Every command approved

Nothing runs without your explicit click. Edit, add, or reject any command Tech Matrix proposes before it ever reaches a device.

🔑

No stored credentials

Device passwords flow through the tunnel just-in-time and are wiped after the task. Tech Matrix never persists them.

📜

Full audit trail

Every command — proposed, edited, approved, executed — is logged with the user, timestamp, and device. Searchable, exportable.

⚡

Native desktop app

Download the installer for your OS, double-click, walk through the setup wizard. System tray icon, dashboard, notifications. Looks and feels like proper software, not a CLI.

System requirements

Pick any host inside the network you want to manage — a jumphost, a small VM, an admin workstation.

Operating systemWindows 10 / 11 / Server 2019+ · Linux (any modern distro) · macOS 10.15+ coming soon

Architecturex86_64 / amd64

RAM~80 MB idle, ~150 MB during active sessions

Disk~250 MB installed

Network outboundHTTPS/WSS (TCP 443) to app.techmatrix.ai

Network inboundNone — agent makes outbound connections only

PrivilegesStandard user account (no admin/root required for install or runtime)

Proxy supportHTTP and HTTPS corporate proxies, with or without basic authentication

Download

Pick your platform. Double-click the installer, walk through the four-step setup wizard, and you're connected. No CLI required.

🪟

Windows

x86_64 · Win 10 / 11 / Server 2019+

Standard Windows installer with desktop shortcut, system tray app, and uninstaller. ~82 MB.

⬇ Download installer (.exe)

🐧

Linux · amd64

x86_64 · Ubuntu / Debian / RHEL / Fedora

AppImage runs anywhere; .deb installs natively on Ubuntu/Debian. ~116 MB / 76 MB.

⬇ Download AppImage ⬇ .deb (Debian/Ubuntu)

🍎

macOS

x86_64 / Apple Silicon · 10.15+

Notarized .dmg with native macOS app behaviour. Coming with the next release.

Code-signing for the installers is in progress (Windows EV cert + Apple Developer ID). Until those land you'll see a SmartScreen warning on Windows ("More info → Run anyway") and a Gatekeeper prompt on macOS (right-click → Open). Functionality is unaffected.

Install in three steps

Mint a registration token

Open the Agent Console → Registration tokens tab. Choose Persistent for a long-lived host (recommended for jumphosts and admin workstations) or Time-based for a one-off install. Click Mint token, copy the resulting tmr_p_… or tmr_t_… string — it's only shown once.

Persistent vs Time-based: persistent tokens never expire and can be reused if the agent disconnects (after reboots, network changes, etc.). Time-based tokens expire after 24 hours and are single-use. Pick persistent unless you have a specific reason not to.

Run the installer and complete the setup wizard

Double-click the installer you downloaded. Standard install wizard runs. When install completes, the Tech Matrix Agent app launches automatically and shows the setup wizard.

The wizard has four steps:

1. Network connection. Direct (most common) or Through a corporate proxy.

2. Proxy details. Only if you picked proxy. Host, port, HTTP/HTTPS, and (if required) username + password. There's a Test connection button to verify the settings before continuing.

3. Registration token. Paste the token from step 1. Format is validated locally before submission.

4. Agent name. Defaults to your hostname; rename to something descriptive like jumphost-prod if you'll have multiple agents.

Click Register & connect. The agent contacts Tech Matrix, completes registration in 1–2 seconds, and the dashboard window opens.

Verify it's online

The agent dashboard shows a green CONNECTED badge and a live activity feed. The system tray icon (lower-right corner on Windows, menu bar on macOS) turns green and stays present even when you close the window.

Open the Agent Console in your browser → Installed agents tab. Your new agent appears with a green dot, the name you chose, and the timer settings you can customise per-agent.

From there, bind the agent to one or more network devices in your My Devices pane, and start a chat — Tech Matrix can now run live diagnostic commands on those devices through your agent.

Behind a corporate proxy?

The agent fully supports proxied environments. The wizard asks you about it directly in step 1.

✓ HTTPS on port 443 only. Survives most corporate firewalls without exception requests for obscure ports.
✓ Proxy is scoped to cloud connections. The agent's outbound traffic to Tech Matrix routes through the proxy. Direct device traffic on your internal network (SSH to routers, SNMP to firewalls, REST to APIs) bypasses the proxy and goes direct.
✓ Authenticated proxies supported. If your proxy needs a username and password, the wizard prompts for them and stores them encrypted in the local config.
✓ Auto-detect on Windows. If your system has a proxy configured in Windows Internet Settings, the wizard pre-fills the form.
✓ Test connection button. Before committing your registration token, click Test connection in the wizard to verify the proxy can reach Tech Matrix. Catches typos and auth errors immediately.
✓ Settings can be changed later. If your proxy ever changes, open the agent app → Settings → Proxy tab → update the values without re-registering.

Recommended exception text for your IT/security team

If you need to file an exception request, paste this:

Outbound request: HTTPS (TCP/443) to app.techmatrix.ai
Direction: outbound only
Inbound rules required: none
Authentication: per-customer registration token (no anonymous traffic)
Service: Tech Matrix B2B SaaS (AI-powered IT troubleshooting platform)
Categorization: Information Technology / Business and Economy

Troubleshooting

Wizard says "Registration failed: register_failed_503"

Your network is blocking traffic to app.techmatrix.ai. Most often this is a corporate URL filter (Cisco WSA, Zscaler, Forcepoint, Bluecoat) that hasn't categorized our domain yet. Either: (a) file an exception request with your IT/security team using the text above, or (b) if you have a proxy, make sure you selected "Through a corporate proxy" in step 1 and entered the proxy details correctly.

Wizard says "hardware_already_registered"

An agent record already exists for this host. Open the Agent Console → Installed agents tab → find the old agent → click Delete. Then retry registration on this host.

"Token must start with tmr_t_ or tmr_p_"

You're using a legacy tm_ token. The current agent only accepts the new tmr_ registration tokens minted from the Agent Console → Registration tokens tab.

SmartScreen warning on Windows

Expected during the current beta — code-signing certificate is in progress. Click "More info" → "Run anyway". The installer will land in the next release with a verified Tech Matrix publisher signature.

Need to re-register or change settings?

Open the agent app, click Settings in the dashboard footer. From there: change the agent name, update proxy details, view logs, export a support bundle, or open the wizard again to register with a new token.

Direct downloads

For audit purposes or to fetch from a script.

📦 Tech-Matrix-Agent-Setup-win-x64.exe — Windows installer (~82 MB, always points to latest release)
📦 Tech-Matrix-Agent-Setup-1.1.5-linux-x86_64.AppImage — Linux portable (~116 MB) — v1.1.5 (latest Linux build)
📦 Tech-Matrix-Agent-Setup-1.1.5-linux-amd64.deb — Debian/Ubuntu package (~76 MB) — v1.1.5 (latest Linux build)