skills.rest
Lingtai-AI
Lingtai-AIOFFICIAL
Explore all skills by this author →
GitHub

dev-guide-setup

Guides local developer environment setup for building and running the LingTai TUI, portal, and kernel.

692|60|Updated Mar 15, 2026
Search Tags:#uv#mcp#development environment#Golang#BUILD#editable install#Setup
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill dev-guide-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-guide-setup
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-dev-guide/reference/setup
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill dev-guide-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a local development environment for the LingTai ecosystem involves multiple repositories, languages, and toolchains (Go, Node.js, Python/uv), and mistakes like stale editable installs or wrong symlinks silently break development. This Skill provides the exact commands and verification steps to get a working dev environment.

Core Features & Use Cases

  • Repository Cloning & Building: Clone the lingtai monorepo, kernel, and MCP addon repos, then build the TUI and portal binaries with make.
  • Dev-Mode Symlinks: Configure homebrew-path symlinks so every local build is immediately picked up without reinstall cycles.
  • Editable Kernel Install: Install the Python kernel in editable mode into the uv-managed runtime venv, with a probe script that verifies which checkout a running agent actually imports.
  • Use Case: After merging kernel changes, run the runtime probe to confirm the agent's venv resolves to your updated editable checkout rather than a stale worktree, then refresh the agent.

Quick Start

Ask the agent to walk you through setting up a LingTai development environment, including cloning the repos, building the TUI and portal, and installing the kernel in editable mode.

Frequently Asked Questions about dev-guide-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a LingTai development environment locally?▼

Clone the lingtai monorepo and lingtai-kernel repos as siblings, build the TUI and portal with make build, symlink the binaries into /opt/homebrew/bin, and install the kernel in editable mode into the uv-managed runtime venv at ~/.lingtai-tui/runtime/venv.

How do I install the LingTai kernel in editable mode?▼

Run uv pip install -e on the kernel checkout targeting the runtime venv at ~/.lingtai-tui/runtime/venv. Use uv rather than pip because the venv is uv-managed and has no pip symlink, only pip3.

How do I verify which kernel checkout a running agent uses?▼

Run the provided Python probe with the runtime venv interpreter; it prints the import path, git root, branch, and HEAD for the kernel and each MCP addon module. If HEAD is behind, fast-forward that checkout and refresh the agent.

What tools are required to build the LingTai TUI and portal?▼

You need Go 1.21+ for the TUI and portal binaries, Node.js 18+ for the portal's React frontend, Python 3.10+ for the kernel, uv for package management, and git. The gh CLI is needed for releases.

Why does my lingtai-tui version show a clean version instead of a git hash?▼

A clean vX.Y.Z version string means the brew-installed binary is ahead in your PATH, not your dev build. Dev mode is active when the version shows a -N-gSHORTSHA suffix and readlink resolves the binary to your local build output.

Related Skills

Explore More Software Engineering Skills→
amritpa12amritpa12

go-trader

Automate go-trader setup from repository clone to systemd service.

Community
Advanced
MCDxAIMCDxAI
8

meteor-addon

Create, update, and manage Meteor Client addons from official templates.

Official
Intermediate
Lingtai-AILingtai-AI
621

lingtai-issue-report

File structured LingTai issue reports via GitHub CLI or manual submission.

Official
Advanced
Lingtai-AILingtai-AI
621

tutorial-guide

Guide learners through a 12-lesson tutorial on Lingtai with live exploration.

Official
Advanced