OpenParable
Skip to content
← Back to skills

Lingtai Portal Guide

Apps & Automation
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Lingtai-AI/lingtai/blob/HEAD/tui/internal/preset/skills/lingtai-portal-guide/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/lingtai-portal-guide, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

NeedRead
Explain what the portal is, how to open it, or where portal files livereference/overview/SKILL.md
Inspect topology tape format, replay chunks, API endpoints, or network JSONreference/topology-and-api/SKILL.md
Explain agent lifecycle states in portal output or how recording/rebuild worksreference/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.