# Lingtai Portal Guide

> Lingtai Portal Guide is an Agent Skill for apps & automation published in the Lingtai-AI/lingtai repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `lingtai-portal-guide`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/Lingtai-AI/lingtai/blob/HEAD/tui/internal/preset/skills/lingtai-portal-guide/SKILL.md
- Repository: Lingtai-AI/lingtai (701 GitHub stars when collected)

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

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

---

Source: https://www.openparable.com/skill/apps-automation/lingtai-portal-guide (OpenParable). Cite the canonical URL above.
