Star200+

relay-server-config

REVIEW · 64
Registry indexed

Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how config is embedded and how Docker/Compose deploys it. Use when configuring, deploying, or debugging a relay.

Verified installs0
Stars263
Version1.0.0
Quality71/100 · Strong
Trust64/100 · Sandbox only
Audit78/100 · Needs review

Supply asset profile

Coding and developer agents

Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.

Browse track

Scenario

Coding agents

I need a coding agent that can understand a repository, edit code, and review pull requests.

Agent fit

Claude Code + CLI + Codex

Codex, Claude Code, Cursor, CLI, or custom agents.

Install

Ready

npx skills add gosuda/portal-tunnel --skill relay-server-config

Maintenance

fresh

Pushed today

Risk

Needs review

Dependency or permission surface needs review

GitHub quality

263

71/100 Quality · 72/100 Trust

Coverage tags

CodingCoding agentscoding-agentsagent-skill

Review notes

Dependency or permission surface needs review · Permission surface may require sandboxing

Agent adoption scorecard

Trust, audit, and install readiness at a glance

These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.

Quality

Strong
71

Solid option that is likely worth shortlisting for production workflows.

Trust

Sandbox only
64

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

Audit

Needs review
78

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

OpenAgentSkill Trust Score v5

Human review before install

Run only in a sandbox and compare close alternatives before using it for real work.

CodexClaude CodeCursorOpenAgentSkill CLI

Stars

263 GitHub stars

Repo activity

263 stars, 29 forks

Maintenance

Pushed today

License

MIT

Install

npx skills add gosuda/portal-tunnel --skill relay-server-config

Install safety

standard package or runtime install path

Permission surface

secrets or environment access, network or browser access

Agent outcomes

No agent outcome data yet

Docs

Strong README/SKILL.md context

Risk summary

Review before production

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, network or browser access
  • Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata

Install readiness

Install path available

  • Install path is available
  • Repository evidence is available
  • License is declared
  • No Agent Proven outcome evidence yet

Agent-readable metadata

Machine-readable decision data for this skill.

Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.

Open JSON

Suited tasks

  • Coding agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects
  • Inspect source files

Suited agents

CodexClaude CodeCursorOpenAgentSkill CLICLI

Install decision

Command
npx skills add gosuda/portal-tunnel --skill relay-server-config
Policy
review
Human review
yes

Trust and risk

Trust
64/100
Audit
78/100
Risk level
Needs review

Outcome loop

Endpoint
/api/agent/outcome
Event ID
resolve
Outcomes
5

Install command

npx skills add gosuda/portal-tunnel --skill relay-server-config
Public auditEval reportResolve APIInstall handoff

Do not use when

  • teams that need a vendor-supported SLA
  • production agents without a repository review
  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • No OpenAgentSkill engagement data yet
  • High-risk permission hints: Secrets or environment access

Alternative

Code Review

168.6K Stars

npx skills add mattpocock/skills --skill code-review

Alternative

Grill With Docs

164.7K Stars

npx skills add mattpocock/skills --skill grill-with-docs

Alternative

To Spec

164.7K Stars

npx skills add mattpocock/skills --skill to-spec

Alternative

To Tickets

176.7K Stars

npx skills add mattpocock/skills --skill to-tickets

Agent safety v2

54/100 · Avoid automatic install

Experimentalreview

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolve via API

medium

Network access

Skill likely fetches remote pages, APIs, repositories, or external services.

high

Secrets or environment access

Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.

  • High-risk permission hints: Secrets or environment access
  • Dependency or permission surface needs review

Install targets

Install this skill in your agent workflow

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install gosuda-relay-server-config

Agent resolve plan

Let an agent verify fit before installing.

The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.

Open text plan

Open JSON

/api/agent/resolve?task=Use%20relay-server-config%20for%20an%20agent%20workflow&agent=codex&max_risk=medium

Resolve text

/api/agent/resolve?task=Use%20relay-server-config%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text

Install handoff

/api/skills/gosuda-relay-server-config/install

Agent should check

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copy prompt

Task: Use relay-server-config in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20relay-server-config%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/gosuda-relay-server-config/install
Install command: npx skills add gosuda/portal-tunnel --skill relay-server-config
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Agent handoff

Give an agent the install path, not another directory page.

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

Open install API

Install handoff

/api/skills/gosuda-relay-server-config/install

LLM text format

/api/skills/gosuda-relay-server-config/install?format=text

Find alternatives

/api/skills/search?q=relay-server-config&limit=3

Agent prompt

Use relay-server-config for this task. Review https://www.openagentskill.com/api/skills/gosuda-relay-server-config/install, then install with: npx skills add gosuda/portal-tunnel --skill relay-server-config

Registry metadata

Agent-readable profile for automatic skill selection.

This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.

Open manifest

Manifest

/api/registry/manifest/gosuda-relay-server-config

LLM text

/api/registry/manifest/gosuda-relay-server-config?format=text

Install alias

/api/registry/install/gosuda-relay-server-config

Recommend

/api/registry/recommend?task=Use%20relay-server-config%20in%20an%20agent%20workflow&limit=3

Agent fit

70/100

Coding agents

Use-case tags

Coding agentsTesting and QALocal desktop

Platforms

Claude Code

Audit report

Needs review · 78/100

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

View audit reportView eval report

Agent decision cockpit

Fallback candidate for Coding agents

Prototype with this skill first; keep a fallback candidate ready.

70
Readiness
Prototype
Stage

Role in stack

Fallback candidate

Primary fit

Coding agents

Trust label

Prototype first

Install path

Command ready

Use when

  • Coding agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects

Evidence

  • recent repository activity
  • install command or GitHub repo available
  • 71/100 quality profile

review first

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • No OpenAgentSkill engagement data yet

Implementation path

  1. 1Install it in a sandbox agent and run one Coding agents task end to end.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Trust profile

Sandbox only

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

64
OpenAgentSkill Trust Score

GitHub adoption

INFO

263 GitHub stars

Stars/forks activity

CHECK

263 stars, 29 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

Pushed today

License clarity

PASS

MIT

Good signals

  • AI review approved
  • Install path is available
  • Repository evidence is available
  • Recently maintained repository
  • Install command has no obvious high-risk pattern
  • Outcome loop is ready but needs first real agent run

Review before install

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, network or browser access
  • Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata
  • Dependency/runtime risk: credential or environment access, external package install surface
  • Permission surface: secrets or environment access, network or browser access
  • No real agent outcome reports yet
  • Human review required before unattended installation

Recommended action

Run only in a sandbox and compare close alternatives before using it for real work.

Quality profile

Strong candidate for agent workflows

Solid option that is likely worth shortlisting for production workflows.

71
GitHub stars
263
Freshness
Today
Install ready
Yes
License
MIT
Review before install: No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.

Workflow fit

Use this skill in these scenarios

Build and ship code

Coding agents

I need a coding agent that can understand a repository, edit code, and review pull requests.

Verify behavior

Testing and QA

I need my agent to test a web app, reproduce bugs, and verify fixes.

Operate local tools

Local desktop

I need my agent to operate local files and desktop apps in a repeatable workflow.

Workflow fit

Add it to a complete workflow

Inspect, patch, and verify code

Coding review agent

A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.

Operate and verify web apps

Browser QA agent

A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.

Design, build, test, and ship interfaces

Frontend and UI

A practical workflow for agents that turn product briefs or Figma designs into polished frontend code, review the result, test it in a browser, and prepare a safe deployment.

Alternative shortlist

Compare before you install

Similar skills that may fit this task.

Compare all

Code Review

Review a branch or diff against repository standards and the originating spec in two independent analysis passes.

Adopt
Ready100
Quality100
Stars168.6K

Grill With Docs

A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.

Adopt
Ready100
Quality100
Stars164.7K

To Spec

Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.

Adopt
Ready100
Quality100
Stars164.7K

To Tickets

Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.

Adopt
Ready100
Quality100
Stars176.7K

Overview

--- name: relay-server-config description: Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how config is embedded and how Docker/Compose deploys it. Use when configuring, deploying, or debugging a relay. ---

# relay-server configuration

Entrypoint `cmd/relay-server/main.go`, dispatched by `utils.RunCommands` (`""`/`serve` → serve, `help`). Every flag has an env fallback parsed by `utils.{String,Bool,Int}FlagEnv` at flag-init time (`utils/cmd.go`); flags are declared in `main.go ~79-117`. `--help` shows usage/examples only, not flags.

## Core env vars / flags (default) | Env | Default | Purpose | |---|---|---| | `PORTAL_URL` | `https://localhost` | portal base URL (`--portal-url`) | | `PORTAL_FRONTEND_DIR` | empty | custom SPA dir; empty = embedded (`--frontend-dir`) | | `IDENTITY_PATH` | `./.portal-certs` | identity/cert + `policy.json` dir (`--identity-path`) | | `API_PORT` | `4017` | HTTPS API + frontend (`--api-port`) | | `SNI_PORT` | `443` | public SNI ingress (`--sni-port`) — cannot bind unprivileged; override locally | | `WIREGUARD_PORT` | `51820` | (`--wireguard-port`) | | `EMBEDDED_DNS_PORT` | `53` | embedded authoritative DNS (`--embedded-dns-port`) — default provider; needs 53/tcp+udp and `CAP_NET_BIND_SERVICE` in containers | | `ADMIN_TOKEN` | empty | bearer token for admin/policy APIs (`--admin-token`) | | `LANDING_PAGE_ENABLED` | `false` | (`--landing-page-enabled`) | | `DISCOVERY` | `false` | enable gossip; needs `BOOTSTRAPS` (`--discovery`) | | `BOOTSTRAPS` | empty | comma-separated bootstrap relay URLs (`--bootstraps`) | | `TRUST_PROXY_HEADERS` | `false` | trust XFF etc. (`--trust-proxy-headers`) | | `TRUSTED_PROXY_CIDRS` | empty | (`--trusted-proxy-cidrs`) | | `UDP_ENABLED` / `TCP_ENABLED` | `false` | non-HTTP lease transports | | `MIN_PORT` / `MAX_PORT` | `0` / `0` | lease port range; `0` disables | | `PPROF_ENABLED` / `PPROF_ADDR` | `false` / `127.0.0.1:6060` | pprof | | `X402_ENABLED` / `X402_TESTNET` / `X402_PAY_TO` | `false` / `false` / empty | mounts facilitator under `/api/x402` only when enabled |

Embedded DNS is the default `ACME_DNS_PROVIDER` (empty value): `EMBEDDED_DNS_PORT` (default 53). External provider creds remain env-bound: `ACME_DNS_PROVIDER`, `CLOUDFLARE_TOKEN`, GCP (`GCP_PROJECT_ID`+aliases, `GCP_MANAGED_ZONE`+aliases), Hetzner (`HETZNER_API_TOKEN`/`HCLOUD_TOKEN`), AWS Route53 (`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`/`AWS_SESSION_TOKEN`/`AWS_REGION`→defaults us-east-1 downstream/`AWS_HOSTED_ZONE_ID`/`AWS_DNSSEC_KMS_KEY_ARN`), `VULTR_API_KEY`, `NJALLA_TOKEN`, `ENS_GASLESS_ENABLED` (unsupported with embedded). Never hardcode these — reference as env vars / secrets.

## Reserved API surface (types/paths.go) Root-host trees that must never fall through to the SPA: `types.ReservedRootPrefixes` = `/api`, `/sdk`, `/discovery`, `/v1`. x402 public paths `/x402/prepare`, `/x402/client.js`; relay facilitator `/api/x402/{supported,verify,settle}`. Discovery: `/discovery`, `/discovery/announce` (only when `DISCOVERY=true`).

## Admin/policy API `GET/POST /api/policy` with `Authorization: Bearer $ADMIN_TOKEN`. POST requires the FULL settings object (partial bodies → 400 `invalid_mode`). Persists to `$IDENTITY_PATH/policy.json`.

## Config embedding & Docker - `config.toml` (version/protocol) and `registry.json` (default relays) are embedded via `manifest.go` and parsed in `types/types.go`. - `docker-compose.yml` runs `ghcr.io/gosuda/portal:2`, publishes TCP 443 + TCP/UDP 53 (embedded DNS, `cap_add: NET_BIND_SERVICE`) + UDP WireGuard port, and passes the above env vars. - `Dockerfile`: Node 22 stage builds the frontend into `cmd/relay-server/dist/app`, then `make build-server-bin` compiles the Go relay.

Technical details

Version
1.0.0
License
MIT
Last updated
Aug 22, 2026
Published
Aug 22, 2026

Decision snapshot

Fallback candidate

70
Ready
Prototype
Stage

recent repository activity

Audit

Install review

Install and adoption review

78
Needs review
Security
75/100
Maintenance
100/100
Install
92/100
Open full auditView eval report

Agent-proven evidence

Agent-proven evidence

Outcome reports after resolve, review, install, and one narrow run.

0
Proven
Needs first agent runAuto-install: review firstLast: Unknown
Success rate
—
Recent failure
—
Outcomes
0
Output quality
—
Failed
0
Not relevant
0
Installs
0
Risk blocked
0
Setup needed
0
Production
0

No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.

Agent-Proven rankingOutcome contract

Install

Add to agent workflow

Free and open source. Review the report before installing into production agents.

Compare AlternativesAuto-resolve PlanView on GitHubDocumentation

Growth loop

Share kit

X

Scenario-led draft for relay-server-config, ready for a manual X post.

Curator note
A practical pick for the next repo task:

relay-server-config: Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how conf...

263 stars

https://www.openagentskill.com/skills/gosuda-relay-server-config?ref=x
Open X draft
Optional reply with install command
Listing + install path for relay-server-config:
https://www.openagentskill.com/skills/gosuda-relay-server-config?ref=x

Install: npx skills add gosuda/portal-tunnel --skill relay-server-config
Open reply draft

Listing source

Registry indexed

Claimable

This listing was indexed from public sources and is not marked official until a maintainer claim is approved.

Creator
gosuda
Indexed by
OpenAgentSkill community index

Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.

Claim this skill

Owner claim

Claim this skill listing

This Registry indexed listing is attributed to gosuda but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.

Creator backlink kit

Add the evidence badges to your README

Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=listed&label=Listed)](https://www.openagentskill.com/skills/gosuda-relay-server-config)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=trust&label=Trust)](https://www.openagentskill.com/skills/gosuda-relay-server-config)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=audit&label=Audit)](https://www.openagentskill.com/skills/gosuda-relay-server-config/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/gosuda-relay-server-config)
Preview badge Open audit Creator kit

Author

G

gosuda

@gosuda

Tags

agent-skill

Platform fit

Claude Code

Health signals

GitHub stars
263
Quality score
40/100
Last GitHub push
Aug 22, 2026
Framework hints
Unknown
OpenAgentSkill views
0
Install copies
0
Outbound clicks
0

Community signal

Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.

Trust & safety

Sandbox only

64
  • GitHub adoption263 GitHub starsINFO
  • Stars/forks activity263 stars, 29 forks; issue activity unavailable in current metadataCHECK
  • Recent maintenancePushed todayPASS
  • License clarityMITPASS
  • README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
  • Dependency/runtime riskcredential or environment access, external package install surfaceCHECK

Related skills

Code Review

Review a branch or diff against repository standards and the originating spec in two independent analysis passes.

168.6K Stars

Grill With Docs

A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.

164.7K Stars

To Spec

Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.

164.7K Stars

To Tickets

Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.

176.7K Stars
InstallView on GitHub