Commit Graph
2445 Commits
Author SHA1 Message Date
Willie 4a2ff0dcde fix(ui): keep Skillshare-installed Pi plugins out of Pi packages
A plugin Skillshare installs from a Git source and binds only to Pi
landed in the "Pi packages" list, which is meant for packages Pi
installs itself (npm:/git: identifiers with no recorded source). The
list now also requires that neither the package nor any binding has a
source, so such plugins stay under "Managed by Skillshare".

The Pi target's Extensions tab titled those same plugins by their
local state path (local:.../skillshare-<hash>/content), which does not
say which plugin it is. The server already returns the plugin name as
managedBy; use it as the card title, keeping the path in the tooltip
and details.
2026-10-04 22:50:10 +08:00
Willie 9f39b2458e Merge pull request #397 from runkids/runkids/395-status-agent-filters
fix(status): expect only the agents a target would sync
2026-10-04 22:33:57 +08:00
Willie b8a39f373a Merge pull request #396 from runkids/runkids/codex-portable-manifest-version
fix(plugin): expect the version Codex reads from a portable manifest
2026-10-04 22:33:39 +08:00
Willie 27cece3f24 Merge pull request #398 from runkids/runkids/wiki-track-codex-review
docs(wiki): follow Codex's first review right after opening a PR
2026-10-04 22:29:11 +08:00
Willie 640e853c99 fix(status): count only links for agents the target expects
countAgentLinksAndBroken counted every healthy .md link in the target,
so a leftover link for an agent the target no longer syncs could stand
in for a missing expected one and hide drift. status and doctor now
count a link as linked only when its name is an expected agent; broken
links are still reported regardless of name.

Refs #395, Codex review on #397.
2026-10-04 22:28:35 +08:00
Willie f5a2470276 fix(plugin): keep the Codex logo under a portable manifest
Adopting the portable root plugin.json replaced the whole Codex target
info, dropping the interface.logo read from .codex-plugin/plugin.json.
Codex still overlays that native manifest, and the portable one rarely
names a logo, so the add/list UI fell back to a generic icon.

Refs Codex review on #396.
2026-10-04 22:24:12 +08:00
Willie 47a98b81ff fix(status): expect only the agents a target would sync
status counted every discovered agent against each target, while sync
agents writes only the agents left after .agentignore, the target's
include/exclude and the frontmatter targets field. A target that leaves
some agents out was reported as N/M with drift after a complete sync,
in the table and in --json, in global and project mode. doctor and the
dashboard already filtered per target.

status now applies the same three filters before counting and expecting.
The table reports an invalid include/exclude as an error, like it does
for skills; --json falls back to the active agents.

Refs #395
2026-10-04 22:21:00 +08:00
Willie ad7a518420 docs(wiki): follow Codex's first review right after opening a PR
The polling instructions read as applying only after an `@codex review`
comment, so an agent could open a pull request and hand Codex's initial
findings back to the user instead of following them up itself.
2026-10-04 22:19:22 +08:00
Willie 04c4c95cba fix(plugin): keep version check for versionless portable manifests
A portable root plugin.json without a version left the Codex binding's
version empty, which skips the post-update version check, so an update
could advance the snapshot while Codex still ran an older copy. Codex
reports 1.0.0 for such a manifest, so expect that instead.

Refs Codex review on #396.
2026-10-04 22:18:57 +08:00
Willie 021e0037b6 fix(plugin): expect the version Codex reads from a portable manifest
Codex 0.159 installs from a portable root plugin.json (agent-plugins.org
schema) ahead of .codex-plugin/plugin.json, and reports 1.0.0 when that
manifest has no version. Skillshare preferred .codex-plugin/plugin.json,
so updating a package that ships both (ponytail 4.10.3) failed with
"native update returned version 1.0.0; expected 4.10.3" on every sync.
2026-10-04 22:14:28 +08:00
Willie a265155844 Merge pull request #392 from runkids/runkids/391-extension-agent-status
fix(status): count extension-converted agents as synced
2026-10-04 20:12:07 +08:00
Willie c43bb763f9 fix(status): count one extension output per agent
Two agents that flatten to the same name matched the same manifest entry
and were both counted, so status could report 2/2 with one output on
disk. Each manifest key now satisfies one agent.

Refs Codex review on #392.
2026-10-04 20:01:51 +08:00
Willie aca1438fb5 Merge remote-tracking branch 'origin/runkids/391-extension-agent-status' into runkids/391-extension-agent-status 2026-10-04 19:49:55 +08:00
Willie 51a3be1ca6 fix(status): report drift when an extension agent's source changed
Counting an extension output as synced from its output hash alone missed
the common case: the user edits the agent in the source and runs status
to see whether a sync is due. The output still matched the manifest, so
status, doctor and the dashboard reported no drift although the next
sync would regenerate it.

Sync now records a SHA-256 of the source each output was converted from
in the manifest (sources), and status counts an output only when both
the output and that fingerprint are current. Outputs recorded by earlier
releases have no fingerprint and count as current until the next sync
records one, so upgrading does not show the 0/N the report was about.

Refs #391, Codex review on #392.
2026-10-04 19:49:29 +08:00
Willie d589e4f92f Merge branch 'main' into runkids/391-extension-agent-status 2026-10-04 19:46:28 +08:00
Willie d8c1437234 Merge pull request #393 from runkids/runkids/ignore-local-feedback
fix(server): report toggles that .local ignore rules override
2026-10-04 19:46:02 +08:00
Willie af7654712c fix(server): log a disable that a .local rule overrides
When a "!" rule in .skillignore.local overrode a single disable, the handler
returned 409 before its only ops log call, although AddPattern had already
written the pattern to .skillignore. The shared file changed with no trace in
the log. Log the attempt with status "error" and the reason before returning.
2026-10-04 19:40:44 +08:00
Willie d4c2f6e9a0 fix(server): report toggles that .local ignore rules override
Disabling a skill only checked that its path was written to .skillignore.
A "!" rule in .skillignore.local is applied after that file, and an
unanchored one such as "!feature-radar" re-includes every path segment with
that name, so the skill stayed enabled while the dashboard reported success.
The dashboard also never showed the .local file, so nothing explained why.

Single and batch toggles now re-discover after writing and report an item
that did not reach the requested state as failed, naming the overriding
file; the batch toast shows the first failure's reason. GET /api/skillignore
and /api/agentignore return the .local file, and Settings > Files shows its
rules above the editor.
2026-10-04 19:34:24 +08:00
Willie 6cc10220be fix(ui): make the mixed folder switch read as partly on
The tree pane's folder switch showed a partial state by only centering the
knob on the off-colored track. On a 34px track that looked like a stuck or
broken off switch. Give the mixed state a half-tone track and a dash in the
knob, the way an indeterminate checkbox reads.
2026-10-04 19:34:24 +08:00
Willie f403ea5a6f fix(status): count extension-converted agents as synced
An agent target with an extension writes each agent under output_ext
(reviewer.toml) with transformed content, and the manifest tracks that
output name. status, doctor and the dashboard's Sync tab counted synced
agents by looking for the source name and comparing with the source
content, so every converted agent was missing: status showed 0/N with
drift, doctor said the same, and the Sync tab kept them pending after a
successful sync.

For an extension target, count an agent as synced when the manifest
tracks an output with the same stem and that file still matches its
recorded hash. Matching by stem avoids loading the extension spec in
status paths. doctor keeps reporting leftover broken links for these
targets.

Refs #391
2026-10-04 19:33:50 +08:00
Willie 7ed49191a9 Merge pull request #388 from runkids/release-please--branches--main
chore(main): release 0.24.4
v0.24.4
2026-10-04 18:28:20 +08:00
Willie 534ae9793c docs(changelog): describe 0.24.4 from the user side
Replace the generated commit list with what each fix changes for the user, with the command that applies it.
2026-10-04 18:22:09 +08:00
github-actions[bot] 0e23aa7e06 chore(release): synchronize release metadata 2026-10-04 09:30:54 +00:00
github-actions[bot] 7d8b69deb4 chore(main): release 0.24.4 2026-10-04 09:30:51 +00:00
Willie b58d510ec6 Merge pull request #389 from runkids/runkids/skip-target-dotdirs-in-source
fix(sync): skip nested target dotdirs when discovering source skills
2026-10-04 17:30:27 +08:00
Willie 881d08e52e fix(sync): skip nested target dotdirs when discovering source skills
Installing a repo whose root is a skill copies the whole repo into the
source, including any .claude/skills/ the author keeps for their own
development. Install discovery already skips target dotdirs, but the
source walk used by sync, check, and the dashboard only skipped .git,
so those dev-only skills surfaced as nested skills and were synced to
every target.

Share the skip set through sourcewalk and apply it in both source
walks. Only dotdirs nested below the source root are skipped: host-style
paths directly under the root (.cursor/skills/*) stay visible because
they drive target inference.
2026-10-04 17:11:53 +08:00
Willie 417a674409 Merge pull request #387 from runkids/runkids/memory-guidance-scopes
fix(memory): say which notes belong in project versus shared memory
2026-10-04 16:57:44 +08:00
Willie b466a06d11 fix(memory): scope the global examples to cross-project facts
The global block still offered "a decision with its reason" and "a
pitfall you confirmed" as things that belong in it, so a project
decision matched both blocks. The examples are now per scope: the global
ones name user preferences, decisions that apply across projects, and
pitfalls in a tool; the project ones stay project-bound. Both rules take
the examples as a parameter instead of a string replacement.

Refs Codex review on #387.
2026-10-04 16:54:05 +08:00
Willie 91ad0cba3a fix(memory): say which notes belong in project versus shared memory
An agent that reads both a global and a project guidance block saw the
same body twice, with two "save it here", and had to guess whether a
user preference or a project decision went to the shared folder or the
project one. Each block now says what belongs in it: the global block
points project notes at a project memory when one exists, and the
project block keeps project notes and says that notes about the user,
their tools, or other projects do not belong in it. The project block's
examples follow suit, so it no longer names "a stated user preference".

The active rule's two overlapping sentences on when to save are merged
into one, and the plugins reference describes the older Codex.app path
without reference to current events.
2026-10-04 16:47:48 +08:00
Willie ebd26a8ef5 Merge pull request #386 from runkids/release-please--branches--main
chore(main): release 0.24.3
v0.24.3
2026-10-04 16:02:21 +08:00
Willie 21cec976c8 Merge branch 'main' into release-please--branches--main 2026-10-04 15:41:38 +08:00
Willie 2a60fe8c60 docs(changelog): write the 0.24.3 entry for users
Rewrites the generated notes as user-facing entries with examples, drops
the duplicate Performance line that the #384 merge commit produced, and
syncs the website changelog.
2026-10-04 15:36:11 +08:00
Willie 1865e8e627 docs(i18n): translate the doctor Source link check
#385 documented the new Source link info row and its --json check in
the English doctor page only; the ja, ko, zh-Hans and zh-Hant pages now
carry the same row and paragraph.
2026-10-04 15:36:00 +08:00
github-actions[bot] 811d7af1f1 chore(release): synchronize release metadata 2026-10-04 07:16:41 +00:00
github-actions[bot] 5dd8ef0398 chore(main): release 0.24.3 2026-10-04 07:16:38 +00:00
Willie 70cb287672 fix(plugin): find the Codex CLI the desktop app ships (#383)
* fix(plugin): find the Codex CLI the desktop app ships

Plugin commands ran the bare name `codex` from PATH, so a machine with only
the Codex desktop app, or a scheduled job started with a minimal PATH,
reported the CLI as missing. The account-only `cli` override did not help:
the default codex target cannot set it, and an absolute path in a config
shared between macOS and Windows is wrong on one of them.

When `codex` is not on PATH, look in Homebrew's folders and the CLI the app
installs (Codex.app on macOS, %LOCALAPPDATA%\OpenAI\Codex\bin on Windows).
SKILLSHARE_CODEX_CLI overrides the search on one machine without touching
the synced config. The missing-CLI error now lists every place searched, in
the CLI and the dashboard.

Refs #338

* docs(plugin): note where Skillshare finds the Codex CLI

The plugin reference and the sharing guide still said every native CLI must
be on PATH, and the built-in skill told agents a missing CLI has no
fallback. Codex now has one, plus a machine-local override that agents
should prefer over a path in a shared config.

Refs #338

* fix(plugin): look for the Codex CLI inside ChatGPT.app

Since the Codex desktop app merged with ChatGPT, macOS installs it as
ChatGPT.app, so an app-only Mac with a minimal PATH still reported Codex as
missing. Try ChatGPT.app before Codex.app in /Applications and
~/Applications, the order Codex's own desktop-app finder uses.

Refs #338

* fix(plugin): run the packaged CLI entrypoint of the ChatGPT app

ChatGPT Desktop 26.924 removed Contents/Resources/codex and ships the CLI
at the entrypoint its package manifest declares, codex-cli/bin/codex, so a
current app-only Mac still reported Codex as missing. Try that entrypoint
first in each app bundle and keep the old path for earlier builds.

Refs #338

* fix(plugin): find the Codex CLI from the Windows installer

The official PowerShell installer puts codex.exe in
%LOCALAPPDATA%\Programs\OpenAI\Codex\bin and adds it to the user PATH. A job
started without that PATH missed it, the same gap Homebrew's folders cover
on macOS. Try it before the desktop app's copy.

Refs #338

* fix(plugin): keep an account's cli even when it is codex

The Codex search ran whenever the executable was the bare name codex, so an
account that set cli: codex could get SKILLSHARE_CODEX_CLI or the app's CLI
instead, against the documented rule that an account's own cli is kept.
Search only when no account cli is set.

Refs #338
2026-10-04 15:16:14 +08:00
Willie 8c60f51b9f feat(source): add the sourcewalk walker and sourcefs write boundary for proposal 274 (#385)
Implements rollout steps 1 and 2 of proposals/274-skillfollow.md. Nothing follows a link or parses .skillfollow yet.

Step 1: doctor reports first-level symlinks and junctions in the skills source as info, in text and JSON, without following them.

Step 2a: internal/sourcewalk owns traversal of the skills source. Thirteen raw walks move onto it with identical behavior, and a go/parser ratchet fails the tests on any new unclassified walk.

Step 2b: internal/sourcefs wraps an os.Root opened at the skills source and refuses any write whose path has a link component. The six write sites the proposal found in review move onto it, including the cross-device copy fallback, and a second ratchet covers raw os write calls. The only behavior change is that an explicit path crossing a link inside the source is refused instead of written through.

Refs #274

Release-As: 0.24.3
2026-10-04 15:15:43 +08:00
Willie 63a3df9213 Merge pull request #384 from runkids/runkids/memory-guidance
perf(memory): tell agents to prefer shared notes over tool memory
2026-10-04 15:06:51 +08:00
Willie 3a83de16d5 fix(memory): say passive mode still saves notes on request
The --update-mode help described passive as only pointing facts out,
which dropped the on-request saving that the generated rule, dashboard,
and docs all keep.

Refs Codex review on #384.
2026-10-04 14:58:07 +08:00
Willie 464d2fab73 fix(memory): route lessons to LEARNED.md in active guidance
The active rule asked for one fact per file, while init still creates
LEARNED.md as a multi-lesson log and the docs tell users to have agents
update it. The rule now says which goes where: a fact or decision gets
its own file linked from INDEX.md, a lesson from a failure gets a new
heading in LEARNED.md.

Refs Codex review on #384.
2026-10-04 14:53:39 +08:00
Willie 9ea51b1890 docs: fix stale facts and conflicts found by a prompt audit
- The LEARNED.md starter said to update only on request, which
  contradicted the active memory guidance; it now defers to the guidance.
- website/AGENTS.md hardcoded a command-page count that had drifted and
  omitted the Desktop App navbar item.
- wiki/testing.md gave `bash -c` and `bash -lc` as the rule in different
  places; it now says which container needs which, and why.
- Migration-relative wording in wiki/architecture.md and an unexplained
  "Always use" in the targets reference are stated as current rules with
  their reason.
2026-10-04 14:45:38 +08:00
Willie 9ac9682dcc perf(memory): tell agents to prefer shared notes over tool memory
The generated guidance block defined "what is worth saving" the same way
agents' built-in memory does, but never said how the two relate, so agents
with their own memory kept saving there and left the shared folder alone.
The active rule now says to save here instead of tool-specific memory,
gives a note format and an INDEX.md line shape, and both modes read
INDEX.md at the start of each task instead of "when relevant". The
passive rule asks agents to point out facts worth keeping so the user
can ask for them to be saved.

Dashboard mode descriptions, the CLI help, and the website pages are
updated to match. Test fixtures that anchored on "Read only" follow the
new wording.
2026-10-04 14:45:38 +08:00
github-actions[bot]andWillie c6a5267a86 chore(main): release 0.24.2 (#382)
* chore(main): release 0.24.2

* chore(release): synchronize release metadata

* docs(changelog): describe the 0.24.2 download speedup for users

Release Please lists the raw commit subject; the changelog explains user-visible changes in prose with an example, like earlier entries.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Willie <egg358358@gmail.com>
v0.24.2
2026-10-04 14:11:52 +08:00
Willie 887461b36a perf(upgrade): download release assets over parallel ranges (#381)
* perf(upgrade): download release assets over parallel ranges

release-assets.githubusercontent.com throttles each connection on some
networks. The 9.6 MB darwin_arm64 archive took 122-171 s over one
connection but 25 s as 8 ranges, each on its own connection, with an
identical checksum. `skillshare upgrade` and the first `skillshare ui`
of a new version both waited minutes on that download.

DownloadToFile probes with `Range: bytes=0-0`; a 206 answer splits the
file into ranges fetched in parallel from the redirected URL, and a 200
answer streams the single response as before, so servers without range
support cost no extra request. Size limits and checksum verification are
unchanged.

The UI asset download is about 2 MB now, so the docs no longer say 1 MB.

* fix(upgrade): keep the caller's transport for parallel ranges

Each range built its client from http.DefaultTransport, so a caller's
custom transport (private CA, authenticated proxy, custom dialer) only
applied to the probe. The ranges then failed or bypassed the caller's
network setup even though the probe succeeded. Each range now copies the
caller's client with a clone of its *http.Transport, which keeps those
settings and still gives the range its own connection. A transport that
cannot be cloned is shared as is.
2026-10-04 14:03:46 +08:00
Willie 61c366b391 docs(proposals): opt-in .skillfollow for declared source links (#369)
Adds proposals/274-skillfollow.md: an opt-in .skillfollow file that lets discovery follow declared first-level links in the skills source, so a tracked repo can live in the user projects directory. Without a .skillfollow, behavior does not change. The proposal answers the three requirements set in #274: a single source walker with a ratchet test, a three-part link ownership contract, and git staging and update rules for followed repos. Writes to the source go through an os.Root handle. Windows junction behavior was verified on a real machine.

Refs #274
2026-10-04 13:52:53 +08:00
Willie fd9b1fadb2 docs(readme): drop the retired Go Report Card badge
The service is retired and the badge now only shows a retired label.
2026-10-04 13:37:36 +08:00
Willie cb0b5a5d39 style(ui): keep the Files panel tabs inside the card at the narrower width
Narrowing the side columns made the English Field/Structure/Changes tabs
overflow the 240px panel. Split the tabs evenly with tighter padding,
trim the file list further and give the expanded dialog's panel more
room.
2026-10-04 13:37:33 +08:00
Willie bdbaa5517c docs(readme): show total download count badge
Surface release download totals next to the existing release badge in
every README translation.
2026-10-04 13:32:45 +08:00
Willie 816f23227d style(ui): widen the editor column on the Files settings tab
The file list and field panel took more width than they needed and left
the YAML editor cramped. Narrow both side columns so the editor gets the
extra space.
2026-10-04 13:32:45 +08:00
github-actions[bot]andWillie 00b66348e0 chore(main): release 0.24.1 (#375)
* chore(main): release 0.24.1

* chore(release): synchronize release metadata

* docs(changelog): describe 0.24.1 for users

Replace the generated commit list with what each change means for users: the memory update modes with the CLI example, the config layout, the Pi project override, the audit config-key fix and the dashboard hooks count.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Willie <egg358358@gmail.com>
v0.24.1
2026-10-04 12:04:26 +08:00