Willie ccc0fbdf74 feat(pi): manage individual extensions per target (#350)
* feat(pi): manage individual extensions per target

Keep package lifecycle in Plugins while letting global, account, and project Pi targets configure individual extensions with reviewed, lossless changes. Project overrides save only project settings and never grant trust.

Bind edits to native version contracts, settings snapshots, source ownership, and discovery; preserve unrelated resources and enforce renewable native locks, stale rejection, and backups. Verify Pi 0.99.2 and 1.0.0 without running extension factories.

Simplify configured-state UI and distinguish Skillshare-managed packages from native tool registrations, with localized guidance and regression coverage. Closes #342.

* fix(pi): address project extensions review findings

Keep exact project delta rules visible when their extension files are missing so users can remove stale rules without changing global settings or trust.

Show the project Extensions tab only when its generated Pi target resolves. Cover missing and agents-only projects, absent targets, and another project target with regression tests.

* fix(pi): recognize official Windows account launchers

Accept pi.cmd and pi.exe account launcher names on Windows, including case-insensitive and native Windows paths, before probing the existing exact-version gate. Preserve POSIX behavior and never probe unrecognized forks or stacked launcher suffixes.

Add platform-name and account-gate regressions covering verified, unsupported, and missing CLI versions. Focused race tests, make check, and Windows amd64/arm64 test cross-compilation pass; real Windows runtime remains unverified because the UTM guest is stopped.

* fix(pi): align rule removal and backup descriptions

Offer Remove rule only for owned exact +/- rules, not project delta globs that the apply path cannot remove. Keep supported glob rows switchable and cover delta and deltaOnly forms with RED/GREEN regressions.

Describe retained artifacts as extension-list and file-hash records rather than complete settings backups in English, all four website translations, and the implementation report.

* fix(pi): discard records for aborted extension applies

Require a validated preview and owned native lock before recording an extension change. Discard only the newly created record if final revalidation, lock ownership, or the atomic settings write fails; retain successful history and propagate cleanup errors with the original failure.

Keep discovery revalidation after record I/O so cleanup does not weaken the write-boundary guard. Cover global and new/existing project settings with nine RED/GREEN regressions, including injected commit failures. Align English and translated docs with the retained-record lifecycle.

* fix(pi): retain anonymous global packages in projects

Keep ordered anonymous registrations separate from the proven-identity map so unsupported query-bearing sources remain visible as redacted read-only packages, rather than being dropped or associated with a project override.

Preserve first-global-entry precedence for known identities. Add RED/GREEN coverage for string and object registrations, query/userinfo redaction, project entries, zero-write refusal, ordering, and continued editing of known packages.

* fix(pi): deduplicate only proven project identities

Exclude unresolved identities from project duplicate tracking. Preserve each anonymous registration as sourceUnknown instead of pretending unrelated query-bearing URLs are the same package.

Cover mixed string/object anonymous project sources, redaction and zero-write refusals, retained anonymous globals, and last-project-entry precedence for known packages. Verify known project entries remain editable.

* fix(pi): guard unresolved package precedence

An unresolved earlier global registration may own a later known package, and an unresolved later project registration may supersede an earlier known entry. Keep those potentially shadowed entries and inherited deltas Unknown/read-only instead of offering edits to ignored registrations. Do not infer identities by dropping credentials or queries.

Cover both ordering directions for global, inherited, project-owned, and delta views with RED/GREEN tests. Execute native query identity and dedupe evidence on Pi 0.99.2 and 1.0.0 through core and CLI-bundle contracts, now 28 scenarios and 87 assertions each. Align docs and evidence while retaining independent anonymous entries.

* fix(pi): propagate unreadable source ambiguity

Treat badSource entries as unresolved instead of letting an unreadable source expose editable later global registrations. Preserve the same uncertainty in inherited globals and before unreadable later project entries.

Add twelve global/inherited/project regressions for null, empty, whitespace and invalid UTF-8 sources. Native core and CLI-bundle evidence confirms invalid UTF-8 can decode to and own the same identity as a later valid source on both supported Pi versions; the executed contracts now pass 29 scenarios and 90 assertions.

* feat(pi): preserve filtered imports and reclaim stale locks

Adopt native object registrations without changing their configured resources. Keep lossless entries in scoped private state, retain current rules across lifecycle operations, restore filters before native installation, and preserve pending retries after failures.

Reclaim only unchanged empty directories after the native stale threshold, retaining renewed, replaced, nonempty and non-directory locks. Verify exact supported Pi contracts and keep unsupported cases read-only.

* docs(pi): record filtered import verification after branch sync

Document the current merged UI test count and repeated checks while retaining the native and visual verification limitations.

* docs(pi): clarify stale acquisition exception

Keep the lock safety summary consistent with the approved acquisition policy while preserving strict ownership for renewal and release.

* fix(pi): keep legacy npm fallback installations unknown

A missing user-scoped managed npm root cannot prove a package is absent because native Pi may use a legacy global npm or pnpm root. Keep it read-only without probing host-global state, while retaining missing-state behavior for project npm packages.

* fix(pi): preserve project precedence and batch restore ownership

Retain empty winning overrides when deleting them could expose older resource filters. Advance filtered restore batches only to exact writes made by the same Apply, while rejecting external changes and retaining failed native retries. Match Pi strict-false autoload semantics instead of treating null as a delta.
2026-10-03 20:47:20 +08:00
2026-10-02 03:46:48 +08:00
2026-09-25 02:32:37 +08:00
2026-01-14 18:09:36 +08:00
2026-09-25 02:32:37 +08:00

skillshare

skillshare

English · 日本語 · 한국어 · 简体中文 · 繁體中文

Website License: MIT Release Platform Go Report Card Ask DeepWiki Support skillshare on Ko-fi

Star on GitHub

runkids%2Fskillshare | Trendshift

Your AI coding setup, everywhere.
Manage skills, agents, rules, MCP connections and hooks in one place.
For Claude Code, Codex, Pi, OpenCode and more.

Website • Install • Quick Start • Highlights • Screenshots • Desktop App • Docs

skillshare demo

Note

Latest: v0.23.0 — manage and sync native hooks in global and project scope; choose which MCP tools reach the model with tools.allow and tools.deny; and use the dashboard's new Hooks page and MCP tool picker to configure them. All releases →

Why skillshare

Switching AI tools should not mean rebuilding your setup. skillshare gives your skills and other AI resources a home you control.

  • Switch tools, keep your skills — edit once, then sync to Claude Code, Codex, Pi and the other tools you use.
  • Take your setup with you — version your source in Git and pull it onto another machine.
  • Share with your team — keep project resources with your code and distribute shared skills through tracked repositories.

One teammate uses Claude Code, another uses Codex. Keep their shared code-review checklist in .skillshare/ alongside the project. New teammates install the declared skills and sync to the configured tools instead of copying instructions from chat. Team onboarding →

Use the desktop app or CLI to manage everything locally, audit skills before use, and choose what each tool receives.

Coming from another tool? Migration Guide · Comparison

CLI and UI Preview

Skill Detail Security Audit
CLI sync output CLI install with security audit
UI Dashboard UI Skills
Web dashboard overview Web UI skills page

Installation

Tip

Use skillshare from your desktop. Get Skillshare App for macOS (Apple Silicon), Windows and Linux. First launch helps you install or locate the CLI, choose your AI tools and run your first sync. Installation guide.

Desktop App — visual setup and daily management

Skillshare App puts skills, agents, MCP and hooks in a desktop window. Install the app, open it, and follow first-launch setup.

macOS (Apple Silicon), with Homebrew:

brew tap runkids/tap
brew install --cask skillshare-app

Windows / Linux, or a manual macOS install: Download the latest app installers. See the Desktop App guide for platform details.

CLI: macOS / Linux

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

The script installs to ~/.local/bin by default, so normal installs and updates do not need sudo. If the installer prints PATH setup instructions, follow them before running skillshare. Add the suggested line to your shell config (such as ~/.zshrc or ~/.bashrc) for future terminals. Set INSTALL_DIR to use another location.

Windows PowerShell

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

CLI: Homebrew

brew install skillshare

Tip: Run skillshare upgrade to update to the latest version. It auto-detects your install method and handles the rest.

GitHub Actions

- uses: runkids/setup-skillshare@v1
  with:
    source: ./skills
- run: skillshare sync

See setup-skillshare for all options (audit, project mode, version pinning).

Shorthand (Optional)

Add an alias to your shell config (~/.zshrc or ~/.bashrc):

alias ss='skillshare'

Quick Start

skillshare init            # Create config, source, and detected targets
skillshare sync            # Sync skills to all targets

How It Works

  • macOS / Linux: ~/.config/skillshare/
  • Windows: %AppData%\skillshare\
┌─────────────────────────────────────────────────────────────┐
│                    Source Directory                         │
│   ~/.config/skillshare/skills/    ← skills (SKILL.md)       │
│   ~/.config/skillshare/agents/    ← agents                  │
│   ~/.config/skillshare/extras/    ← rules, commands, etc.   │
└─────────────────────────────────────────────────────────────┘
                              │ sync
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │  OpenCode │   │ OpenClaw  │   ...
       └───────────┘   └───────────┘   └───────────┘
Platform Skills Source Agents Source Extras Source Link Type
macOS/Linux ~/.config/skillshare/skills/ ~/.config/skillshare/agents/ ~/.config/skillshare/extras/ Symlinks
Windows %AppData%\skillshare\skills\ %AppData%\skillshare\agents\ %AppData%\skillshare\extras\ NTFS Junctions for folders (no admin required); file symlinks need Developer Mode, otherwise copied
Imperative (install-per-command) Declarative (skillshare)
Source of truth Skills copied independently Single source → symlinks (or copies)
New machine setup Re-run every install manually git clone config + sync
Security audit None Built-in audit + auto-scan on install/update
Web dashboard None skillshare ui
Runtime dependency Node.js + npm None (single Go binary)

Full comparison →

Highlights

Install & update skills —from GitHub, GitLab, or any Git host

skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy  # if symlinks don't work

Symlink issues? — switch to copy mode per target

skillshare target <name> --mode copy
skillshare sync

Security audit —scan before skills reach your agent

skillshare audit

Project skills —per-repo, committed with your code

skillshare init -p && skillshare sync

Agents —sync custom agents to agent-capable targets

skillshare sync agents            # sync agents only
skillshare sync --all             # sync skills + agents + extras + MCP + hooks together

Extras —manage rules, commands, prompts & more

skillshare extras init rules          # create a "rules" extra
skillshare sync --all                 # sync skills + agents + extras + MCP + hooks together
skillshare extras collect rules       # collect local files back to source

MCP connections —configure once for Claude Code, Codex, Pi, VS Code, OpenCode and more

skillshare mcp add                    # guided URL or JSON setup
skillshare sync mcp --dry-run         # preview native configuration changes
skillshare sync mcp                   # apply connection settings

Keep definitions in config.yaml or reference a separate mcp.yaml. See MCP setup for examples, environment references and importing existing connections.

Manage native hooks without executing them:

skillshare hooks add check --file ./check.yaml
skillshare hooks sync --dry-run
skillshare hooks sync

Plugins —install a complete plugin and pick which tools receive it

skillshare plugin add                 # guided: source, plugin, targets, review
skillshare plugin add owner/repo --target claude --target codex --no-tui
skillshare sync plugins --dry-run     # plugins sync separately from sync --all

Existing native installations can be adopted with plugin import. See Manage plugins across tools.

Shell completion —tab-complete commands, flags, and subcommands

skillshare completion bash --install   # also: zsh, fish, powershell, nushell

Local checkpoints — commit source changes without pushing

skillshare commit -m "Update review skill"
skillshare commit --dry-run

Web dashboard — visual control panel

skillshare ui

All commands & guides →

Contributing

Contributions welcome! Open an issue first, then submit a draft PR with tests. See CONTRIBUTING.md for setup details.

git clone https://github.com/runkids/skillshare.git && cd skillshare
make check  # format + lint + test

Tip

Not sure where to start? Browse open issues or try the Playground for a zero-setup dev environment.

Contributors

Thanks to everyone who helped shape skillshare.

leeeezx Vergil333 romanr xocasdashdash philippe-granet terranc benrfairless nerveband EarthChen gdm257 skovtunenko TyceHerrman 1am2syman thealokkr JasonLandbridge masonc15 richardwhatever reneleonhardt ndeybach hhh2210 leoarry salmonumbrella daylamtayari dstotijn ipruning massukio kevincobain2000 StephenPAdams mk-imagine Curtion amdoi7 jessica-engel AlimuratYusup thor-shuang bishopmatthew chaosky iFwu ildunari aestilog xarthurx m0cun bit3125 eekryuos Bongseop-Kim sophodex PeterTianbuhan dotned ismferd jblackburn21 jnhu76 jacobleft rhysmcneill druellan 12britz askpatrickw Almost42 Brett-Best isCopyman svob michal-grzelak shikbupt LeoYeAI TIR44 Ajaymamtora vishaldialpad kankan0829 dnabb thinhngotony skaurus jamesbraza 2BAB zdlldz elstiaan EriaWalker FaintFlower yantinglin21 chung1912 r-fynn cescox hhdebb Snurppa s0undt3ch danscheer 7zq12lvm-b DarkiT harisonw wuhaoyujerry star-nebula


Support skillshare ❤️

skillshare is free and open source.

If skillshare saves you time, consider buying me a coffee. Every contribution helps with ongoing development, cross-platform testing, documentation, and maintenance.

☕ Buy me a coffee

You can also help by giving skillshare a ⭐ on GitHub!

Star History

Star History Chart


License

MIT

Languages
Go 73.7%
TypeScript 20.2%
JavaScript 3%
Shell 1.4%
CSS 0.9%
Other 0.7%