Commit Graph
500 Commits
Author SHA1 Message Date
Willie 269f18b5e6 docs(instructions): note Cmd+S on the target page and Preview-first card
Refs #299
2026-09-28 14:19:52 +08:00
Willie 2742da5bc8 docs: cover copy updates on save, previews, and hidden empty rule folders
The sharing guide still told users to sync after every edit of a shared
file in copy mode, and did not mention the source/preview switch or that
empty rule folders drop out of the read order.

Refs #299
2026-09-28 14:13:37 +08:00
Willie 42c1051b88 docs: describe Windows file links and the new AGENTS.md controls
The docs said Windows always links with NTFS junctions and needs no admin
rights, which is only true for folders. Explain that single files need
Developer Mode for symlinks and otherwise sync as tracked copies, with the
warning line users will see and the folder-icon symptom from the issue.

Cover the per-target mode picker, the restore preview, changing a target's
file location, the single-column file tab with edit/preview, universal's
file list, and switching back to import. Also correct status and doctor
output that no longer matched the code, and the doctor "Link not
supported" advice, which pointed at Developer Mode although that check
creates a folder junction.

Refs #299
2026-09-28 13:57:40 +08:00
Willie afa8c09758 chore: release v0.21.12 2026-09-28 02:15:18 +08:00
Willie daf77b037f fix(target): keep skills another target still syncs when removing one
Codex and universal both write to ~/.agents/skills. Removing one of them
unlinked that folder, turning the other's synced skills into local
copies it no longer managed. Removal now leaves the folder alone while
another remaining target uses it, in the dashboard, the CLI, the TUI and
the dry-run preview.
2026-09-28 01:58:29 +08:00
Willie ad3d84b76a feat(instructions): manage the files of tools that read universal's skills
With only universal configured, tools such as Codex, Gemini CLI and Pi
still read skills from ~/.agents/skills, but none of them reads
~/.agents/AGENTS.md, and their own instruction files had no page and
could not take a shared AGENTS.md. Universal's AGENTS.md tab now offers
the installed ones in a dropdown, and the shared AGENTS.md list includes
them. A tool is listed once per file and disappears when it becomes a
target of its own.

Cline and the Warp Agent CLI read ~/.agents/AGENTS.md itself, per their
docs, so they now share universal's file.
2026-09-28 01:36:42 +08:00
Willie 95f168feda fix(upgrade): say how to take back a skill left owned by root
Before v0.21.10 an upgrade that needed sudo wrote the built-in skill as
root, so every later skill upgrade failed with a bare "permission
denied". The error now adds the chown command for the skills source.
2026-09-28 01:36:42 +08:00
Willie 682d142a3d chore: release v0.21.11 2026-09-27 23:22:03 +08:00
Willie 31697d9bdb feat(targets): know the instruction files of more targets
Targets without an instructions entry asked the user to type the path,
even when the tool documents a fixed one: universal always reads
~/.agents/AGENTS.md and Pi reads ~/.pi/agent/AGENTS.md. Paths for 20
more targets come from each tool's official documentation; targets
whose file is undocumented or changing are left for the user to set.
2026-09-27 23:03:21 +08:00
Willie c1596262d5 build(website): compile the docs with Rspack
The docs build spent over five minutes in webpack for five locales.
@docusaurus/faster swaps in Rspack and SWC and cuts a local build from
161s to 25s, with the same pages and an identical search index.

Rspack orders one Infima rule after the search box's padding, which
pushed the navbar items right; custom.css restores the padding.
2026-09-27 19:28:48 +08:00
Willie da95f9cb15 chore: release v0.21.10 2026-09-27 19:01:43 +08:00
Willie 5d1f1dc724 fix(mcp): write pi-mcp-adapter servers to mcp-adapter.json
pi-mcp-adapter 3.0 no longer reads Pi's mcp.json, which it leaves to
Pi's upcoming built-in MCP support, and reads mcp-adapter.json in the
same folder instead. Servers synced for the adapter were landing in a
file it ignores, so they stopped loading.

Adapter servers now go to mcp-adapter.json in the global, project and
account folders; pi-mcp-extension still reads mcp.json. The next sync
removes the entries Skillshare had written to mcp.json and leaves the
user's own. If the user already renamed the file as Pi's warning
suggests, Skillshare keeps owning the entries that arrived unchanged
instead of reporting them as someone else's. Import and the unmanaged
scan read both files.

Refs #298
2026-09-27 18:05:26 +08:00
Willie 8399e06d07 docs: describe the single-panel AGENTS.md tab
The guides still walked through the old list and detail page, so the
labels and steps no longer matched the dashboard.

Also fix two Korean bold labels that rendered with literal asterisks:
a closing ** after an ellipsis followed directly by a Hangul particle
is not a valid closing delimiter in CommonMark.
2026-09-27 10:45:25 +08:00
Willie 86fb63fd4b docs: document sharing AGENTS.md from the dashboard
The shared AGENTS.md workflow is dashboard-only, so users had no written
reference for how shared files attach, what restore puts back, or where
drift backups go. Adds a how-to page in every locale, documents
single-file extras and the target `instructions` key, and brings the
translated extras collect section up to date with English.
2026-09-27 04:17:41 +08:00
Willie 779ec26ff5 fix(upgrade): elevate only the binary replacement with sudo
When the binary lived in a root-owned directory, upgrade re-ran the whole
command under sudo. The built-in skill download, UI asset cache, and oplog
then landed in the user's home as root-owned files, and a later git pull
of the skills source failed with "unable to unlink old
'skillshare/SKILL.md': Permission denied".

The sudo child now only receives an internal --replace-binary=<version>
flag that downloads and swaps the binary. The parent waits for it and
does everything else as the invoking user. The needs-password hint shown
by the CLI and dashboard drops its sudo prefix, since a fully root
upgrade reproduces the same breakage.
2026-09-27 02:10:00 +08:00
Willie 55147d9dad docs(changelog): add toolbar and tree icon changes to 0.21.9
The 0.21.9 entry was written before the toolbar was compacted and before
disabled tree items got their own icon, and its folder bullet still
described Group as a separate dropdown.
2026-09-26 22:46:08 +08:00
Willie b1b4eb63b2 docs(changelog): add 0.21.9 entry for folder switches and folder filters
Record the tree view rework, tracked-repo targets and folder grouping from #295, plus the dot-folder sync fix (#294), the Plugins page fix (#296) and the dashboard server crash fix.
2026-09-26 21:29:08 +08:00
Willie 2be314a1dd feat(ui): filter and group skills by folder
Skills installed with --into land in folders, but the list and cards
views could only filter and group by source, so there was no way to
look at one folder at a time or see the folders side by side.

Add a Folder filter next to Targets and a Folder option to Group. A
skill's folder is its parent path, a tracked repo counts as one folder,
and skills at the source root group under "Root". The filter is hidden
when everything lives in one folder. Agents get the same controls.
2026-09-26 21:25:32 +08:00
Willie a7e009bb9e feat(ui): rework the skills tree as a tree with a detail pane
Turning a whole folder or tracked repo off meant ticking every skill
in it, and the tree rows mixed table columns with indentation.

The tree view is now an explorer tree beside a detail pane. Click a
folder, repo or skill to select it; Cmd/Ctrl-click adds, Shift-click
selects a range. The pane turns the whole selection on or off with one
switch, sets its targets (tracked repos included), and lists each skill
with its own switch. Counts and disabled markers show on hover, and the
divider between the two sides can be dragged.

Enable/disable toasts now replace each other through a new toast `key`,
so quick on/off clicks no longer leave an outdated "Enabled" on screen.

Refs #295
2026-09-26 21:02:36 +08:00
Willie bc01ff1b3e feat(server): let tracked-repo skills take dashboard targets
Setting targets on a skill inside a tracked repo used to be refused,
because writing its SKILL.md leaves the clone dirty and `update` then
skips the repo (or `--force` throws the setting away).

Store those targets in the source's .metadata.json instead, keyed by
the skill's path, and apply them at discovery over the frontmatter.
The clone stays clean, `update` keeps working, and the setting survives
it. Uninstalling a repo or skill drops its entries.

Overrides are saved in the same lock section that writes them: every
API request reloads the store from disk, so saving after unlocking
could lose them, and saving outside the lock raced with other writers.

Refs #295
2026-09-26 21:02:28 +08:00
Willie bcd5d2b7bc docs(changelog): add 0.21.8 entry for two-machine git sync 2026-09-25 03:00:15 +08:00
Willie 11ccf30a18 docs(git): describe how pull and push handle two machines
The pages still told users to inspect conflicts with git status and to
fix diverged tracked repos with git pull --rebase, but pull now merges
diverged history, resolves .metadata.json conflicts on its own, and
undoes the merge on any other conflict, so those steps no longer match
what happens. Also documents the Git Sync page fetch, the Pull count,
and the push_rejected API error in every translated locale.
2026-09-25 03:00:15 +08:00
Willie 607befe65c chore: release v0.21.7 2026-09-24 00:15:22 +08:00
Willie 4a2464a712 docs(extras): describe collect --force and copy-mode behavior
Refs #291
2026-09-24 00:05:55 +08:00
Willie 4541cb5a36 chore: release v0.21.6 2026-09-23 01:08:14 +08:00
Willie 33063dee45 docs(ui): describe the MCP tab on a target's page
The Targets row and the -p mode notes did not mention that a target
now lists and switches its MCP servers, nor that its Sync writes every
target's MCP files.
2026-09-23 00:38:44 +08:00
Willie 9fa47f4b9d chore: release v0.21.5 2026-09-22 21:08:51 +08:00
Willie e1bf171528 docs(mcp): describe the Pi settings line and project conflict import
The Pi adapter settings moved from a hover icon to a line on the server
row, and Import from an Agent on a project's conflict now reads that
project's file, so the dashboard descriptions no longer matched.

Refs #289
Refs #290
2026-09-22 20:51:05 +08:00
Willie b561b51457 docs: describe stopping MCP management and unmanaged servers
Also explains how an Agent entry of the same name is taken over.

Refs #290
2026-09-22 19:08:51 +08:00
Willie 41912ba7ab docs: describe in-place sync buttons
Refs #289
2026-09-22 15:17:24 +08:00
Willie bb57a9af9c feat(targets): add account targets for a second Claude, Codex or Pi config directory
A target declared with `agent` and `config_dir` is another config directory of a
built-in Agent, such as a second Claude account. Its skills and agents paths are
derived from the Agent's defaults at load time, so the config only records the
directory. The same target name works for MCP (written in the Agent's format into
the account's own file), for plugins (the Agent CLI runs with CLAUDE_CONFIG_DIR,
CODEX_HOME or PI_CODING_AGENT_DIR) and for `mcp import --from`. Removing such a
target warns when MCP config still names it instead of failing later at sync.

The dashboard gains an "another account" mode in the add-target dialog and lists
accounts next to the Agents on the MCP and plugin pages.

Refs #289
2026-09-22 11:21:35 +08:00
Willie af9439003e chore: release v0.21.4 2026-09-22 02:50:45 +08:00
Willie 78b587c845 docs: name MCP buttons as the dashboard shows them, and fill an upgrade gap
The MCP row on the ui page kept English button names in the translated pages,
next to labels that were already translated, and the English page itself said
Import where the button reads Import from a target. Three locales also lacked
the paragraph on upgrading without a terminal to ask for a password on.
2026-09-22 02:46:04 +08:00
Willie 4b89e81fdd docs: cover the project MCP row, the piOptions box and upgrade progress
The dashboard pages still described the project row without the Agent logos
and the Match the project action, the ui page did not mention where piOptions
is edited, and upgrade did not say the download now reports its progress.

Refs #289
2026-09-22 02:40:02 +08:00
Willie 8b22b2edbc docs(mcp): describe piOptions for pi-mcp-adapter
Refs #289
2026-09-22 02:33:08 +08:00
Willie 8a9fb92ff1 docs(mcp): describe a disabled entry that follows the project's targets
Refs #289
2026-09-22 01:17:59 +08:00
Willie 9824ea54ea docs(mcp): document keeping a server without syncing it
Cover the empty targets list, --target none, how it differs from leaving
targets out, and what the terminal and the dashboard show for it.

Refs #289
2026-09-21 23:21:24 +08:00
Willie 5044b58eea fix(mcp): reuse an OpenCode project config kept in .opencode
OpenCode also loads opencode.json and opencode.jsonc from a project's
.opencode directory. Skillshare looked only at the project root, so a file
kept there was ignored and sync created a second one beside it. It is
resolved the way Kilo Code's .kilo already is: an existing file is reused
wherever it is, a new one goes to the root, and more than one is refused.

Refs #289
2026-09-21 22:23:18 +08:00
Willie b75b4d6e6a docs(mcp): document taking over an entry from a removed config
Also corrects a claim that every conflict offers an import action. One held
by another Skillshare config that still exists offers none, because only
that config can release the entry.

Refs #288
2026-09-21 21:20:52 +08:00
Willie e0c1111b79 feat(plugins): add a plugin without choosing Agents yet
Adding a plugin forced at least one target, so keeping a plugin in
Skillshare for later meant installing it somewhere and then deselecting
every Agent by hand.

A package now records its source, so it stays managed with no Agent
bound. Agents are bound later from the same source, installing it as it
is then. Removing the last Agent keeps such a plugin; removing the
plugin itself drops it. In the terminal picker, confirming with nothing
selected records it, while Esc still cancels.

The plugin list also shows the installed version as a tag, and an
update check shows old -> new for plugins whose source has moved on.
2026-09-21 17:18:03 +08:00
Willie 00d96e15f0 chore: release v0.21.3 2026-09-21 15:58:32 +08:00
Willie 14af37e311 chore: release v0.21.2 2026-09-21 14:19:52 +08:00
Willie 2289058647 docs(agents): document converting agents with an extension
Also drops the note that the dashboard collect page is skills-only; the
target page has collected agents for a while.

Refs #267
2026-09-21 13:31:44 +08:00
Willie 3873f1f060 docs(mcp): describe turning a global server off from mcp.projects
The pages still said a disabled entry cannot target Claude Code, and that the
field is project mode only. Both are lifted: the entry is valid under an
mcp.projects root as well, and for Claude Code the switch goes to
~/.claude.json, where Claude Code keeps its per-project off list, leaving the
server definitions in that file alone. Only the global mcp.servers, where no
project is in scope, still refuses it.

The dashboard sentence was stale from an earlier change: the switch is its own
"Turn off a global server" button beside "Add server", shown in project mode
and on a project's MCP tab, not an option inside the add form.

All four locales follow, naming the buttons as the dashboard shows them there.

Refs #286
2026-09-21 11:08:11 +08:00
Willie b75977135a feat(mcp): turn a global server off for Claude Code from mcp.projects
Claude Code keeps its per-project off list in ~/.claude.json, the same file
its user-scope servers live in. The plan keyed desired entries by file path
alone, so one file could carry only one native target, and mcp.projects had
to refuse a disabled entry for Claude Code rather than write that list.

Key the plan by file and target instead. Apply already rereads the file per
plan, and sectionDigest hashes only the target's own section, so two plans
on ~/.claude.json fold in order without further machinery.

A change now carries the mcp.projects root it belongs to. Its path no longer
says, because a project's off switch is written outside that project folder,
and the dashboard needs the root to keep the switch out of the global server
list and to show a pending badge on the project it came from.

Codex stays refused. It merges the project file field by field, so a switch
for a server its global config lacks leaves an entry with no transport and
stops Codex loading its config at all.

Alongside this, the dashboard gets a named "Turn off a global server" action,
so adding a switch and adding a server are two choices up front rather than
one form that asks afterwards. Two older glitches go with it: a project's
target toggles sprang back while the list was still empty, and the expanded
config editor stayed open when a tab arrived from the URL.

Refs #286
2026-09-21 10:55:37 +08:00
Willie 0b3eedfd6c docs(projects): explain the project lockfile
Teams need to know that skills.lock.json is meant to be committed, which
commands move a pin, and how it relates to the config.yaml manifest.
Covers project-skills, install, update, uninstall, declarative-manifest
and project-setup, in English and the four translated locales.
2026-09-21 04:31:22 +08:00
Willie 1fb23f1e59 feat(analyze): measure what each target actually loads
The analyze numbers were drifting from what tools really see. Symlink-mode
targets expose the whole source folder, so .skillignore'd skills still load
but were left out; merge/copy targets often hold skills the user dropped in
by hand that skillshare never counted; and chars/4 undercounted CJK text by
roughly four times.

Route the CLI, TUI, web handler and sync summary through one
sync.TargetSkills so the three copies of the filter logic cannot disagree
again. Disabled skills stay in the discovery with Disabled=true and are
priced for symlink targets; unmanaged folders in a target are reported as
Local. Token estimates now charge one token per wide rune.

The dashboard keeps the chosen target in the URL so target and project
pages can deep-link into the analysis, lists project targets after own
targets with their tool icon, and tags local/disabled rows. Select gives
single-select icons a key to silence a React warning.
2026-09-21 04:17:26 +08:00
Willie af6a4ad413 docs(i18n): translate the project path cleanup section for ja, ko, zh-Hans, zh-Hant
Keeps the sync reference in every locale in step with the English page,
which now explains why project sync removes leftovers after a target's
default path moves.

Refs #135
2026-09-21 02:56:43 +08:00
Willie 449fe40d6f fix(targets): move goose and openhands to .agents/skills
Both tools now document ~/.agents/skills and <project>/.agents/skills as
their skills locations and keep the old directories only for backward
compatibility. Writing to the old path next to `universal` makes them read
every skill from two places.

Global configs pin absolute paths, so they are unaffected and keep their
overlap warning. Project configs store target names only, so an existing
project follows the new default on its next sync while the links it created
in .goose/skills or .openhands/skills would stay behind and show up as
duplicates. Project sync now removes those leftovers from also_scans
directories that no configured target writes to.

That directory belongs to another tool, so the cleanup runs the prune with
ManagedOnly: only symlinks into the source and manifest-tracked folders are
removed. The flat-name heuristic would otherwise delete hand-made folders
such as `_drafts`. Targets with an explicit path are skipped, and --dry-run
only previews.

Refs #135
2026-09-21 02:55:18 +08:00
Willie b2c1a31a18 docs(i18n): sync antigravity-cli target docs for ja, ko, zh-Hans, zh-Hant 2026-09-21 02:38:35 +08:00