lingtai-portal-guide

name: lingtai-portal-guide description: Reference router for LingTai portal (lingtai-portal) internals. Read this to understand portal startup/opening, .portal/ files, topology/replay APIs, network response shape, and lifecycle/recording behavior. Useful when the human asks about visualization, network history, or the portal. version: 1.1.0

Portal Guide

This is a reference router. It describes how the LingTai portal works internally. Do not take action based on this skill alone — use it to choose the focused reference that matches the portal question.

Quick orientation

lingtai-portal is a Go binary that serves a web visualization of the agent network. It reads the same .lingtai/ directory as the TUI, records topology frames for replay, and exposes live/replay APIs on a random local port written to .lingtai/.portal/port.

Nested reference catalog

- name: portal-guide-overview
  location: reference/overview/SKILL.md
  description: Portal purpose, how to open it, the `.lingtai/.portal/port` contract, and the `.lingtai/.portal/` directory layout.
- name: portal-guide-topology-and-api
  location: reference/topology-and-api/SKILL.md
  description: `topology.jsonl` frame shape, replay chunk storage, API endpoints, and the live `Network` response schema.
- name: portal-guide-lifecycle-and-recording
  location: reference/lifecycle-and-recording/SKILL.md
  description: Portal lifecycle-state interpretation, heartbeat/staleness rule, 3-second recording loop, and reconstruction behavior.

Routing table

Safety notes

• Treat this skill as architecture reference, not an instruction to mutate portal state.
• If you need to change portal code, use lingtai-dev-guide and lingtai-tui-anatomy first, then read the cited Go code.
• If a portal URL, field name, or behavior here disagrees with the current code, load lingtai-issue-report and surface the stale documentation.