pm pls

​

Overview

​

Syntax

pm pls

​

Examples

​

List All Packages

pm pls

├── packages/
│   ├── core "@myapp/core"
│   ├── utils "@myapp/utils"
│   └── shared "@myapp/shared"
└── apps/
    ├── web "@myapp/web"
    └── api "@myapp/api"

​

View Package Structure

pm pls

├── libs/
│   ├── auth "@company/auth"
│   ├── database "@company/database"
│   └── ui "@company/ui"
├── services/
│   ├── api "@company/api"
│   └── worker "@company/worker"
└── apps/
    └── dashboard "@company/dashboard"

​

How It Works

export const plsCmd = cli.Command.make('pls', {}, () =>
  Effect.gen(function* () {
    const pm = yield* PackageManagerService;
    const path = yield* Path.Path;
    const packages = yield* pm.listWorkspacePackages(pm.lockDir);
    for (const line of formatWorkspaceTree(packages, path.sep)) {
      yield* Console.log(line);
    }
  }).pipe(Effect.provide(PackageManagerLayer)),
);

1. Detects the package manager
2. Lists all workspace packages from the lockfile directory
3. Formats them into a tree structure using formatWorkspaceTree
4. Displays the formatted output

​

Tree Format

• Directory structure - Nested folders with proper tree characters (├──, └──, │)
• Package names - Displayed in quotes after the directory name
• Relative paths - Shows where each package lives in your monorepo

​

Use Cases

​

Quick Overview

pm pls

​

Before Installation

pm pls
pm i -F @myapp/core

​

Documentation

pm pls > docs/structure.txt

​

Onboarding

pm pls

​

Monorepo Detection

• pnpm workspaces - Reads from pnpm-workspace.yaml
• Bun workspaces - Reads from package.json workspaces field
• npm workspaces - Reads from package.json workspaces field

​

Related Commands

• pm cd - Navigate to a workspace package
• pm install - Install with workspace filtering
• pm ls - List installed dependencies