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.

⚡

Tiny footprint

Single static Go binary. ~6 MB on disk, runs idle in <5 MB RAM. Installs as a Windows Service or systemd unit and stays out of the way.

System requirements

Pick any host inside the network you want to manage — a jump server, a small VM, even a Raspberry Pi.

Operating systemWindows 10 / 11 / Server 2019+ · Linux (any modern distro with systemd) · macOS coming soon
Architectureamd64 (x86_64) · arm64
RAM~5 MB idle, ~30 MB during active sessions
Disk~10 MB
Network outboundHTTPS/WSS (443) to techmatrix.ai
PrivilegesAdmin (Windows) / root (Linux) for install. Service then runs as LocalSystem / root.

Download

Pick your platform. The agent is a single self-contained binary — no Node.js or other runtime to install. Mint a registration token in the Agent Console, then run two commands on your host.

🪟
Windows
x86_64 · Win 10 / 11 / Server 2019+

Single .exe — drop it on the host, register, and start. No installer, no admin rights required.

⬇ Download agent (.exe)
🐧
Linux · amd64
x86_64 · any modern distro

Single binary. Run as a regular user; promote to a systemd service if you want it to survive reboots.

⬇ Download agent
🍎
macOS
x86_64 · 10.15+

Single binary for Intel Macs. ARM/Apple Silicon support coming with notarization.

⬇ Download agent

Install in three steps

1

Mint a registration token

Open the Agent Console → Registration tokens tab → choose Persistent (recommended for a long-lived host) or Time-based (for a one-off install) → click Mint token. Copy the resulting tmr_p_… or tmr_t_… token — it's only shown once.

2

Register the agent on your host

Windows (PowerShell):

.\techmatrix-agent-win.exe register --token tmr_p_YOUR_TOKEN

Linux:

chmod +x techmatrix-agent-linux
./techmatrix-agent-linux register --token tmr_p_YOUR_TOKEN

macOS:

chmod +x techmatrix-agent-macos
./techmatrix-agent-macos register --token tmr_p_YOUR_TOKEN

Identity is stored in ~/.techmatrix/agent.json with 0600 perms.

3

Start it

./techmatrix-agent-linux start

Within seconds, the Agent Console shows the new agent with a green dot. Bind it to a device from the chat sidebar's My Environment pane and you're ready to troubleshoot.

To disconnect cleanly later: ./techmatrix-agent-linux disconnect. To check state: ./techmatrix-agent-linux status.

Direct downloads

If you'd rather inspect the binary yourself or fetch from a script: