@vladstudio/pi-skim

Pi extension: a `skim` tool returning a structural overview of JS/JSX/TS/TSX/Swift files — exports, signatures, hooks, behavior — via ast-grep, without reading full source.

Packages

Package details

extension

Install @vladstudio/pi-skim from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@vladstudio/pi-skim

Package: @vladstudio/pi-skim
Version: 1.0.0
Published: Jul 9, 2026
Downloads: 77/mo · 14/wk
Author: vladstudio
License: MIT
Types: extension
Size: 22.5 KB
Dependencies: 2 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@vladstudio/pi-skim

Pi extension adding a skim tool: structural overview of JS/JSX/TS/TSX/Swift files — exports, signatures, hooks, behavior — via ast-grep, without reading full source.

Use instead of read when exploring code or understanding a file's purpose. Pass multiple paths to batch.

What it extracts

JS/TS: imports, exports (default/named/const/type/interface), private functions, React hooks (useX), behavior (component, 'use client'/'use server', fetch, async, useEffect, redirect, router.push, storage).
Swift: imports, exports (public/open/package), types (class/protocol/typealias/extension), members (functions/init/subscript/properties), behavior (await/async/throws/Task, SwiftUI, Combine).

Supported extensions

.js .jsx .mjs .cjs .ts .tsx .mts .cts .swift

Install

pi install npm:@vladstudio/pi-skim

Example

extensions/skim/index.ts

imports:
  {SgNode} from "@ast-grep/napi"
  {js, parse, registerDynamicLanguage, ts, tsx} from "@ast-grep/napi"
  swift from "@ast-grep/lang-swift"

exports:
  default: skimExtension(pi)
  skimExtension(pi)

behavior:
  React component (returns JSX)

License

MIT