/plugadvpl:init

Initialize a local SQLite+FTS5 index for ADVPL/TLPP sources.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /plugadvpl:init
Source: https://github.com/JoniPraia/plugadvpl/tree/main/skills/init
Command: npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of having no local, searchable index of ADVPL/TLPP sources available for Claude to answer questions precisely without rereading large .prw files.

Core Features & Use Cases

  • Creates a local SQLite FTS5 index: generates .plugadvpl/index.db to support fast search across sources and symbols.
  • Applies full migrations for deep code understanding: populates tables for sources, functions/symbols, calls, includes, SQL references, MVC hooks, defines, and lint findings lookups.
  • Prepares Claude for index-first reads: writes a CLAUDE.md fragment instructing Claude to consult the index before doing raw file reads.
  • Sets up repo hygiene: adds .plugadvpl/ to .gitignore to prevent indexing artifacts from being committed.

Quick Start

Run the command to initialize indexing in the current project: uvx [email protected] init.

Frequently Asked Questions about /plugadvpl:init

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

FAQPage Schema
How do I index ADVPL source code for faster searching in Protheus projects?

To index ADVPL sources, run the initialization command to generate a local SQLite+FTS5 database in .plugadvpl/index.db, enabling fast search across functions, includes, calls, and MVC hooks without re-reading .prw files.

What does a Protheus code index include for code discovery?

A Protheus code index populates SQLite tables for sources, functions, symbols, calls, includes, SQL references, MVC hooks, defines, and lint findings, making them fully discoverable for question answering and diagnostics.

How do I set up SQLite FTS5 indexing for my TLPP sources?

Run the initialization command in your project root to apply full database migrations, load lookup catalogs, write a CLAUDE.md guidance fragment for index-first reads, and automatically add .plugadvpl/ to your .gitignore.

Can I use Claude to search Protheus codebases without reading full files?

Yes, the setup writes a CLAUDE.md fragment instructing Claude to consult the local SQLite database first, allowing it to retrieve structured facts from ADVPL/TLPP sources instead of re-reading large .prw files.

Does initializing a Protheus code index modify my git repository?

Initialization only updates your .gitignore to add .plugadvpl/, preventing the local SQLite index database and other indexing artifacts from being committed to your version control.