@anytio/pspm 0.2.0 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to the PSPM CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-01-27
+
+### Added
+
+- **Local directory support**: Install skills directly from local directories using the `file:` protocol
+  - `pspm add file:../my-skill` - Install from relative path
+  - `pspm add file:/absolute/path/to/skill` - Install from absolute path
+  - `pspm add ../my-skill` - Auto-detected as `file:../my-skill`
+  - Local packages are symlinked (not copied) for instant updates during development
+  - `localDependencies` section in `pspm.json`
+  - `localPackages` section in lockfile (version 5)
+  - Local packages stored as symlinks in `.pspm/skills/_local/{name}/`
+
+- **Enhanced `list` command**: Shows local packages with `[local]` indicator and path
+
+### Changed
+
+- Lockfile version bumped to 5 to support `localPackages`
+- `install` command now processes local dependencies (Phase 2.5 resolve, Phase 4.5 install)
+- `remove` command now handles local package removal
+
 ## [0.2.0] - 2026-01-23
 
 ### Changed

package/CLI_GUIDE.md

@@ -158,6 +158,11 @@ pspm add github:owner/repo@main             # Entire repo, specific branch
 pspm add github:owner/repo/path/to/skill    # Subdirectory, default branch
 pspm add github:owner/repo/path@v1.0.0      # Subdirectory with tag/ref
 
+# Local specifier formats:
+pspm add file:../my-skill                   # Relative path (symlinked)
+pspm add file:/absolute/path/to/skill       # Absolute path
+pspm add ../my-skill                        # Auto-detected as file:../my-skill
+
 # Add multiple skills at once:
 pspm add @user/alice/skill1 @user/bob/skill2
 
@@ -196,7 +201,10 @@ pspm list --json
 #   github:owner/repo/skills/react-tips (main@abc1234)
 #     -> .claude/skills/react-tips, .cursor/skills/react-tips
 #
-# Total: 2 skill(s) (1 registry, 1 github)
+#   my-local-skill [local] <- ../my-local-skill
+#     -> .claude/skills/my-local-skill
+#
+# Total: 3 skill(s) (1 registry, 1 github, 1 local)
 ```
 
 ### Install Skills
@@ -353,7 +361,7 @@ Package manifest file (created with `pspm init`):
 
 ```json
 {
-  "lockfileVersion": 3,
+  "lockfileVersion": 5,
   "registryUrl": "https://pspm.dev",
   "packages": {
     "@user/bsheng/vite_slides": {
@@ -370,6 +378,14 @@ Package manifest file (created with `pspm init`):
       "gitCommit": "abc1234567890...",
       "gitRef": "main"
     }
+  },
+  "localPackages": {
+    "file:../my-skill": {
+      "version": "local",
+      "path": "../my-skill",
+      "resolvedPath": "/absolute/path/to/my-skill",
+      "name": "my-skill"
+    }
   }
 }
 ```
@@ -402,10 +418,12 @@ project/
 │   ├── skills/          # Installed skills
 │   │   ├── {username}/  # Registry skills
 │   │   │   └── {skillname}/
-│   │   └── _github/     # GitHub skills
-│   │       └── {owner}/
-│   │           └── {repo}/
-│   │               └── {path}/
+│   │   ├── _github/     # GitHub skills
+│   │   │   └── {owner}/
+│   │   │       └── {repo}/
+│   │   │           └── {path}/
+│   │   └── _local/      # Local skills (symlinks)
+│   │       └── {name} -> /path/to/source
 │   └── cache/           # Tarball cache
 ├── .claude/
 │   └── skills/          # Symlinks for claude-code agent

package/README.md

@@ -100,6 +100,11 @@ pspm install                                     # Install all from lockfile
 - `github:owner/repo/path/to/skill` - Subdirectory within repo
 - `github:owner/repo/path/to/skill@v1.0.0` - Subdirectory with tag
 
+**Local specifier formats:**
+- `file:../my-skill` - Relative path (symlinked, not copied)
+- `file:/absolute/path/to/skill` - Absolute path
+- `../my-skill` - Auto-detected as `file:../my-skill`
+
 **Agent symlink options:**
 ```bash
 pspm add <specifier> --agent claude-code,cursor  # Link to multiple agents
@@ -161,7 +166,7 @@ registry = https://custom-registry.example.com
 
 ```json
 {
-  "lockfileVersion": 3,
+  "lockfileVersion": 5,
   "registryUrl": "https://pspm.dev",
   "packages": {
     "@user/username/skillname": {
@@ -178,6 +183,14 @@ registry = https://custom-registry.example.com
       "gitCommit": "abc1234567890...",
       "gitRef": "main"
     }
+  },
+  "localPackages": {
+    "file:../my-skill": {
+      "version": "local",
+      "path": "../my-skill",
+      "resolvedPath": "/absolute/path/to/my-skill",
+      "name": "my-skill"
+    }
   }
 }
 ```
@@ -202,11 +215,13 @@ project/
 │   │   ├── username/    # Registry skills
 │   │   │   └── skillname/
 │   │   │       └── SKILL.md
-│   │   └── _github/     # GitHub skills
-│   │       └── owner/
-│   │           └── repo/
-│   │               └── path/
-│   │                   └── SKILL.md
+│   │   ├── _github/     # GitHub skills
+│   │   │   └── owner/
+│   │   │       └── repo/
+│   │   │           └── path/
+│   │   │               └── SKILL.md
+│   │   └── _local/      # Local skills (symlinks)
+│   │       └── my-skill -> /absolute/path/to/my-skill
 │   └── cache/           # Tarball cache
 ├── .claude/
 │   └── skills/          # Symlinks for claude-code agent