Home / gosuda / portal-tunnel · .agents/skills/testing-portal-tunnel-dashboard/SKILL.md · GitHub

testing-portal-tunnel-dashboard skillA

testing-portal-tunnel-dashboard is agent-read markdown (skill) from gosuda/portal-tunnel: How to drive the portal-tunnel agent dashboard bubbletea TUI end-to-end without a live agent or relay, using a stub control server plus a fabricated agent-endpoint.json..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Testing the portal-tunnel agent dashboard TUI standalone

The `portal-tunnel agent dashboard` TUI looks like it needs a running agent, but it only needs two things: a state dir containing `agent-endpoint.json`, and an HTTP server at the endpoint's `control_addr` that speaks the control API envelope.

## How the dashboard gets its data

- `portal-tunnel agent dashboard --state-dir DIR` reads `DIR/agent-endpoint.json` (`cmd/portal-tunnel/agent/control.go`, `endpointFilename = "agent-endpoint.json"`).
- The file is `{"control_addr":"HOST:PORT","token":"TOKEN"}`.
- Every poll tick it issues `GET http://<control_addr>/agent/status` with `Authorization: Bearer <token>` (`types.PathAgentStatus`).
- Responses must use the repo's API envelope: `{"ok": true, "data": <AgentStatusResponse>}`. Returning the raw status object without the envelope yields "Agent unavailable: api response is not ok" in the TUI.
- `AgentStatusResponse` / `AgentTunnelStatus` shapes live in `cmd/portal-tunnel/agent/api_types.go` (`tunnels[].metadata` is `types.LeaseMetadata`).

## Recipe

1. `go build -o /tmp/portal-tunnel ./cmd/portal-tunnel`
…

Read the whole file at its exact version.

How to install

Latest version
mdr add gosuda/portal-tunnel/testing-portal-tunnel-dashboard@git:20260922.927bd9e
Exact content
mdr add gosuda/portal-tunnel/testing-portal-tunnel-dashboard@sha256:0df01bf3bbad857c

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ofqvmqngwy3djc3c.svg)](https://markdownregistry.com/a/art_ofqvmqngwy3djc3c)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.927bd9e latest2026-09-22 927bd9e 4,952 BA view · diff
git:20260922.08102272026-09-22 0810227 4,897 BA view · diff
git:20260922.3a983e12026-09-22 3a983e1 4,406 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4952 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

gosuda/portal-tunnel · 271 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ofqvmqngwy3djc3c
GET https://markdownregistry.com/api/v1/resolve?ref=gosuda/portal-tunnel/testing-portal-tunnel-dashboard
GET https://markdownregistry.com/api/v1/blob/0df01bf3bbad857ca5ec6119c12eaf4a6c6a3a872b7a192741c2d9ea2ace63a8

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from gosuda/portal-tunnel

AGENTS.md agents
gosuda/portal-tunnel · AGENTS.md
git:20260918.ab4bbf3 · audit A · 271 stars
AGENTS.md@frontend agents
gosuda/portal-tunnel · frontend/AGENTS.md
git:20260804.df9da5d · audit A · 271 stars
CLAUDE.md@frontend claude
gosuda/portal-tunnel · frontend/CLAUDE.md
git:20260304.96dd745 · audit B · 271 stars
llms.txt llmstxt
gosuda/portal-tunnel · llms.txt
git:20260922.1ead036 · audit B · 271 stars
portal-connect skill
gosuda/portal-tunnel · plugins/portal-deploy/skills/portal-connect/SKILL.md · Reach, inspect, or consume a service that someone published through a Portal relay. Turns a Portal hostname, a service…
git:20260922.1ead036 · audit B · 271 stars
portal-expose skill
gosuda/portal-tunnel · plugins/portal-deploy/skills/portal-expose/SKILL.md · Expose, preview, protect with x402 payments, or keep a local web app, static site, HTTP route set, or explicitly…
git:20260922.2d69d10 · audit B · 271 stars
portal-relay skill
gosuda/portal-tunnel · plugins/portal-deploy/skills/portal-relay/SKILL.md · Set up and run a public Portal relay on any Linux host with a public IP — Docker Compose deployment, embedded…
git:20260922.a2e16ea · audit A · 271 stars

Every file in gosuda/portal-tunnel

Browse by kind, by grade A, or by owner.