---
name: lingtai-ai-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."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "72a932f5-ccfd-42fe-b107-9084fc0394b0"
  decimalai-version-id: "505eab2b-e40d-42c7-a7e0-d5b858b4b6bb"
  decimalai-version: "1"
  decimalai-body-sha256: "28264f2cf96dc9cf75a2b0dce8e323217c9c4bd8d82789966eef2e34add9013d"
  decimalai-name: "lingtai-ai/lingtai-portal-guide"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/lingtai-ai-lingtai-portal-guide@1/SKILL.md"
---
# 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 from the same `.lingtai/` directory the TUI reads, on a random local port written to `.lingtai/.portal/port`.

## Nested reference catalog

```yaml
- 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

| Need | Read |
|---|---|
| Explain what the portal is, how to open it, or where portal files live | `reference/overview/SKILL.md` |
| Inspect topology tape format, replay chunks, API endpoints, or network JSON | `reference/topology-and-api/SKILL.md` |
| Explain agent lifecycle states in portal output or how recording/rebuild works | `reference/lifecycle-and-recording/SKILL.md` |

## 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.