feat(project): register every Git checkout in a workspace with --scan (#958)

Some tools, such as Codex, look for project skills only up to the Git root
of the folder you open. When one workspace folder holds several checkouts
or worktrees, skills synced to the workspace are not seen inside them, and
registering each checkout by hand repeats the same settings many times.

`project add <root> --scan DIR` registers the root and each Git checkout
found below the scan folders as ordinary project entries with the same
settings, in one write. No scan setting is saved; rerun it after a new
clone. It only adds: a checkout already registered with the same settings
is kept, one with different settings or its own .skillshare/ is skipped
with the reason, and a name clash derives the name from the path. A scan
folder that is missing or cannot be read is skipped with a warning so one
unreadable folder does not block the rest. Rows carry a root-relative path
and a skip code so the dashboard can explain them in its own words.

Dashboard:

The dashboard should offer what `project add --scan` does, so a workspace
with many checkouts can be set up without the terminal.

The Add project dialog gains "Also add each checkout inside this folder"
with the folders to look in. Review runs the scan as a dry run through the
new POST /api/projects/scan and lists each folder as Added, Kept or Skipped
with a translated reason and a link to a project whose settings differ;
nothing is written until it is confirmed. The write scans again and counts
what it actually added, so a checkout registered in the meantime is not
reported as new. MCP and Hooks, when picked, are set up for each added
project. Without an explicit storage choice the default follows
projects_storage, as the CLI does without a flag.

Closes #953

Release-As: 0.30.12
This commit is contained in:
Willie
2026-11-19 01:35:56 +08:00
committed by GitHub
parent f9f59b432b
commit 52744e2f34
54 changed files with 2211 additions and 163 deletions
+34 -2
View File
@@ -3,7 +3,8 @@
## Scope
Verify the global `project` CLI: defaults, selection, resource settings, previews,
JSON failures, saved partial sync and retry, and merge/copy/symlink removal.
JSON failures, saved partial sync and retry, merge/copy/symlink removal, and
registering Git checkouts with `--scan`.
Tests use local fixture skills and agents; no network or external repositories.
Native Windows link behavior is outside this Linux acceptance runbook.
@@ -460,8 +461,39 @@ Expected:
- exit_code: 0
- jq: .registration == "removed" and (.detach.removed | length) > 0
### 15. Scan registers checkouts once and a rescan only adds
```bash
set -euo pipefail
ss() { /workspace/bin/skillshare "$@"; }
fixture=$(mktemp -d "$HOME/project-command-XXXXXX")
suite="$fixture/suite"
mkdir -p "$suite/app-a/.git" "$suite/app-b/.git" "$suite/docs" "$suite/.worktrees/app-a" "$fixture/skills/team-alpha" "$XDG_CONFIG_HOME/skillshare"
printf 'gitdir: %s\n' "$suite/app-a/.git/worktrees/app-a" > "$suite/.worktrees/app-a/.git"
printf '%s\n' '---' 'name: team-alpha' 'description: Team fixture' '---' '# Team' > "$fixture/skills/team-alpha/SKILL.md"
cat > "$XDG_CONFIG_HOME/skillshare/config.yaml" <<CONFIG
sources:
skills: $fixture/skills
targets: {}
CONFIG
args=(project add "$suite" --scan . --scan .worktrees --target codex --skills-include 'team-*')
before=$(cat "$XDG_CONFIG_HOME/skillshare/config.yaml")
ss "${args[@]}" -n --json >/dev/null
test "$before" = "$(cat "$XDG_CONFIG_HOME/skillshare/config.yaml")"
ss "${args[@]}" --sync --json >/dev/null
test -L "$suite/.worktrees/app-a/.agents/skills/team-alpha"
grep -q 'name: worktrees-app-a' "$XDG_CONFIG_HOME/skillshare/config.yaml"
ss project edit app-b --target codex,claude --json >/dev/null
mkdir -p "$suite/app-c/.git"
ss "${args[@]}" --json
```
Expected:
- exit_code: 0
- jq: ([.scan[] | select(.result == "added")] | length) == 1 and (.scan[] | select(.root | endswith("/app-c")) | .result) == "added" and (.scan[] | select(.root | endswith("/app-b")) | .result) == "skipped" and ([.scan[] | select(.root | endswith("/docs"))] | length) == 0
## Pass Criteria
All 14 mdproof steps pass with zero failures or skips. JSON steps satisfy their
All 15 mdproof steps pass with zero failures or skips. JSON steps satisfy their
jq assertions, expected rejection/partial-failure steps exit 1, and filesystem
checks prove preview safety, sync scope, retry, detach behavior, and source survival.
+2 -1
View File
@@ -90,11 +90,12 @@ _skillshare() {
# Project command
if [[ "${cmd}" == project ]]; then
local project_subcmds="list show add edit sync remove localize share"
local project_flags="--target --name --skills --no-skills --agents --no-agents --skills-mode --agents-mode --skills-naming --skills-include --skills-exclude --agents-include --agents-exclude --machine-local --shared --sync --dry-run -n --yes --json --help -h --global -g"
local project_flags="--target --name --skills --no-skills --agents --no-agents --skills-mode --agents-mode --skills-naming --skills-include --skills-exclude --agents-include --agents-exclude --scan --machine-local --shared --sync --dry-run -n --yes --json --help -h --global -g"
case "${prev}" in
--skills-mode|--agents-mode) COMPREPLY=($(compgen -W "merge symlink copy" -- "${cur}")); return ;;
--skills-naming) COMPREPLY=($(compgen -W "flat standard prefixed" -- "${cur}")); return ;;
--target) COMPREPLY=($(compgen -W "adal aiderdesk amp antigravity antigravity-cli astrbot augment autohand-code bob claude cline codearts codebuddy codestudio codex comate commandcode continue copilot cortex crush cursor deepagents deepseek-harness devin dexto droid firebender forgecode fx gemini gitlab-duo goose grok hermes iflow jazz junie kilocode kimchi kimi kimi-code kiro kode letta lingma mcpjam mux neovate omp ona openclaw opencode openhands pi pochi posit-assistant purecode qoder qoder-cn qwen reasonix replit roo rovodev tabnine trae trae-cn universal verdent vibe warp windsurf witsy xcode-claude xcode-codex zcode zed zencoder" -- "${cur}")); return ;;
--scan) COMPREPLY=($(compgen -d -- "${cur}")); return ;;
--name|--skills-include|--skills-exclude|--agents-include|--agents-exclude) return ;;
esac
if [[ ${cword} -eq 2 ]]; then
+1
View File
@@ -37,6 +37,7 @@ complete -c skillshare -n '__fish_skillshare_using_command project' -l agents-mo
complete -c skillshare -n '__fish_skillshare_using_command project' -l skills-naming -r -a 'flat standard prefixed'
complete -c skillshare -n '__fish_skillshare_using_command project' -l skills-include -r
complete -c skillshare -n '__fish_skillshare_using_command project' -l skills-exclude -r
complete -c skillshare -n '__fish_skillshare_using_command project' -l scan -x -a '(__fish_complete_directories)' -d 'Also add Git checkouts below this folder'
complete -c skillshare -n '__fish_skillshare_using_command project' -l machine-local -d 'Save a new project on this machine only'
complete -c skillshare -n '__fish_skillshare_using_command project' -l shared -d 'Save in config.yaml, or also remove its copy'
complete -c skillshare -n '__fish_skillshare_using_command project' -l agents-include -r
+1
View File
@@ -77,6 +77,7 @@ export extern "skillshare project" [
--skills-exclude: string
--agents-include: string
--agents-exclude: string
--scan: path
--machine-local
--shared
--sync
+1 -1
View File
@@ -267,7 +267,7 @@ $_skillshareCompleter = {
@{ Name = 'localize'; Desc = 'Keep a copy on this machine only' }
@{ Name = 'share'; Desc = 'Move a machine-only project into config.yaml' }
)
$flags['project'] = '--target', '--name', '--skills', '--no-skills', '--agents', '--no-agents', '--skills-mode', '--agents-mode', '--skills-naming', '--skills-include', '--skills-exclude', '--agents-include', '--agents-exclude', '--machine-local', '--shared', '--sync', '--dry-run', '-n', '--yes', '--json', '--help', '-h', '--global', '-g'
$flags['project'] = '--target', '--name', '--skills', '--no-skills', '--agents', '--no-agents', '--skills-mode', '--agents-mode', '--skills-naming', '--skills-include', '--skills-exclude', '--agents-include', '--agents-exclude', '--scan', '--machine-local', '--shared', '--sync', '--dry-run', '-n', '--yes', '--json', '--help', '-h', '--global', '-g'
if ($cmd -eq 'project' -and $previousIndex -ge 0) {
$values = switch ($elements[$previousIndex]) {
'--skills-mode' { @('merge', 'symlink', 'copy') }
+1
View File
@@ -417,6 +417,7 @@ _skillshare() {
'*--skills-exclude[Replace skills exclude filters]:pattern: ' \
'*--agents-include[Replace agents include filters]:pattern: ' \
'*--agents-exclude[Replace agents exclude filters]:pattern: ' \
'*--scan[Also add Git checkouts below this folder]:folder:_directories' \
'--machine-local[Save a new project on this machine only]' \
'--shared[Save in config.yaml, or also remove its copy]' \
'--sync[Sync after add or edit]' \
+12
View File
@@ -433,6 +433,12 @@ func formatProjectLogPairs(args map[string]any) []logDetailPair {
if targets, ok := logArgStringSlice(args, "targets"); ok && len(targets) > 0 {
pairs = append(pairs, logDetailPair{key: "targets", isList: true, listValues: targets})
}
if scan, ok := logArgStringSlice(args, "scan"); ok && len(scan) > 0 {
pairs = append(pairs, logDetailPair{key: "scan", isList: true, listValues: scan})
}
if added, ok := logArgInt(args, "added"); ok {
pairs = append(pairs, logDetailPair{key: "added", value: strconv.Itoa(added)})
}
if scope, ok := logArgString(args, "scope"); ok && scope != "" {
pairs = append(pairs, logDetailPair{key: "scope", value: scope})
}
@@ -451,6 +457,12 @@ func formatProjectLogDetail(args map[string]any) string {
if targets, ok := logArgStringSlice(args, "targets"); ok && len(targets) > 0 {
parts = append(parts, "targets="+strings.Join(targets, ", "))
}
if scan, ok := logArgStringSlice(args, "scan"); ok && len(scan) > 0 {
parts = append(parts, "scan="+strings.Join(scan, ", "))
}
if added, ok := logArgInt(args, "added"); ok {
parts = append(parts, "added="+strconv.Itoa(added))
}
if scope, ok := logArgString(args, "scope"); ok && scope != "" {
parts = append(parts, "scope="+scope)
}
+8
View File
@@ -426,6 +426,14 @@ func TestFormatProjectLog_ShowsActionAndRoot(t *testing.T) {
}
}
func TestFormatProjectLog_ShowsScan(t *testing.T) {
// Args as read back from operations.log: JSON numbers decode as float64.
e := oplog.Entry{Command: "project", Args: map[string]any{"action": "add", "root": "~/work/suite", "scan": []any{".", ".worktrees"}, "added": float64(3), "scope": "cli"}}
if detail := formatLogDetail(e, false); detail != "add ~/work/suite, scan=., .worktrees, added=3, scope=cli" {
t.Fatalf("unexpected scan detail: %q", detail)
}
}
func TestFormatSyncLog_ShowsProjectRoot(t *testing.T) {
e := oplog.Entry{Command: "sync", Args: map[string]any{"action": "sync", "root": "~/work/app", "targets_total": 2, "scope": "cli"}}
+6 -3
View File
@@ -10,7 +10,7 @@ import (
ssync "skillshare/internal/sync"
)
var projectValueFlags = []string{"--target", "--name", "--skills-mode", "--skills-naming", "--skills-include", "--skills-exclude", "--agents-mode", "--agents-include", "--agents-exclude"}
var projectValueFlags = []string{"--target", "--name", "--skills-mode", "--skills-naming", "--skills-include", "--skills-exclude", "--agents-mode", "--agents-include", "--agents-exclude", "--scan"}
type projectOptions struct {
action, token string
@@ -167,6 +167,9 @@ func parseProjectArgs(args []string) (projectOptions, error) {
if want == 2 {
o.token = operands[1]
}
if _, scan := o.values["--scan"]; scan && o.action != "add" {
return o, fmt.Errorf("--scan requires project add")
}
if o.action != "add" && o.action != "edit" && (len(o.values) > 0 || len(o.toggles) > 0 || o.sync) {
return o, fmt.Errorf("settings and --sync require project add or edit")
}
@@ -210,10 +213,10 @@ func parseProjectArgs(args []string) (projectOptions, error) {
func printProjectHelp() {
printHelp("skillshare project [list|show|add|edit|sync|remove|localize|share] [project] [options]", "Manage the project folders the global config syncs to. A project is saved in config.yaml unless it is kept on this machine only. No project config is changed.",
helpGroup{title: "Commands", rows: []helpRow{
{"list", "List registered projects (default)"}, {"show <project>", "Show one project by name or root"}, {"add <root> --target T", "Add an existing project folder"}, {"edit <project>", "Change only the specified settings, where they are saved"}, {"localize <project>", "Keep a copy on this machine only; config.yaml stays"}, {"share <project>", "Move a machine-only project into config.yaml"}, {"sync <project>", "Sync skills and agents to this project"}, {"remove <project>", "Detach skills and remove the project; agents stay"},
{"list", "List registered projects (default)"}, {"show <project>", "Show one project by name or root"}, {"add <root> --target T", "Add an existing project folder"}, {"add <root> --scan DIR --target T", "Also add each Git checkout below DIR, with the same settings"}, {"edit <project>", "Change only the specified settings, where they are saved"}, {"localize <project>", "Keep a copy on this machine only; config.yaml stays"}, {"share <project>", "Move a machine-only project into config.yaml"}, {"sync <project>", "Sync skills and agents to this project"}, {"remove <project>", "Detach skills and remove the project; agents stay"},
}},
helpGroup{title: "Options", rows: []helpRow{
{"--target T", "Replace targets; repeat or use a comma list"}, {"--name N", "Set name; --name= restores the basename"}, {"--skills, --no-skills", "Turn skills on (add default) or off"}, {"--agents, --no-agents", "Turn agents on or off (add default)"}, {"--skills-mode, --agents-mode MODE", "merge, symlink or copy; empty inherits"}, {"--skills-naming NAMING", "flat, standard or prefixed; empty inherits"}, {"--skills-include, --skills-exclude P", "Replace filter list; repeat; empty clears"}, {"--agents-include, --agents-exclude P", "Replace filter list; repeat; empty clears"}, {"--machine-local", "Add: save on this machine only, not in config.yaml"}, {"--shared", "Add: save in config.yaml despite projects_storage; remove: also remove config.yaml's copy"}, {"--sync", "Sync after add/edit; force is off"}, {"-n, --dry-run", "Preview without writing or prompting"}, {"--yes", "Skip the remove or share confirmation (remove --json requires it)"}, {"--json", "Output JSON"}, {"-g, --global", "Use the global config (always)"},
{"--target T", "Replace targets; repeat or use a comma list"}, {"--name N", "Set name; --name= restores the basename"}, {"--skills, --no-skills", "Turn skills on (add default) or off"}, {"--agents, --no-agents", "Turn agents on or off (add default)"}, {"--skills-mode, --agents-mode MODE", "merge, symlink or copy; empty inherits"}, {"--skills-naming NAMING", "flat, standard or prefixed; empty inherits"}, {"--skills-include, --skills-exclude P", "Replace filter list; repeat; empty clears"}, {"--agents-include, --agents-exclude P", "Replace filter list; repeat; empty clears"}, {"--machine-local", "Add: save on this machine only, not in config.yaml"}, {"--shared", "Add: save in config.yaml despite projects_storage; remove: also remove config.yaml's copy"}, {"--scan DIR", "Add: also add Git checkouts below this folder of root; repeat; registered ones stay as they are"}, {"--sync", "Sync after add/edit; force is off"}, {"-n, --dry-run", "Preview without writing or prompting"}, {"--yes", "Skip the remove or share confirmation (remove --json requires it)"}, {"--json", "Output JSON"}, {"-g, --global", "Use the global config (always)"},
}},
)
}
+3
View File
@@ -151,6 +151,9 @@ func runProject(o projectOptions) error {
} else if o.shared {
storage = projects.OriginShared
}
if _, scan := o.values["--scan"]; scan {
return runProjectScan(o, cfg, service, root, entry, storage, release, start)
}
if _, exists := cfg.Projects[root]; create && exists {
// Adding the same project again is a no-op, so scripts can rerun it.
if info, err := os.Stat(config.ExpandPath(root)); err != nil || !info.IsDir() {
+24 -18
View File
@@ -122,24 +122,7 @@ func renderProjectResult(o projectOptions, r projectResult, err error, start tim
ui.Row(ui.MarkNone, "Registration", r.Registration, ui.RowWidth("Registration"))
}
if r.Sync != nil {
for _, unmatched := range r.Sync.Unmatched {
for _, pattern := range unmatched.Patterns {
ui.Warning("%s: %s", unmatched.Target, (ssync.UnmatchedInclude{Pattern: pattern, Suggestions: unmatched.Suggestions}).Warning())
}
}
var targets map[string]config.TargetConfig
var managed map[string]config.ManagedProject
if r.Expanded != nil {
targets = r.Expanded.Targets
managed = r.Expanded.Projects
}
printSyncFolderConflicts(r.Sync.FolderConflicts, r.Sync.PathOverlap, false, targets, managed)
for _, row := range r.Sync.Results {
ui.Row(ui.MarkOK, row.Target, fmt.Sprintf("%d linked, %d updated, %d skipped, %d pruned", len(row.Linked), len(row.Updated), len(row.Skipped), len(row.Pruned)), ui.RowWidth(row.Target))
}
for _, failure := range r.Sync.Failed {
ui.Row(ui.MarkFail, failure.Target, failure.Error, ui.RowWidth(failure.Target))
}
renderProjectSync(r.Sync, r.Expanded)
}
for _, warning := range r.Warnings {
ui.Warning("%s", warning)
@@ -159,6 +142,29 @@ func renderProjectResult(o projectOptions, r projectResult, err error, start tim
}
return err
}
// renderProjectSync prints one project's sync, as project sync does.
func renderProjectSync(synced *ssync.ExecuteResult, expanded *config.Config) {
for _, unmatched := range synced.Unmatched {
for _, pattern := range unmatched.Patterns {
ui.Warning("%s: %s", unmatched.Target, (ssync.UnmatchedInclude{Pattern: pattern, Suggestions: unmatched.Suggestions}).Warning())
}
}
var targets map[string]config.TargetConfig
var managed map[string]config.ManagedProject
if expanded != nil {
targets = expanded.Targets
managed = expanded.Projects
}
printSyncFolderConflicts(synced.FolderConflicts, synced.PathOverlap, false, targets, managed)
for _, row := range synced.Results {
ui.Row(ui.MarkOK, row.Target, fmt.Sprintf("%d linked, %d updated, %d skipped, %d pruned", len(row.Linked), len(row.Updated), len(row.Skipped), len(row.Pruned)), ui.RowWidth(row.Target))
}
for _, failure := range synced.Failed {
ui.Row(ui.MarkFail, failure.Target, failure.Error, ui.RowWidth(failure.Target))
}
}
func renderProjectItem(item projects.Item) {
width := ui.RowWidth("Project", "Root", "Origin", "Origin file", "Targets", "Skills", "Agents")
ui.Row(ui.MarkNone, "Project", item.Name, width)
+126
View File
@@ -0,0 +1,126 @@
package main
import (
"fmt"
"slices"
"time"
"skillshare/internal/config"
"skillshare/internal/projects"
ssync "skillshare/internal/sync"
"skillshare/internal/ui"
)
// projectScanRow adds a scanned project's sync to its scan result.
type projectScanRow struct {
projects.ScanRow
Sync *projectSyncJSON `json:"sync,omitempty"`
Error string `json:"error,omitempty"`
synced *ssync.ExecuteResult
}
type projectScanJSON struct {
projectResultJSON
Scan []projectScanRow `json:"scan"`
}
// runProjectScan runs project add --scan, then syncs the root and every added
// or kept checkout when --sync is set. release unlocks the config before syncing.
func runProjectScan(o projectOptions, cfg *config.Config, service *projects.Service, root string, entry config.ManagedProject, storage string, release func(), start time.Time) error {
scan, err := service.Scan(root, entry, o.values["--scan"], projects.PutOptions{DryRun: o.dryRun, Storage: storage})
if release != nil {
release()
}
if err != nil {
return err
}
result := projectResult{Result: scan.Result}
for _, w := range scan.Warnings {
result.Warnings = append(result.Warnings, w.String())
}
if !o.dryRun && result.Registration == "updated" {
logProject(cfg, "project", "add", root, "ok", nil, start, map[string]any{"scan": o.values["--scan"], "added": scan.Added()})
}
rows := make([]projectScanRow, len(scan.Rows))
failed := 0
for i, scanned := range scan.Rows {
row := &rows[i]
row.ScanRow = scanned
if !o.sync || scanned.Item == nil {
continue
}
synced, err := syncProject(result.Expanded, scanned.Item.Root, o.dryRun)
err = projectSyncError(synced, err, o.dryRun)
if synced != nil {
row.synced = synced
row.Sync = projectSyncPayload(synced, result.Expanded.EffectiveAgentsSource())
for _, w := range synced.Warnings {
if !slices.Contains(result.Warnings, w) {
result.Warnings = append(result.Warnings, w)
}
}
}
if err != nil {
failed++
row.Error = err.Error()
}
if !o.dryRun {
status := projectSyncStatus(projectResult{Result: projects.Result{Item: scanned.Item, Expanded: result.Expanded}, Sync: synced}, err)
logProject(result.Expanded, "sync", "sync", scanned.Item.Root, status, err, start, nil)
}
}
var opErr error
if failed > 0 {
opErr = fmt.Errorf("sync failed for %d of the scanned projects", failed)
}
return renderProjectScan(o, result, rows, opErr, start)
}
func renderProjectScan(o projectOptions, r projectResult, rows []projectScanRow, err error, start time.Time) error {
unchanged := len(r.Affected) == 0
if o.json {
applied := !o.dryRun && r.Registration == "updated"
p := projectScanJSON{projectResultJSON: projectResultJSON{Action: "add", Project: r.Item, Applied: &applied, Unchanged: unchanged, Affected: projectSlice(r.Affected), Warnings: projectSlice(r.Warnings), Registration: r.Registration}, Scan: rows}
if p.Project != nil {
item := projectJSONItem(*p.Project)
p.Project = &item
}
if err != nil {
p.Error = err.Error()
}
return writeJSONResult(p, err)
}
width := ui.RowWidth("Skipped")
for _, row := range rows {
mark, label := ui.MarkOK, "Added"
switch row.Result {
case projects.ScanKept:
mark, label = ui.MarkNone, "Kept"
case projects.ScanSkipped:
mark, label = ui.MarkWarn, "Skipped"
}
value := row.Root
if row.Reason != "" {
value += " " + row.Reason
}
ui.Row(mark, label, value, width)
if row.synced != nil {
renderProjectSync(row.synced, r.Expanded)
}
}
for _, warning := range r.Warnings {
ui.Warning("%s", warning)
}
if o.dryRun {
ui.DryRun()
} else if unchanged && !o.sync {
ui.Done(ui.MarkNone, "Projects unchanged", time.Since(start))
} else if err == nil {
ui.Done(ui.MarkOK, "Project add complete", time.Since(start))
}
if err == nil && !o.dryRun {
ui.Next("skillshare project list", "Inspect registered projects")
}
return err
}
+382
View File
@@ -0,0 +1,382 @@
package projects
import (
"errors"
"fmt"
"io/fs"
"os"
"path"
"path/filepath"
"slices"
"strings"
"skillshare/internal/config"
"skillshare/internal/projectdir"
"skillshare/internal/utils"
)
// Results of a scanned folder.
const (
ScanAdded = "added"
ScanKept = "kept"
ScanSkipped = "skipped"
)
// Why a scanned folder was skipped, for callers that word the reason themselves.
const (
SkipDifferent = "different"
SkipStorage = "storage"
SkipRemoved = "removed"
SkipOwnConfig = "own-config"
SkipNameTaken = "name-taken"
SkipBadName = "bad-name"
)
// ScanRow is one folder a scan considered: the root or a checkout below it.
// Path is relative to the root ("." for the root itself). Item is the
// registered project, except for a skipped folder.
type ScanRow struct {
Root string `json:"root"`
Path string `json:"path"`
Name string `json:"name"`
Result string `json:"result"`
Skip string `json:"skip,omitempty"`
Reason string `json:"reason,omitempty"`
Item *Item `json:"-"`
}
// Kinds of scan warnings.
const (
ScanMissing = "missing"
ScanUnreadable = "unreadable"
)
// ScanWarning is a scan folder that does not exist, or a folder below one that
// could not be read. Folder is relative to the root.
type ScanWarning struct {
Kind string `json:"kind"`
Folder string `json:"folder"`
Detail string `json:"detail,omitempty"`
}
func (w ScanWarning) String() string {
if w.Kind == ScanMissing {
return fmt.Sprintf("scan folder %s does not exist", w.Folder)
}
return fmt.Sprintf("skipped %s, which could not be read: %s", w.Folder, w.Detail)
}
// ScanResult is a scan's registration. Item is the root.
type ScanResult struct {
Result
Rows []ScanRow
Warnings []ScanWarning
}
// Added counts the folders the scan registered, or would in a dry run.
func (r ScanResult) Added() int {
n := 0
for _, row := range r.Rows {
if row.Result == ScanAdded {
n++
}
}
return n
}
// Scan registers root and each Git checkout below its scan folders with the
// same settings, in one validated write. It only adds: a registered folder
// stays as it is, so a rerun registers only new checkouts.
func (s *Service) Scan(root string, entry config.ManagedProject, dirs []string, opts PutOptions) (ScanResult, error) {
cfg, err := s.load()
if err != nil {
return ScanResult{}, err
}
abs := config.ExpandPath(root)
if info, err := os.Stat(abs); err != nil || !info.IsDir() {
return ScanResult{}, fmt.Errorf("%w: %s", ErrFolderNotFound, root)
}
storage := opts.Storage
if storage == "" {
storage = cfg.NewProjectOrigin()
}
if err := checkStorage(storage); err != nil {
return ScanResult{}, err
}
found, warnings, err := ScanCheckouts(abs, dirs)
if err != nil {
return ScanResult{}, err
}
cwd, err := os.Getwd()
if err != nil {
return ScanResult{}, err
}
home, err := os.UserHomeDir()
if err != nil {
return ScanResult{}, err
}
rows, adds, err := planScan(cfg, root, entry, found, opts.Storage, cwd, home)
if err != nil {
return ScanResult{}, err
}
result := ScanResult{Result: Result{Expanded: cfg, Registration: "kept"}, Rows: rows, Warnings: warnings}
if len(adds) > 0 {
// Entries share the settings' slices; each gets its own copy.
c, err := layerEntries(s.path, cfg, cloneProjects(adds), storage)
if err != nil {
return ScanResult{}, err
}
result.Affected = c.Affected
if err := c.Save.Check(); err != nil {
return result, err
}
if err := commit(c, opts.DryRun, &result.Result, "updated"); err != nil {
return result, err
}
result.Expanded = c.Save.Expanded
}
for i := range result.Rows {
if result.Rows[i].Result != ScanSkipped {
v := resultItem(result.Expanded, result.Rows[i].Root)
result.Rows[i].Item = &v
}
}
// The root is reported even when it was skipped.
root = result.Rows[0].Root
item := resultItem(result.Expanded, root)
result.Item = &item
return result, nil
}
// planScan decides each folder's result and the entries to add. storage is the
// layer the caller asked for, if any.
func planScan(cfg *config.Config, root string, entry config.ManagedProject, found []string, storage, cwd, home string) ([]ScanRow, map[string]config.ManagedProject, error) {
taken := map[string]bool{}
for key, p := range cfg.Projects {
taken[p.ProjectName(key)] = true
}
adds := map[string]config.ManagedProject{}
rootRow, err := registeredRow(cfg, root, entry, false, storage, cwd, home)
if err != nil {
return nil, nil, err
}
if rootRow == nil {
rootRow = &ScanRow{Root: root, Name: entry.ProjectName(root), Result: ScanAdded}
}
rootRow.Path = "."
if rootRow.Result == ScanAdded {
adds[root] = entry
}
taken[rootRow.Name] = true
rows := []ScanRow{*rootRow}
var fresh []string
bases := map[string]int{}
for _, rel := range found {
key := filepath.Join(root, filepath.FromSlash(rel))
row, err := registeredRow(cfg, key, entry, true, storage, cwd, home)
if err != nil {
return nil, nil, err
}
if row == nil && ownsConfig(config.ExpandPath(key)) {
row = &ScanRow{Root: key, Name: path.Base(rel), Result: ScanSkipped, Skip: SkipOwnConfig, Reason: "has its own .skillshare/ project config"}
}
if row != nil {
row.Path = rel
rows = append(rows, *row)
continue
}
fresh = append(fresh, rel)
bases[path.Base(rel)]++
}
// A checkout keeps its folder name unless another project or a sibling
// checkout has it. Then the checkout directly under root keeps it and the
// others are named from their path. Folder names are claimed first, so
// the result does not depend on scan order.
derived := map[string]bool{}
for _, rel := range fresh {
base := path.Base(rel)
derived[rel] = taken[base] || (bases[base] > 1 && rel != base)
}
for _, pass := range []bool{false, true} {
for _, rel := range fresh {
if derived[rel] != pass {
continue
}
key := filepath.Join(root, filepath.FromSlash(rel))
child := entry
child.Name = ""
name := path.Base(rel)
if pass {
if name = scanName(rel); name != path.Base(rel) {
child.Name = name
}
}
row := ScanRow{Root: key, Path: rel, Name: name, Result: ScanAdded}
switch {
case taken[name]:
row.Result, row.Skip, row.Reason = ScanSkipped, SkipNameTaken, fmt.Sprintf("name %q is already used; add it on its own with --name", name)
case name == "" || strings.ContainsAny(name, config.ProjectTargetSep+`/\`) || ValidateName(name) != nil:
row.Result, row.Skip, row.Reason = ScanSkipped, SkipBadName, fmt.Sprintf("%q cannot be a project name; add it on its own with --name", name)
default:
taken[name] = true
adds[key] = child
}
rows = append(rows, row)
}
}
slices.SortFunc(rows[1:], func(a, b ScanRow) int { return strings.Compare(a.Root, b.Root) })
return rows, adds, nil
}
// registeredRow reports a folder that is already registered, nil otherwise.
// The root keeps its own name; a checkout's settings are compared without it.
func registeredRow(cfg *config.Config, key string, want config.ManagedProject, checkout bool, storage, cwd, home string) (*ScanRow, error) {
match, err := FindRoot(cfg.Projects, key, cwd, home)
if errors.Is(err, ErrNotFound) {
if checkout && cfg.HasSharedProject(key) {
return &ScanRow{Root: key, Name: want.ProjectName(key), Result: ScanSkipped, Skip: SkipRemoved, Reason: "was removed on this machine; add it on its own to restore it"}, nil
}
return nil, nil
}
if err != nil {
return nil, err
}
have := cfg.Projects[match]
row := &ScanRow{Root: match, Name: have.ProjectName(match), Result: ScanKept}
if checkout {
want.Name = have.Name
}
origin, _ := cfg.ProjectOrigin(match)
if !config.SameManagedProject(have, want) {
row.Result, row.Skip, row.Reason = ScanSkipped, SkipDifferent, "has different settings; change it with: skillshare project edit "+row.Name
} else if storage != "" && storage != origin {
verb := map[string]string{OriginLocal: "localize", OriginShared: "share"}[storage]
where := map[string]string{OriginLocal: "on this machine only", OriginShared: "in config.yaml"}[origin]
row.Result, row.Skip, row.Reason = ScanSkipped, SkipStorage, fmt.Sprintf("is saved %s; move it with: skillshare project %s %s", where, verb, row.Name)
}
return row, nil
}
// ownsConfig includes a .skillshare/ whose config.yaml is gitignored, as a
// clone of a shared skills repository has it.
func ownsConfig(dir string) bool {
_, full := projectdir.Find(dir)
_, partial := projectdir.FindPartial(dir)
return full || partial
}
// scanName names a checkout from its path under the root:
// .worktrees/app-a becomes worktrees-app-a.
func scanName(rel string) string {
var parts []string
for _, part := range strings.Split(rel, "/") {
if part = strings.TrimLeft(part, "."); part != "" {
parts = append(parts, part)
}
}
return strings.Join(parts, "-")
}
// ScanCheckouts finds Git checkouts below the scan folders of root, an absolute
// project folder. A checkout has a .git folder, or a .git file for a linked
// worktree, and is never searched further. Hidden folders below a scan folder,
// node_modules and links are skipped. Found checkouts are slash-separated and
// relative to root. A scan folder that does not exist, or a folder that cannot
// be read, is skipped with a warning, so one such folder never stops the scan.
func ScanCheckouts(root string, dirs []string) (found []string, warnings []ScanWarning, err error) {
// A root reached through a link is walked at its target, so the walk can
// start there; links below the root are still skipped.
if resolved, err := filepath.EvalSymlinks(root); err == nil {
root = resolved
}
seen := map[string]bool{}
for _, dir := range dirs {
rel := filepath.FromSlash(dir)
if !filepath.IsLocal(rel) {
return nil, nil, fmt.Errorf("--scan %q must be a folder inside %s", dir, root)
}
scanRoot := filepath.Join(root, rel)
exists, err := localFolder(root, scanRoot)
if errors.Is(err, fs.ErrPermission) {
warnings = append(warnings, ScanWarning{Kind: ScanUnreadable, Folder: dir, Detail: fs.ErrPermission.Error()})
continue
}
if err != nil {
return nil, nil, fmt.Errorf("--scan %q: %w", dir, err)
}
if !exists {
warnings = append(warnings, ScanWarning{Kind: ScanMissing, Folder: dir})
continue
}
err = filepath.WalkDir(scanRoot, func(path string, entry fs.DirEntry, err error) error {
if err != nil {
folder, _ := filepath.Rel(root, path)
detail := err
if pathErr, ok := err.(*fs.PathError); ok {
detail = pathErr.Err
}
warnings = append(warnings, ScanWarning{Kind: ScanUnreadable, Folder: filepath.ToSlash(folder), Detail: detail.Error()})
return filepath.SkipDir
}
if !entry.IsDir() {
return nil
}
if utils.IsLinkMode(path, entry.Type()) {
return filepath.SkipDir
}
if path != scanRoot && (strings.HasPrefix(entry.Name(), ".") || entry.Name() == "node_modules") {
return filepath.SkipDir
}
if path == root || !isCheckout(path) {
return nil
}
checkout, _ := filepath.Rel(root, path)
if checkout = filepath.ToSlash(checkout); !seen[checkout] {
seen[checkout] = true
found = append(found, checkout)
}
return filepath.SkipDir
})
if err != nil {
return nil, nil, err
}
}
slices.Sort(found)
return found, warnings, nil
}
// localFolder reports whether path, inside root, is a folder reached without
// crossing a link. A missing folder is not an error.
func localFolder(root, path string) (bool, error) {
rel, _ := filepath.Rel(root, path)
if rel == "." {
return true, nil
}
at := root
for _, part := range strings.Split(rel, string(filepath.Separator)) {
at = filepath.Join(at, part)
info, err := os.Lstat(at)
if errors.Is(err, fs.ErrNotExist) {
return false, nil
}
if err != nil {
return false, err
}
if utils.IsLinkMode(at, info.Mode()) {
return false, fmt.Errorf("%s is a link", at)
}
if !info.IsDir() {
return false, fmt.Errorf("%s is not a folder", at)
}
}
return true, nil
}
// isCheckout uses Lstat, unlike install.IsGitRepo, to reject a linked .git,
// which could point at another checkout.
func isCheckout(path string) bool {
info, err := os.Lstat(filepath.Join(path, ".git"))
return err == nil && (info.IsDir() || info.Mode().IsRegular())
}
+124
View File
@@ -0,0 +1,124 @@
package projects
import (
"maps"
"os"
"path/filepath"
"runtime"
"slices"
"testing"
"skillshare/internal/config"
)
func TestScanCheckoutsSkipsLinks(t *testing.T) {
root := t.TempDir()
outside := t.TempDir()
for _, dir := range []string{filepath.Join(root, "app", ".git"), filepath.Join(outside, "other", ".git"), filepath.Join(root, "linked-git")} {
if err := os.MkdirAll(dir, 0755); err != nil {
t.Fatal(err)
}
}
// A linked checkout folder and a linked .git could both point at another checkout.
if err := os.Symlink(filepath.Join(outside, "other"), filepath.Join(root, "linked")); err != nil {
t.Skip("symlinks unavailable:", err)
}
if err := os.Symlink(filepath.Join(outside, "other", ".git"), filepath.Join(root, "linked-git", ".git")); err != nil {
t.Fatal(err)
}
found, _, err := ScanCheckouts(root, []string{".", "app"})
if err != nil {
t.Fatal(err)
}
if !slices.Equal(found, []string{"app"}) {
t.Fatalf("found %v, want [app]", found)
}
if _, _, err := ScanCheckouts(root, []string{"linked"}); err == nil {
t.Fatal("a linked scan folder was accepted")
}
}
func TestScanCheckoutsThroughLinkedRoot(t *testing.T) {
real := filepath.Join(t.TempDir(), "suite")
if err := os.MkdirAll(filepath.Join(real, "app", ".git"), 0755); err != nil {
t.Fatal(err)
}
link := filepath.Join(t.TempDir(), "suite")
if err := os.Symlink(real, link); err != nil {
t.Skip("symlinks unavailable:", err)
}
found, _, err := ScanCheckouts(link, []string{"."})
if err != nil {
t.Fatal(err)
}
if !slices.Equal(found, []string{"app"}) {
t.Fatalf("found %v, want [app]", found)
}
}
func TestPlanScanNamesClashingCheckoutsFromTheirPath(t *testing.T) {
home := t.TempDir()
root := filepath.Join(home, "suite")
cfg := &config.Config{Projects: map[string]config.ManagedProject{
filepath.Join(home, "other", "worktrees-app-b"): {Targets: []string{"codex"}},
}}
entry := config.ManagedProject{Targets: []string{"codex"}}
// Sorted as a scan returns them: the worktrees come before their checkouts.
found := []string{".worktrees/app-a", ".worktrees/app-b", "app-a", "app-b"}
rows, adds, err := planScan(cfg, root, entry, found, "", home, home)
if err != nil {
t.Fatal(err)
}
names := map[string]string{}
for _, row := range rows {
rel, _ := filepath.Rel(root, row.Root)
names[filepath.ToSlash(rel)] = row.Result + ":" + row.Name
}
want := map[string]string{".": "added:suite", "app-a": "added:app-a", "app-b": "added:app-b", ".worktrees/app-a": "added:worktrees-app-a", ".worktrees/app-b": "skipped:worktrees-app-b"}
if !maps.Equal(names, want) {
t.Fatalf("rows %v, want %v", names, want)
}
if adds[filepath.Join(root, "app-a")].Name != "" || adds[filepath.Join(root, ".worktrees", "app-a")].Name != "worktrees-app-a" {
t.Fatalf("saved names: %+v", adds)
}
}
func TestPlanScanSkipsCheckoutWithItsOwnSkillshare(t *testing.T) {
root := t.TempDir()
// A clone of a shared skills repository: config.yaml is gitignored.
if err := os.MkdirAll(filepath.Join(root, "tools", ".skillshare", "skills"), 0755); err != nil {
t.Fatal(err)
}
rows, adds, err := planScan(&config.Config{}, root, config.ManagedProject{Targets: []string{"codex"}}, []string{"tools"}, "", root, root)
if err != nil {
t.Fatal(err)
}
if len(adds) != 1 || rows[1].Result != ScanSkipped {
t.Fatalf("rows %+v, adds %v", rows, adds)
}
}
func TestScanCheckoutsSkipsUnreadableFolders(t *testing.T) {
if os.Geteuid() == 0 || runtime.GOOS == "windows" {
t.Skip("test requires POSIX directory permissions and a non-root user")
}
root := t.TempDir()
for _, dir := range []string{filepath.Join(root, "app", ".git"), filepath.Join(root, "private", "secret", ".git")} {
if err := os.MkdirAll(dir, 0755); err != nil {
t.Fatal(err)
}
}
private := filepath.Join(root, "private")
if err := os.Chmod(private, 0); err != nil {
t.Fatal(err)
}
t.Cleanup(func() { _ = os.Chmod(private, 0755) })
// The scan folder itself sits below the unreadable one.
found, warnings, err := ScanCheckouts(root, []string{".", "private/secret"})
if err != nil {
t.Fatal(err)
}
if !slices.Equal(found, []string{"app"}) || len(warnings) != 2 || warnings[0].Folder != "private" || warnings[1].Folder != "private/secret" {
t.Fatalf("found %v, warnings %v", found, warnings)
}
}
+26 -12
View File
@@ -176,19 +176,10 @@ func (s *Service) Put(root string, entry config.ManagedProject, opts PutOptions)
} else if storage == "" {
storage = cfg.NewProjectOrigin()
}
if storage != OriginShared && storage != OriginLocal {
return Result{}, fmt.Errorf("invalid project storage %q (valid: %s, %s)", storage, OriginShared, OriginLocal)
if err := checkStorage(storage); err != nil {
return Result{}, err
}
c, err := PrepareLayers(s.path, cfg, func(l *config.ProjectLayers) error {
if storage == OriginLocal {
l.SetLocal(root, entry)
} else {
// A re-added project is no longer hidden on this machine.
l.SetShared(root, entry)
l.ClearLocal(root)
}
return nil
})
c, err := layerEntries(s.path, cfg, map[string]config.ManagedProject{root: entry}, storage)
if err != nil {
return Result{}, err
}
@@ -213,6 +204,29 @@ func (s *Service) Put(root string, entry config.ManagedProject, opts PutOptions)
return result, nil
}
func checkStorage(storage string) error {
if storage != OriginShared && storage != OriginLocal {
return fmt.Errorf("invalid project storage %q (valid: %s, %s)", storage, OriginShared, OriginLocal)
}
return nil
}
// layerEntries saves each entry in storage. An entry saved in config.yaml is
// no longer hidden on this machine.
func layerEntries(path string, cfg *config.Config, entries map[string]config.ManagedProject, storage string) (*Candidate, error) {
return PrepareLayers(path, cfg, func(l *config.ProjectLayers) error {
for root, entry := range entries {
if storage == OriginLocal {
l.SetLocal(root, entry)
} else {
l.SetShared(root, entry)
l.ClearLocal(root)
}
}
return nil
})
}
// detachDeparting compares paths, rather than target names, so renamed and
// shared destinations stay owned. Effective candidates include alias changes.
func (s *Service) detachDeparting(before, after *config.Config, affected []string, dryRun bool) (DetachReport, error) {
+77 -8
View File
@@ -110,14 +110,9 @@ func (s *Server) handleSaveProject(w http.ResponseWriter, r *http.Request) {
writeError(w, http.StatusBadRequest, "root is required")
return
}
for _, rc := range []*projectResource{body.Skills, body.Agents} {
if rc == nil {
continue
}
if _, err := ssync.FilterSkills(nil, rc.Include, rc.Exclude); err != nil {
writeError(w, http.StatusBadRequest, "invalid include/exclude pattern: "+err.Error())
return
}
if err := body.checkFilters(); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
s.mu.Lock()
@@ -165,6 +160,80 @@ func (s *Server) handleSaveProject(w http.ResponseWriter, r *http.Request) {
writeJSON(w, map[string]any{"success": true, "root": root, "origin": result.Item.Origin, "originPath": result.Item.OriginPath})
}
// handleScanProjects adds a folder and each Git checkout below its scan folders
// with the same settings, like project add --scan. It only adds; a dry run
// reports each folder's result and writes nothing.
func (s *Server) handleScanProjects(w http.ResponseWriter, r *http.Request) {
start := time.Now()
var body struct {
projectBody
Scan []string `json:"scan"`
DryRun bool `json:"dryRun"`
}
if err := decodeJSON(w, r, &body, defaultJSONBodyLimit); err != nil {
if !errors.Is(err, errBodyTooLarge) {
writeError(w, http.StatusBadRequest, "invalid JSON body")
}
return
}
if body.Root == "" || len(body.Scan) == 0 {
writeError(w, http.StatusBadRequest, "root and at least one scan folder are required")
return
}
if err := body.checkFilters(); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
s.mu.Lock()
defer s.mu.Unlock()
release, err := projects.LockConfig(r.Context(), s.configPath())
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
return
}
defer release()
if err := s.reloadProjectsReadOnly(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
return
}
entry := config.ManagedProject{Name: body.Name, Targets: body.Targets, Skills: body.Skills.config(), Agents: body.Agents.config()}
result, err := s.projectService().Scan(body.Root, entry, body.Scan, projects.PutOptions{DryRun: body.DryRun, Storage: body.Storage})
if err != nil {
status := http.StatusBadRequest
if errors.Is(err, projects.ErrSave) {
status = http.StatusInternalServerError
}
writeError(w, status, err.Error())
return
}
// A dry run's Expanded is the candidate config, so only a write installs it.
applied := !body.DryRun && result.Registration == "updated"
if applied {
s.installGlobalConfig(result.Expanded)
s.writeOpsLog("project", "ok", start, map[string]any{"action": "add", "root": body.Root, "scan": body.Scan, "added": result.Added(), "scope": "ui"}, "")
}
warnings := result.Warnings
if warnings == nil {
warnings = []projects.ScanWarning{}
}
writeJSON(w, map[string]any{"applied": applied, "rows": result.Rows, "warnings": warnings})
}
// checkFilters rejects include/exclude patterns a sync could not use.
func (b projectBody) checkFilters() error {
for _, rc := range []*projectResource{b.Skills, b.Agents} {
if rc == nil {
continue
}
if _, err := ssync.FilterSkills(nil, rc.Include, rc.Exclude); err != nil {
return fmt.Errorf("invalid include/exclude pattern: %w", err)
}
}
return nil
}
func (s *Server) handleRemoveProject(w http.ResponseWriter, r *http.Request) {
start := time.Now()
s.mu.Lock()
+85
View File
@@ -12,6 +12,7 @@ import (
"testing"
"skillshare/internal/config"
"skillshare/internal/projects"
ssync "skillshare/internal/sync"
)
@@ -373,3 +374,87 @@ func TestSaveProject_StorageFollowsSettingByDefault(t *testing.T) {
t.Fatalf("project is not machine-local: %s", rr.Body)
}
}
func TestScanProjects_PreviewThenAdd(t *testing.T) {
s, src := newTestServer(t)
suite := filepath.Join(filepath.Dir(src), "suite")
for _, dir := range []string{"app-a/.git", ".worktrees/app-a", "docs"} {
if err := os.MkdirAll(filepath.Join(suite, dir), 0755); err != nil {
t.Fatal(err)
}
}
if err := os.WriteFile(filepath.Join(suite, ".worktrees", "app-a", ".git"), []byte("gitdir: /elsewhere\n"), 0644); err != nil {
t.Fatal(err)
}
body := func(dryRun bool) string {
return `{"root":"` + suite + `","scan":[".",".worktrees","later"],"targets":["claude"],"skills":{"mode":"","include":[],"exclude":[]},"dryRun":` + map[bool]string{true: "true", false: "false"}[dryRun] + `}`
}
type scanReply struct {
Applied bool `json:"applied"`
Rows []map[string]string `json:"rows"`
Warnings []projects.ScanWarning `json:"warnings"`
}
listed := func() int {
var list struct {
Projects []projectItem `json:"projects"`
}
json.Unmarshal(projectRequest(t, s, http.MethodGet, "/api/projects", "").Body.Bytes(), &list)
return len(list.Projects)
}
rr := projectRequest(t, s, http.MethodPost, "/api/projects/scan", body(true))
var preview scanReply
if err := json.Unmarshal(rr.Body.Bytes(), &preview); err != nil || rr.Code != http.StatusOK {
t.Fatalf("preview: %d %s", rr.Code, rr.Body)
}
if preview.Applied || len(preview.Rows) != 3 || listed() != 0 {
t.Fatalf("preview wrote or missed rows: %+v, %d listed", preview, listed())
}
if len(preview.Warnings) != 1 || preview.Warnings[0].Kind != projects.ScanMissing || preview.Warnings[0].Folder != "later" {
t.Fatalf("warnings %+v", preview.Warnings)
}
rr = projectRequest(t, s, http.MethodPost, "/api/projects/scan", body(false))
var added scanReply
json.Unmarshal(rr.Body.Bytes(), &added)
if !added.Applied || listed() != 3 {
t.Fatalf("apply: %s, %d listed", rr.Body, listed())
}
paths := map[string]string{}
for _, row := range added.Rows {
paths[row["path"]] = row["name"]
}
if paths["."] != "suite" || paths["app-a"] != "app-a" || paths[".worktrees/app-a"] != "worktrees-app-a" {
t.Fatalf("rows %+v", added.Rows)
}
// A rescan, with the root given with a trailing separator, only keeps.
rr = projectRequest(t, s, http.MethodPost, "/api/projects/scan", strings.Replace(body(false), `"root":"`+suite, `"root":"`+suite+`/`, 1))
var again scanReply
json.Unmarshal(rr.Body.Bytes(), &again)
for _, row := range again.Rows {
if row["result"] != projects.ScanKept {
t.Fatalf("rescan: %s", rr.Body)
}
}
if again.Applied || listed() != 3 {
t.Fatalf("rescan: %s, %d listed", rr.Body, listed())
}
}
func TestScanProjects_RejectsBadRequests(t *testing.T) {
s, src := newTestServer(t)
suite := filepath.Join(filepath.Dir(src), "suite")
if err := os.MkdirAll(suite, 0755); err != nil {
t.Fatal(err)
}
for name, body := range map[string]string{
"no scan folder": `{"root":"` + suite + `","scan":[],"targets":["claude"]}`,
"folder outside root": `{"root":"` + suite + `","scan":["../other"],"targets":["claude"]}`,
"bad filter": `{"root":"` + suite + `","scan":["."],"targets":["claude"],"skills":{"mode":"","include":["["],"exclude":[]}}`,
} {
if rr := projectRequest(t, s, http.MethodPost, "/api/projects/scan", body); rr.Code != http.StatusBadRequest {
t.Errorf("%s: got %d %s", name, rr.Code, rr.Body)
}
}
}
+1
View File
@@ -549,6 +549,7 @@ func (s *Server) registerRoutes() {
s.mux.HandleFunc("PUT /api/projects", s.requireGlobalProjects(s.handleSaveProject))
s.mux.HandleFunc("DELETE /api/projects", s.requireGlobalProjects(s.handleRemoveProject))
s.mux.HandleFunc("POST /api/projects/convert", s.requireGlobalProjects(s.handleConvertProject))
s.mux.HandleFunc("POST /api/projects/scan", s.requireGlobalProjects(s.handleScanProjects))
// Sync matrix
s.mux.HandleFunc("GET /api/sync-matrix", s.handleSyncMatrix)
+8
View File
@@ -679,6 +679,14 @@
"reason": "plugin",
"note": "Validate plugin source links"
},
{
"file": "internal/projects/scan.go",
"function": "ScanCheckouts",
"callee": "filepath.WalkDir",
"root": "scanRoot",
"reason": "project",
"note": "Find Git checkouts below a project folder for project add --scan"
},
{
"file": "internal/resource/agent.go",
"function": "(AgentKind).Discover",
+4 -1
View File
@@ -158,6 +158,7 @@ skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project add ~/work/suite --scan . --scan .worktrees --target codex --dry-run
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json
@@ -168,7 +169,9 @@ skillshare project remove app --dry-run --json
`--machine-local` or `projects_storage: machine-local` (`--shared` overrides the setting);
`localize` and `share` move one between the two. Removing a local copy of a `config.yaml`
project keeps `config.yaml`'s version unless `--shared` is given. Edit filters replace lists. Removal detaches skills and keeps agent files;
JSON removal requires `--yes` unless previewing. Read [targets.md](references/targets.md)
JSON removal requires `--yes` unless previewing. `--scan DIR` also adds each Git checkout
below DIR with the same settings and only adds; rerun it after a new clone or worktree.
Read [targets.md](references/targets.md)
for saved-then-sync failures, retries, and partial removal results.
### MCP settings
+11
View File
@@ -144,6 +144,7 @@ skillshare project remove shop-web --yes --json
skillshare project add ~/work/scratch --target claude --machine-local --dry-run
skillshare project localize shop-web --dry-run --json
skillshare project share scratch --dry-run --json
skillshare project add ~/work/suite --scan . --scan .worktrees --target codex --dry-run --json
```
Always global (explicit `-g` accepted, `-p` rejected), even inside a project. Add requires
@@ -167,6 +168,16 @@ exit 1 does not undo the saved registration: inspect `sync.failed` and retry wit
mutation JSON includes `action`, `project`, `applied`, `affected`, and `warnings`.
No-op edits report `applied: false, unchanged: true`.
`--scan DIR` (add only, repeatable, relative to the root) also registers each Git checkout
below DIR (`.git` folder or worktree `.git` file) as an ordinary project with the same
settings. Hidden folders below DIR, `node_modules` and links are skipped; missing or
unreadable folders are skipped with a warning. It only adds:
registered folders (root included) are `kept` or, with different settings, `skipped`;
checkouts with their own `.skillshare/` are `skipped`. A name clash names the checkout
from its path (`.worktrees/app-a` → `worktrees-app-a`). JSON adds a `scan` array of
`root`, `path` (`.` for the root), `name`, `result`, and for a skipped folder
`skip` and `reason`; with `--sync`, each row's `sync` and `error`. Rerun it after a new clone or worktree.
Removal asks for confirmation unless `--yes` or previewing; JSON removal requires
`--yes` unless previewing. Whole-folder links are removed; merge links become local
copies while source content exists; copy files remain and their manifest is removed.
+5
View File
@@ -47,6 +47,11 @@ func TestCompletion_ProjectLocalize_AllShells(t *testing.T) {
result.AssertOutputContains(t, "localize")
result.AssertOutputContains(t, "share")
result.AssertOutputContains(t, "machine-local")
scan := "--scan"
if shell == "fish" {
scan = "-l scan"
}
result.AssertOutputContains(t, scan)
}
}
+239
View File
@@ -0,0 +1,239 @@
//go:build !online
package integration
import (
"os"
"path/filepath"
"strings"
"testing"
"skillshare/internal/config"
"skillshare/internal/testutil"
)
// scanFixture builds a workspace of checkouts, a linked worktree, a plain
// folder and folders the scan must ignore.
func scanFixture(t *testing.T) (*testutil.Sandbox, string) {
t.Helper()
sb, _ := projectFixture(t)
suite := filepath.Join(sb.Home, "suite")
for _, dir := range []string{"app-a", "app-b", "node_modules/pkg", "nested/deep/lib"} {
mkCheckout(t, filepath.Join(suite, dir))
}
mkWorktree(t, filepath.Join(suite, ".worktrees", "app-a-fix"))
if err := os.MkdirAll(filepath.Join(suite, "docs"), 0755); err != nil {
t.Fatal(err)
}
return sb, suite
}
func mkCheckout(t *testing.T, dir string) {
t.Helper()
if err := os.MkdirAll(filepath.Join(dir, ".git"), 0755); err != nil {
t.Fatal(err)
}
}
// A linked worktree has a .git file instead of a directory.
func mkWorktree(t *testing.T, dir string) {
t.Helper()
if err := os.MkdirAll(dir, 0755); err != nil {
t.Fatal(err)
}
if err := os.WriteFile(filepath.Join(dir, ".git"), []byte("gitdir: /elsewhere\n"), 0644); err != nil {
t.Fatal(err)
}
}
func scanRows(t *testing.T, payload map[string]any) map[string]map[string]any {
t.Helper()
rows := map[string]map[string]any{}
list, _ := payload["scan"].([]any)
for _, v := range list {
row := v.(map[string]any)
rows[row["root"].(string)] = row
}
return rows
}
func loadProjects(t *testing.T, sb *testutil.Sandbox) map[string]config.ManagedProject {
t.Helper()
cfg, err := config.LoadReadOnlyPath(sb.ConfigPath)
if err != nil {
t.Fatal(err)
}
return cfg.Projects
}
func TestProjectScan_RegistersCheckouts(t *testing.T) {
sb, suite := scanFixture(t)
r := sb.RunCLI("project", "add", suite, "--scan", ".", "--scan", ".worktrees", "--target", "codex", "--skills-include", "team-*", "--json")
r.AssertSuccess(t)
rows := scanRows(t, projectJSON(t, r))
projects := loadProjects(t, sb)
for _, rel := range []string{"", "app-a", "app-b", ".worktrees/app-a-fix", "nested/deep/lib"} {
root := filepath.Join(suite, rel)
p, ok := projects[root]
if !ok {
t.Fatalf("%s not registered; projects: %v", root, projects)
}
if p.Name != "" || p.Skills == nil || len(p.Skills.Include) != 1 {
t.Fatalf("%s registered with %+v", root, p)
}
if rows[root]["result"] != "added" {
t.Fatalf("%s row: %v", root, rows[root])
}
}
for _, rel := range []string{"docs", "node_modules/pkg"} {
if _, ok := projects[filepath.Join(suite, rel)]; ok {
t.Fatalf("%s must not be registered", rel)
}
}
}
func TestProjectScan_DryRunWritesNothing(t *testing.T) {
sb, suite := scanFixture(t)
before := sb.ReadFile(sb.ConfigPath)
r := sb.RunCLI("project", "add", suite, "--scan", ".", "--target", "codex", "-n", "--json")
r.AssertSuccess(t)
payload := projectJSON(t, r)
if payload["applied"] != false || scanRows(t, payload)[filepath.Join(suite, "app-a")]["result"] != "added" {
t.Fatalf("preview: %s", r.Stdout)
}
if sb.ReadFile(sb.ConfigPath) != before {
t.Fatal("dry run wrote config.yaml")
}
}
func TestProjectScan_RescanOnlyAdds(t *testing.T) {
sb, suite := scanFixture(t)
args := []string{"project", "add", suite, "--scan", ".", "--target", "codex", "--json"}
sb.RunCLI(args...).AssertSuccess(t)
sb.RunCLI("project", "edit", filepath.Join(suite, "app-b"), "--target", "codex,claude").AssertSuccess(t)
mkCheckout(t, filepath.Join(suite, "tools"))
sb.WriteFile(filepath.Join(suite, "tools", ".skillshare", "config.yaml"), "targets: {}\n")
mkCheckout(t, filepath.Join(suite, "app-c"))
r := sb.RunCLI(args...)
r.AssertSuccess(t)
rows := scanRows(t, projectJSON(t, r))
want := map[string]string{"": "kept", "app-a": "kept", "app-b": "skipped", "tools": "skipped", "app-c": "added"}
for rel, result := range want {
if row := rows[filepath.Join(suite, rel)]; row["result"] != result {
t.Fatalf("%q: got %v, want %s", rel, row, result)
}
}
if reason, _ := rows[filepath.Join(suite, "app-b")]["reason"].(string); !strings.Contains(reason, "skillshare project edit app-b") {
t.Fatalf("app-b reason: %q", reason)
}
if reason, _ := rows[filepath.Join(suite, "tools")]["reason"].(string); !strings.Contains(reason, ".skillshare") {
t.Fatalf("tools reason: %q", reason)
}
projects := loadProjects(t, sb)
if got := projects[filepath.Join(suite, "app-b")].Targets; len(got) != 2 {
t.Fatalf("rescan changed app-b's targets: %v", got)
}
if _, ok := projects[filepath.Join(suite, "tools")]; ok {
t.Fatal("tools has its own config and must not be registered")
}
before := sb.ReadFile(sb.ConfigPath)
sb.RunCLI(args...).AssertSuccess(t)
if sb.ReadFile(sb.ConfigPath) != before {
t.Fatal("a rescan with nothing new rewrote config.yaml")
}
}
func TestProjectScan_LeavesRegisteredRootAlone(t *testing.T) {
sb, suite := scanFixture(t)
sb.RunCLI("project", "add", suite, "--target", "claude").AssertSuccess(t)
r := sb.RunCLI("project", "add", suite, "--scan", ".", "--target", "codex", "--json")
r.AssertSuccess(t)
payload := projectJSON(t, r)
if row := scanRows(t, payload)[suite]; row["result"] != "skipped" {
t.Fatalf("root row: %v", row)
}
if project, _ := payload["project"].(map[string]any); project["root"] != suite {
t.Fatalf("project must be the root: %v", payload["project"])
}
projects := loadProjects(t, sb)
if got := projects[suite].Targets; len(got) != 1 || got[0] != "claude" {
t.Fatalf("root targets changed: %v", got)
}
if got := projects[filepath.Join(suite, "app-a")].Targets; len(got) != 1 || got[0] != "codex" {
t.Fatalf("app-a targets: %v", got)
}
}
func TestProjectScan_MachineLocal(t *testing.T) {
sb, suite := scanFixture(t)
before := sb.ReadFile(sb.ConfigPath)
sb.RunCLI("project", "add", suite, "--scan", ".", "--target", "codex", "--machine-local").AssertSuccess(t)
if sb.ReadFile(sb.ConfigPath) != before {
t.Fatal("--machine-local changed config.yaml")
}
if local := localRegistry(t, sb.ConfigPath); !strings.Contains(local, filepath.Join(suite, "app-a")) {
t.Fatalf("local registry lacks app-a:\n%s", local)
}
}
func TestProjectScan_SyncsEachCheckout(t *testing.T) {
sb, suite := scanFixture(t)
sb.CreateSkill("alpha", map[string]string{"SKILL.md": "---\nname: alpha\n---\n# Alpha\n"})
r := sb.RunCLI("project", "add", suite, "--scan", ".", "--target", "claude", "--sync")
r.AssertSuccess(t)
for _, rel := range []string{"", "app-a", "app-b"} {
if _, err := os.Stat(filepath.Join(suite, rel, ".claude", "skills", "alpha", "SKILL.md")); err != nil {
t.Fatalf("%q not synced: %v\n%s", rel, err, r.Stdout)
}
}
}
func TestProjectScan_SyncFailureStopsNoOtherCheckout(t *testing.T) {
sb, suite := scanFixture(t)
sb.CreateSkill("alpha", map[string]string{"SKILL.md": "---\nname: alpha\n---\n# Alpha\n"})
// A file where app-a's skills folder belongs makes that target invalid.
sb.WriteFile(filepath.Join(suite, "app-a", ".claude", "skills"), "blocked")
args := []string{"project", "add", suite, "--scan", ".", "--target", "claude", "--sync", "--json"}
before := sb.ReadFile(sb.ConfigPath)
preview := sb.RunCLI(append(args, "-n")...)
if preview.ExitCode == 0 || sb.ReadFile(sb.ConfigPath) != before {
t.Fatalf("preview: exit %d, config changed %v: %s", preview.ExitCode, sb.ReadFile(sb.ConfigPath) != before, preview.Stdout)
}
if _, err := os.Stat(filepath.Join(suite, "app-b", ".claude")); err == nil {
t.Fatal("preview synced app-b")
}
r := sb.RunCLI(args...)
if r.ExitCode == 0 {
t.Fatalf("a failed checkout sync must exit 1: %s", r.Stdout)
}
rows := scanRows(t, projectJSON(t, r))
if rows[filepath.Join(suite, "app-a")]["error"] == nil || rows[filepath.Join(suite, "app-b")]["error"] != nil {
t.Fatalf("row errors: %v", rows)
}
if _, err := os.Stat(filepath.Join(suite, "app-b", ".claude", "skills", "alpha", "SKILL.md")); err != nil {
t.Fatalf("app-b not synced after app-a failed: %v", err)
}
}
func TestProjectScan_Folders(t *testing.T) {
sb, suite := scanFixture(t)
for _, dir := range []string{"..", filepath.Join(sb.Home, "other")} {
r := sb.RunCLI("project", "add", suite, "--scan", dir, "--target", "codex")
if r.ExitCode == 0 {
t.Fatalf("--scan %s accepted", dir)
}
}
r := sb.RunCLI("project", "add", suite, "--scan", ".worktrees", "--scan", "later", "--target", "codex", "--json")
r.AssertSuccess(t)
if warnings, _ := projectJSON(t, r)["warnings"].([]any); len(warnings) != 1 || !strings.Contains(warnings[0].(string), "later") {
t.Fatalf("missing folder warning: %s", r.Stdout)
}
if r := sb.RunCLI("project", "edit", suite, "--scan", "."); r.ExitCode == 0 {
t.Fatal("--scan accepted by project edit")
}
}
+4
View File
@@ -4,6 +4,8 @@ import type {
ProjectInput,
ProjectList,
ProjectMutation,
ProjectScan,
ProjectScanInput,
SkillsDetach,
SkillsOffPreview,
Target,
@@ -21,6 +23,8 @@ export const targetsApi = {
http.delete<ProjectMutation>(
`/projects?root=${encodeURIComponent(root)}${shared ? '&shared=true' : ''}`,
),
/** Adds root and each Git checkout below the scan folders; a dry run writes nothing. */
scanProjects: (input: ProjectScanInput) => http.post<ProjectScan>('/projects/scan', input),
convertProject: (root: string) => http.post<ProjectMutation>('/projects/convert', { root }),
/** skillsEnabled false adds a target that skillshare writes no skills to, and creates no skills folder. */
addTarget: (
+31
View File
@@ -35,6 +35,37 @@ export type ProjectInput = Pick<Project, 'root' | 'targets' | 'skills' | 'agents
export type ProjectStorage = 'shared' | 'local';
/** A project add that also adds each Git checkout below the scan folders. */
export type ProjectScanInput = Omit<ProjectInput, 'create'> & { scan: string[]; dryRun: boolean };
/** One folder a scan considered: the picked folder or a checkout below it. */
export interface ProjectScanRow {
/** The stored root key */
root: string;
/** Relative to the picked folder; "." for the folder itself */
path: string;
name: string;
result: 'added' | 'kept' | 'skipped';
/** Why the folder was skipped, as a code */
skip?: string;
/** The CLI's English reason, shown for a skip code the dashboard does not know */
reason?: string;
}
export interface ProjectScanWarning {
kind: 'missing' | 'unreadable';
folder: string;
detail?: string;
}
export interface ProjectScan {
/** False for a dry run, or when nothing new was found */
applied: boolean;
rows: ProjectScanRow[];
/** Scan folders that do not exist, and folders that could not be read */
warnings: ProjectScanWarning[];
}
export interface ProjectMutation {
success: boolean;
root: string;
@@ -2,12 +2,18 @@ import { render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { api } from '../../api/client';
import { mcpApi } from '../../api/mcp';
import { I18nProvider } from '../../i18n';
import AddProjectDialog from './AddProjectDialog';
vi.mock('../../api/client', async (load) => ({
...(await load<typeof import('../../api/client')>()),
api: { saveProject: vi.fn() },
api: { saveProject: vi.fn(), scanProjects: vi.fn() },
}));
vi.mock('../../api/mcp', async (load) => ({
...(await load<typeof import('../../api/mcp')>()),
mcpApi: { save: vi.fn() },
}));
vi.mock('./ProjectTools', () => ({
@@ -25,6 +31,8 @@ const storagePaths = {
local: '/home/me/.local/state/skillshare/projects/a.yaml',
};
const onScanned = vi.fn();
const open = (defaultStorage?: 'shared' | 'local') =>
render(
<I18nProvider>
@@ -36,6 +44,7 @@ const open = (defaultStorage?: 'shared' | 'local') =>
existing={[]}
onClose={() => {}}
onAdded={() => {}}
onScanned={onScanned}
/>
</I18nProvider>,
);
@@ -85,4 +94,72 @@ describe('Add project dialog', () => {
expect(api.saveProject).toHaveBeenCalledWith(expect.objectContaining({ storage: 'local' })),
);
});
it('writes checkouts only after their review is confirmed', async () => {
const row = (path: string) => ({
root: `~/work/docs/${path}`,
path,
name: path,
result: 'added' as const,
});
vi.mocked(api.scanProjects)
.mockResolvedValueOnce({ applied: false, rows: [row('.'), row('app-a')], warnings: [] })
.mockResolvedValueOnce({ applied: true, rows: [row('.'), row('app-a')], warnings: [] });
open();
await userEvent.click(screen.getByRole('checkbox', { name: /Also add each checkout/ }));
await userEvent.type(screen.getByLabelText('Look in'), '.worktrees{Enter}');
await userEvent.type(screen.getByLabelText('Project folder'), '~/work/docs');
await userEvent.click(screen.getByRole('button', { name: 'pick claude' }));
await userEvent.click(screen.getByRole('button', { name: 'Review' }));
await screen.findByRole('button', { name: 'Add 2 projects' });
expect(api.scanProjects).toHaveBeenCalledTimes(1);
expect(api.scanProjects).toHaveBeenLastCalledWith(
expect.objectContaining({ root: '~/work/docs', scan: ['.', '.worktrees'], dryRun: true }),
);
await userEvent.click(screen.getByRole('button', { name: 'Add 2 projects' }));
await waitFor(() => expect(onScanned).toHaveBeenCalledWith(2));
expect(api.scanProjects).toHaveBeenLastCalledWith(
expect.objectContaining({ scan: ['.', '.worktrees'], dryRun: false }),
);
// The default storage is left to the server, as the CLI does without a flag.
expect(vi.mocked(api.scanProjects).mock.lastCall?.[0].storage).toBeUndefined();
expect(api.saveProject).not.toHaveBeenCalled();
});
it('stays open when the write finds nothing left to add', async () => {
const row = (path: string, result: 'added' | 'kept') => ({
root: `~/work/docs/${path}`,
path,
name: path,
result,
});
vi.mocked(api.scanProjects)
.mockResolvedValueOnce({ applied: false, rows: [row('.', 'added')], warnings: [] })
.mockResolvedValueOnce({ applied: false, rows: [row('.', 'kept')], warnings: [] });
open();
await userEvent.click(screen.getByRole('checkbox', { name: /Also add each checkout/ }));
await userEvent.type(screen.getByLabelText('Project folder'), '~/work/docs');
await userEvent.click(screen.getByRole('button', { name: 'pick claude' }));
await userEvent.click(screen.getByRole('button', { name: 'Review' }));
await userEvent.click(await screen.findByRole('button', { name: 'Add 1 project' }));
await screen.findByText('Nothing new to add.');
expect(onScanned).not.toHaveBeenCalled();
});
it('returns to the form with the error when MCP fails after the write', async () => {
const row = { root: '~/work/docs', path: '.', name: 'docs', result: 'added' as const };
vi.mocked(api.scanProjects).mockResolvedValue({ applied: true, rows: [row], warnings: [] });
vi.mocked(mcpApi.save).mockRejectedValue(new Error('mcp save failed'));
open();
await userEvent.click(screen.getByRole('checkbox', { name: /^MCP/ }));
await userEvent.click(screen.getByRole('checkbox', { name: /Also add each checkout/ }));
await userEvent.type(screen.getByLabelText('Project folder'), '~/work/docs');
await userEvent.click(screen.getByRole('button', { name: 'pick claude' }));
await userEvent.click(screen.getByRole('button', { name: 'Review' }));
await userEvent.click(await screen.findByRole('button', { name: 'Add 1 project' }));
await screen.findByText('mcp save failed');
expect(screen.getByRole('button', { name: 'Review' })).toBeInTheDocument();
expect(onScanned).not.toHaveBeenCalled();
});
});
+308 -102
View File
@@ -1,6 +1,7 @@
import { useState } from 'react';
import { Check, Folder, X } from 'lucide-react';
import { api, type ProjectList, type ProjectStorage } from '../../api/client';
import { Link } from 'react-router-dom';
import { ArrowLeft, Check, Folder, TriangleAlert, X } from 'lucide-react';
import { api, type ProjectList, type ProjectScan, type ProjectStorage } from '../../api/client';
import { hooksApi } from '../../api/hooks';
import { mcpApi, mcpTargets } from '../../api/mcp';
import Button from '../Button';
@@ -8,8 +9,10 @@ import { Select } from '../Select';
import DialogShell from '../DialogShell';
import { useT, plural } from '../../i18n';
import { shortenHome } from '../../lib/paths';
import PatternInput from '../targets/PatternInput';
import ProjectTools from './ProjectTools';
import { toolGroups } from './projectView';
import { baseName, projectUrl, toolGroups } from './projectView';
import { opensProject, renamed, scanCounts, scanNote, scanWarning } from './scanView';
interface Props {
tools: ProjectList['tools'];
@@ -22,12 +25,28 @@ interface Props {
existing: string[];
onClose: () => void;
onAdded: (root: string) => void;
/** After adding a folder's checkouts too; count is how many projects were added */
onScanned: (count: number) => void;
}
const PARTS = ['skills', 'agents', 'mcp', 'hooks'] as const;
type PartName = (typeof PARTS)[number];
const PART_LABEL: Record<PartName, string> = {
skills: 'Skills',
agents: 'Agents',
mcp: 'MCP',
hooks: 'Hooks',
};
const RESULT = {
added: { label: 'Added', tone: 'ok' },
kept: { label: 'Kept', tone: 'off' },
skipped: { label: 'Skipped', tone: 'warn' },
} as const;
/** Add one folder to projects. Filters and MCP servers are edited on the project's page. */
/**
* Add one folder to projects, or that folder and each Git checkout inside it
* after a review. Filters and MCP servers are edited on the project's page.
*/
export default function AddProjectDialog({
tools,
common,
@@ -36,6 +55,7 @@ export default function AddProjectDialog({
existing,
onClose,
onAdded,
onScanned,
}: Props) {
const t = useT();
const [path, setPath] = useState('');
@@ -47,19 +67,38 @@ export default function AddProjectDialog({
hooks: false,
});
const [storage, setStorage] = useState<ProjectStorage>(defaultStorage);
const [scan, setScan] = useState(false);
const [scanDirs, setScanDirs] = useState<string[]>(['.']);
// The dry run being reviewed; nothing is written until it is confirmed.
const [review, setReview] = useState<ProjectScan | null>(null);
const [error, setError] = useState('');
const [saving, setSaving] = useState(false);
// Trailing separators aside, this is the key config.yaml will hold.
const root = path.trim().replace(/(?<=.)[\\/]+$/, '');
const absolute = /^(~($|[\\/])|\/|[A-Za-z]:[\\/])/.test(root);
const taken = existing.some((x) => x === root || shortenHome(x) === root);
const project = (key: string) => existing.find((x) => x === key || shortenHome(x) === key);
// A scan keeps a folder that is already a project, so only a single add refuses it.
const taken = !scan && Boolean(project(root));
const pathError =
root && !absolute ? t('projects.add.folderHint') : taken ? t('projects.add.taken') : '';
// The server refuses these too, but in CLI words.
const scanError =
scan && scanDirs.some((d) => /^([\\/]|[A-Za-z]:)/.test(d) || d.split(/[\\/]/).includes('..'))
? t('projects.scan.inside')
: '';
const agentTools = targets.filter((x) => tools.find((tool) => tool.name === x)?.agentsPath);
const folders = toolGroups(tools, targets).length;
const counts = scanCounts(review?.rows ?? []);
const canSave =
Boolean(root) && !pathError && targets.length > 0 && PARTS.some((p) => parts[p]) && !saving;
Boolean(root) &&
!pathError &&
targets.length > 0 &&
PARTS.some((p) => parts[p]) &&
(!scan || scanDirs.length > 0) &&
!scanError &&
(!review || counts.added > 0) &&
!saving;
const partHint = (p: PartName) => {
if (p === 'agents' && targets.length > 0) {
@@ -93,30 +132,62 @@ export default function AddProjectDialog({
},
];
// MCP and hooks are not part of a project entry; each new project gets them here.
const addParts = async (roots: string[]) => {
const clients = mcpTargets.filter((x) => targets.includes(x));
for (const project of roots) {
if (parts.mcp) {
await mcpApi.save({
project,
settings: { targets: clients.length > 0 ? clients : undefined },
});
}
// An empty hooks block: the project's own hooks are added on its Hooks tab.
if (parts.hooks) await hooksApi.save({ project });
}
};
const save = async () => {
if (!canSave) return;
setSaving(true);
setError('');
const all = { mode: '', include: [], exclude: [] };
const settings = {
// Like the CLI without a flag, the default storage keeps a project saved in the other place.
storage: scan && storage === defaultStorage ? undefined : storage,
root,
targets,
skills: parts.skills ? all : null,
agents: parts.agents ? all : null,
};
try {
const saved = await api.saveProject({
create: true,
storage,
root,
targets,
skills: parts.skills ? all : null,
agents: parts.agents ? all : null,
});
if (parts.mcp) {
const clients = mcpTargets.filter((x) => targets.includes(x));
await mcpApi.save({
project: root,
settings: { targets: clients.length > 0 ? clients : undefined },
});
if (!scan) {
const saved = await api.saveProject({ create: true, ...settings });
await addParts([saved.root]);
onAdded(saved.root);
return;
}
// An empty hooks block: the project's own hooks are added on its Hooks tab.
if (parts.hooks) await hooksApi.save({ project: saved.root });
onAdded(saved.root);
const result = await api.scanProjects({ ...settings, scan: scanDirs, dryRun: !review });
if (!review) {
setReview(result);
setSaving(false);
return;
}
// The write scans again, so count what it added, not what was reviewed.
const added = result.rows.filter((r) => r.result === 'added').map((r) => r.root);
if (added.length === 0) {
setReview(result);
setSaving(false);
return;
}
try {
await addParts(added);
} catch (e) {
// The projects are saved; a new review would only show them as kept.
setReview(null);
throw e;
}
onScanned(added.length);
} catch (e) {
setError((e as Error).message);
setSaving(false);
@@ -132,8 +203,21 @@ export default function AddProjectDialog({
ariaLabel={t('projects.add.title')}
className="!max-w-[640px]"
>
<div className="dh">
<h2 className="ss-h2">{t('projects.add.title')}</h2>
<div className={`dh ${review ? '!gap-2' : ''}`}>
{review && (
<button
type="button"
className="ss-ib"
aria-label={t('common.back')}
onClick={() => setReview(null)}
disabled={saving}
>
<ArrowLeft size={16} />
</button>
)}
<h2 className="ss-h2 flex-1">
{t(review ? 'projects.scan.reviewTitle' : 'projects.add.title')}
</h2>
<button
type="button"
className="ss-ib"
@@ -152,79 +236,193 @@ export default function AddProjectDialog({
void save();
}}
>
<div className="ss-fld">
<label htmlFor="add-project-path">{t('projects.add.folder')}</label>
<span className={`ss-inp font-mono ${pathError ? 'err' : ''}`}>
<Folder size={15} className="shrink-0 text-ink-3" />
<input
id="add-project-path"
autoFocus
value={path}
onChange={(e) => setPath(e.target.value)}
placeholder="~/work/my-project"
disabled={saving}
/>
</span>
<span className={`hp ${pathError ? '!text-bad' : ''}`}>
{pathError || t('projects.add.folderHint')}
</span>
</div>
<div className="ss-fld">
<span className="text-[13px] font-semibold">{t('projects.targets')}</span>
<ProjectTools
tools={tools}
common={common}
selected={targets}
onChange={setTargets}
disabled={saving}
/>
<span className="hp">{t('projects.add.targetsHint')}</span>
{folders > 0 && (
<span className="hp">
{t(plural('projects.add.writes', folders), { count: folders })}
</span>
)}
</div>
<div className="ss-fld">
<span className="text-[13px] font-semibold">{t('projects.add.parts')}</span>
<div className="ss-list">
{PARTS.map((p, i) => (
<button
key={p}
type="button"
role="checkbox"
aria-checked={parts[p]}
className={`flex min-h-[52px] w-full items-center gap-3 px-4 py-2 text-left ${i > 0 ? 'border-t border-line-soft' : ''}`}
onClick={() => setParts({ ...parts, [p]: !parts[p] })}
{review ? (
<>
<div className="flex flex-col gap-1">
<span className="font-mono text-[13px] font-semibold">{root}</span>
<span className="text-[13px] text-ink-2">
{t('projects.scan.same', {
targets: targets.join(', '),
parts: PARTS.filter((p) => parts[p])
.map((p) => PART_LABEL[p])
.join(' · '),
})}
</span>
</div>
<div className="flex flex-wrap gap-4">
<span className="ss-st ok">
{t(plural('projects.scan.toAdd', counts.added), { count: counts.added })}
</span>
{counts.kept > 0 && (
<span className="ss-st off">
{t(plural('projects.scan.already', counts.kept), { count: counts.kept })}
</span>
)}
{counts.skipped > 0 && (
<span className="ss-st warn">
{t(plural('projects.scan.skipped', counts.skipped), { count: counts.skipped })}
</span>
)}
</div>
<div className="ss-list">
{review.rows.map((row, i) => {
const note = scanNote(row);
const target = opensProject(row) ? project(row.root) : undefined;
return (
<div
key={row.root}
className={`flex min-h-[52px] items-start gap-3 px-4 py-2.5 ${i > 0 ? 'border-t border-line-soft' : ''}`}
>
<span className="flex min-w-0 flex-1 flex-col gap-0.5">
<span className="flex flex-wrap items-center gap-2">
<span className="font-mono text-[13px] font-semibold break-all">
{row.path === '.' ? baseName(root) : row.path}
</span>
{renamed(row) && <span className="ss-tag">{row.name}</span>}
</span>
{(note || row.reason) && (
<span className="text-[13px] text-ink-2">
{note ? t(note.key, note.params) : row.reason}
{target && (
<>
{' '}
<Link to={projectUrl(target)} className="text-accent hover:underline">
{t('projects.scan.open', { name: row.name })}
</Link>
</>
)}
</span>
)}
</span>
<span className={`ss-st w-[72px] shrink-0 ${RESULT[row.result].tone}`}>
{RESULT[row.result].label}
</span>
</div>
);
})}
</div>
{review.warnings.length > 0 && (
<div className="ss-note warn">
<TriangleAlert size={16} />
<span className="flex flex-1 flex-col gap-1">
{review.warnings.map((w) => {
const message = scanWarning(w);
return (
<span key={`${w.kind}:${w.folder}`}>{t(message.key, message.params)}</span>
);
})}
</span>
</div>
)}
{counts.added === 0 && <span className="hp">{t('projects.scan.nothing')}</span>}
</>
) : (
<>
<div className="ss-fld">
<label htmlFor="add-project-path">{t('projects.add.folder')}</label>
<span className={`ss-inp font-mono ${pathError ? 'err' : ''}`}>
<Folder size={15} className="shrink-0 text-ink-3" />
<input
id="add-project-path"
autoFocus
value={path}
onChange={(e) => setPath(e.target.value)}
placeholder="~/work/my-project"
disabled={saving}
/>
</span>
<span className={`hp ${pathError ? '!text-bad' : ''}`}>
{pathError || t('projects.add.folderHint')}
</span>
</div>
<div className="ss-fld">
<span className="text-[13px] font-semibold">{t('projects.targets')}</span>
<ProjectTools
tools={tools}
common={common}
selected={targets}
onChange={setTargets}
disabled={saving}
>
<span className={`ss-chk ${parts[p] ? 'on' : ''}`}>
{parts[p] && <Check size={12} strokeWidth={3} />}
/>
<span className="hp">{t('projects.add.targetsHint')}</span>
{folders > 0 && (
<span className="hp">
{t(plural('projects.add.writes', folders), { count: folders })}
</span>
<span className="flex flex-col gap-px">
<span className="text-[14px] font-semibold">
{p === 'mcp'
? 'MCP'
: p === 'hooks'
? 'Hooks'
: p === 'agents'
? 'Agents'
: 'Skills'}
)}
</div>
<div className="ss-fld">
<span className="text-[13px] font-semibold">{t('projects.add.parts')}</span>
<div className="ss-list">
{PARTS.map((p, i) => (
<button
key={p}
type="button"
role="checkbox"
aria-checked={parts[p]}
className={`flex min-h-[52px] w-full items-center gap-3 px-4 py-2 text-left ${i > 0 ? 'border-t border-line-soft' : ''}`}
onClick={() => setParts({ ...parts, [p]: !parts[p] })}
disabled={saving}
>
<span className={`ss-chk ${parts[p] ? 'on' : ''}`}>
{parts[p] && <Check size={12} strokeWidth={3} />}
</span>
<span className="flex flex-col gap-px">
<span className="text-[14px] font-semibold">{PART_LABEL[p]}</span>
<span className="text-[13px] text-ink-2">{partHint(p)}</span>
</span>
</button>
))}
</div>
</div>
<div className="ss-fld">
<span className="text-[13px] font-semibold">{t('projects.scan.title')}</span>
<div className="ss-list">
<button
type="button"
role="checkbox"
aria-checked={scan}
className="flex min-h-[52px] w-full items-center gap-3 px-4 py-2 text-left"
onClick={() => setScan(!scan)}
disabled={saving}
>
<span className={`ss-chk ${scan ? 'on' : ''}`}>
{scan && <Check size={12} strokeWidth={3} />}
</span>
<span className="text-[13px] text-ink-2">{partHint(p)}</span>
</span>
</button>
))}
</div>
</div>
<span className="flex flex-col gap-px">
<span className="text-[14px] font-semibold">{t('projects.scan.toggle')}</span>
<span className="text-[13px] text-ink-2">{t('projects.scan.toggleHint')}</span>
</span>
</button>
{scan && (
<div className="flex flex-col gap-2 border-t border-line-soft bg-sunken px-4 py-3">
<label htmlFor="add-project-scan" className="text-[13px] text-ink-2">
{t('projects.scan.lookIn')}
</label>
<PatternInput
id="add-project-scan"
patterns={scanDirs}
onChange={setScanDirs}
placeholder={t('projects.scan.addFolder')}
disabled={saving}
/>
<span className={`hp ${scanError ? '!text-bad' : ''}`}>
{scanError || t('projects.scan.foldersHint')}
</span>
</div>
)}
</div>
</div>
</>
)}
{error && (
<div className="ss-note bad">
<span className="flex-1">{error}</span>
</div>
)}
</form>
<div className="df">
<span className="flex flex-1 items-center gap-1 text-[13px] text-ink-3">
<div className="df flex-wrap">
<span className="flex flex-1 items-center gap-1 text-[13px] whitespace-nowrap text-ink-3">
{t('projects.add.savedTo')}
<Select
quiet
@@ -233,21 +431,29 @@ export default function AddProjectDialog({
value={storage}
onChange={(v) => setStorage(v as ProjectStorage)}
options={storageOptions}
disabled={saving}
disabled={saving || Boolean(review)}
/>
</span>
<Button variant="ghost" onClick={onClose} disabled={saving}>
{t('common.cancel')}
</Button>
<Button
type="submit"
form="add-project"
variant="primary"
loading={saving}
disabled={!canSave}
>
{t('projects.add.submit')}
</Button>
<span className="ml-auto flex gap-2">
<Button
variant="ghost"
onClick={review ? () => setReview(null) : onClose}
disabled={saving}
>
{t(review ? 'common.back' : 'common.cancel')}
</Button>
<Button
type="submit"
form="add-project"
variant="primary"
loading={saving}
disabled={!canSave}
>
{review
? t(plural('projects.scan.submit', counts.added), { count: counts.added })
: t(scan ? 'projects.scan.review' : 'projects.add.submit')}
</Button>
</span>
</div>
</DialogShell>
);
@@ -0,0 +1,39 @@
import { describe, expect, it } from 'vitest';
import type { ProjectScanRow } from '../../api/client';
import { scanCounts, scanNote } from './scanView';
const row = (path: string, name: string, result: ProjectScanRow['result'], skip?: string) => ({
root: `/w/suite/${path}`,
path,
name,
result,
skip,
});
describe('scan review', () => {
it('counts each result', () => {
const rows = [row('.', 'suite', 'added'), row('a', 'a', 'kept'), row('b', 'b', 'skipped')];
expect(scanCounts(rows)).toEqual({ added: 1, kept: 1, skipped: 1 });
});
it('explains a checkout named from its path', () => {
expect(scanNote(row('.worktrees/app-a', 'worktrees-app-a', 'added'))).toEqual({
key: 'projects.scan.renamed',
params: { base: 'app-a' },
});
});
it('says nothing about a checkout that keeps its folder name', () => {
expect(scanNote(row('app-a', 'app-a', 'added'))).toBeNull();
});
it('words a known skip code', () => {
expect(scanNote(row('app-c', 'app-c', 'skipped', 'different'))?.key).toBe(
'projects.scan.skip.different',
);
});
it('leaves an unknown skip code to the server reason', () => {
expect(scanNote(row('app-c', 'app-c', 'skipped', 'future-code'))).toBeNull();
});
});
+52
View File
@@ -0,0 +1,52 @@
import type { ProjectScanRow, ProjectScanWarning } from '../../api/client';
import { baseName } from './projectView';
export interface ScanMessage {
key: string;
params?: Record<string, string>;
}
/** How many folders each result has, for the review summary and its add button. */
export function scanCounts(rows: ProjectScanRow[]) {
const count = (result: ProjectScanRow['result']) =>
rows.filter((r) => r.result === result).length;
return { added: count('added'), kept: count('kept'), skipped: count('skipped') };
}
const SKIP: Record<string, string> = {
different: 'projects.scan.skip.different',
storage: 'projects.scan.skip.storage',
removed: 'projects.scan.skip.removed',
'own-config': 'projects.scan.skip.ownConfig',
'name-taken': 'projects.scan.skip.nameTaken',
'bad-name': 'projects.scan.skip.badName',
};
/** Skipped rows whose settings are changed on the project's own page. */
export const opensProject = (row: ProjectScanRow) =>
row.skip === 'different' || row.skip === 'storage';
/** A checkout named from its path because its folder name is taken. */
export const renamed = (row: ProjectScanRow) =>
row.result === 'added' && row.path !== '.' && row.name !== baseName(row.path);
/**
* The line under a row. Null means no line, or, for a skipped row, a skip code
* this dashboard does not know: show the server's reason then.
*/
export function scanNote(row: ProjectScanRow): ScanMessage | null {
if (row.result === 'skipped') {
const key = row.skip ? SKIP[row.skip] : undefined;
return key ? { key, params: { name: row.name } } : null;
}
if (row.result === 'kept') return { key: 'projects.scan.kept' };
if (row.path === '.') return { key: 'projects.scan.picked' };
if (renamed(row)) return { key: 'projects.scan.renamed', params: { base: baseName(row.path) } };
return null;
}
export function scanWarning(w: ProjectScanWarning): ScanMessage {
return w.kind === 'missing'
? { key: 'projects.scan.missing', params: { folder: w.folder } }
: { key: 'projects.scan.unreadable', params: { folder: w.folder, detail: w.detail ?? '' } };
}
+3 -1
View File
@@ -8,11 +8,13 @@ export default function PatternInput({
patterns,
onChange,
disabled,
placeholder,
}: {
id: string;
patterns: string[];
onChange: (patterns: string[]) => void;
disabled?: boolean;
placeholder?: string;
}) {
const t = useT();
const [draft, setDraft] = useState('');
@@ -51,7 +53,7 @@ export default function PatternInput({
}
}}
onBlur={commit}
placeholder={t('targetDetail.addPattern')}
placeholder={placeholder ?? t('targetDetail.addPattern')}
disabled={disabled}
/>
</span>
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "Dieser Rechner",
"projects.add.storageLocalHint": "Nicht in config.yaml gespeichert, deine anderen Rechner erhalten es also nicht.",
"projects.added": "{name} hinzugefügt. Führe Sync aus, um zu schreiben.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Auch jeden Checkout in diesem Ordner hinzufügen",
"projects.scan.toggleHint": "Jeder wird ein eigenes Projekt mit diesen Einstellungen. Ordner, die schon Projekte sind, bleiben unverändert.",
"projects.scan.lookIn": "Suchen in",
"projects.scan.addFolder": "Ordner eingeben, z. B. .worktrees, dann Enter drücken",
"projects.scan.foldersHint": "Ordner innerhalb des Projektordners. Versteckte Ordner, node_modules und Links werden übersprungen, also füge einen Ordner wie .worktrees hier hinzu.",
"projects.scan.inside": "Jeder Ordner muss im Projektordner liegen.",
"projects.scan.review": "Prüfen",
"projects.scan.reviewTitle": "Projekte prüfen",
"projects.scan.same": "Jedes neue Projekt bekommt dieselben Einstellungen: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} hinzuzufügen",
"projects.scan.toAdd.other": "{count} hinzuzufügen",
"projects.scan.already.one": "{count} schon ein Projekt",
"projects.scan.already.other": "{count} schon Projekte",
"projects.scan.skipped.one": "{count} übersprungen",
"projects.scan.skipped.other": "{count} übersprungen",
"projects.scan.picked": "Der Ordner, den du gewählt hast.",
"projects.scan.kept": "Schon ein Projekt mit diesen Einstellungen.",
"projects.scan.renamed": "{base} ist vergeben, daher kommt der Name aus dem Pfad.",
"projects.scan.skip.different": "Schon ein Projekt mit anderen Einstellungen.",
"projects.scan.skip.storage": "Schon ein Projekt, am anderen Ort gespeichert.",
"projects.scan.skip.removed": "Auf diesem Rechner entfernt. Füge es einzeln hinzu, um es zurückzuholen.",
"projects.scan.skip.ownConfig": "Hat eine eigene .skillshare/-Projektkonfiguration.",
"projects.scan.skip.nameTaken": "Der Name {name} wird schon verwendet. Füge es einzeln hinzu, um einen Namen zu wählen.",
"projects.scan.skip.badName": "{name} kann kein Projektname sein. Füge es einzeln hinzu, um einen Namen zu wählen.",
"projects.scan.open": "{name} öffnen",
"projects.scan.missing": "{folder} existiert nicht, daher wurde dort nichts gefunden.",
"projects.scan.unreadable": "{folder} konnte nicht gelesen werden ({detail}), daher wurden Checkouts darin nicht geprüft.",
"projects.scan.nothing": "Nichts Neues hinzuzufügen.",
"projects.scan.submit.one": "{count} Projekt hinzufügen",
"projects.scan.submit.other": "{count} Projekte hinzufügen",
"projects.scan.added.one": "{count} Projekt hinzugefügt. Führe Sync aus, um es zu schreiben.",
"projects.scan.added.other": "{count} Projekte hinzugefügt. Führe Sync aus, um sie zu schreiben.",
"projects.saved": "{name} gespeichert.",
"projects.remove": "Projekt entfernen",
"projects.removeTitle": "{name} entfernen?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "This machine",
"projects.add.storageLocalHint": "Not saved in config.yaml, so your other machines won't get it.",
"projects.added": "Added {name}. Run Sync to write it.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Also add each checkout inside this folder",
"projects.scan.toggleHint": "Each one becomes its own project with these settings. Folders that are already projects stay as they are.",
"projects.scan.lookIn": "Look in",
"projects.scan.addFolder": "Type a folder, such as .worktrees, then press Enter",
"projects.scan.foldersHint": "Folders inside the project folder. Hidden folders, node_modules and links are skipped, so add a folder like .worktrees here.",
"projects.scan.inside": "Each folder must be inside the project folder.",
"projects.scan.review": "Review",
"projects.scan.reviewTitle": "Review projects",
"projects.scan.same": "Each new project gets the same settings: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} to add",
"projects.scan.toAdd.other": "{count} to add",
"projects.scan.already.one": "{count} already a project",
"projects.scan.already.other": "{count} already projects",
"projects.scan.skipped.one": "{count} skipped",
"projects.scan.skipped.other": "{count} skipped",
"projects.scan.picked": "The folder you picked.",
"projects.scan.kept": "Already a project with these settings.",
"projects.scan.renamed": "{base} is taken, so the name comes from its path.",
"projects.scan.skip.different": "Already a project with different settings.",
"projects.scan.skip.storage": "Already a project, saved in the other place.",
"projects.scan.skip.removed": "Removed on this machine. Add it on its own to bring it back.",
"projects.scan.skip.ownConfig": "Has its own .skillshare/ project config.",
"projects.scan.skip.nameTaken": "The name {name} is already used. Add it on its own to pick a name.",
"projects.scan.skip.badName": "{name} can't be a project name. Add it on its own to pick a name.",
"projects.scan.open": "Open {name}",
"projects.scan.missing": "{folder} does not exist, so nothing was found there.",
"projects.scan.unreadable": "Could not read {folder} ({detail}), so checkouts inside it were not looked at.",
"projects.scan.nothing": "Nothing new to add.",
"projects.scan.submit.one": "Add {count} project",
"projects.scan.submit.other": "Add {count} projects",
"projects.scan.added.one": "Added {count} project. Run Sync to write it.",
"projects.scan.added.other": "Added {count} projects. Run Sync to write them.",
"projects.saved": "Saved {name}.",
"projects.remove": "Remove project",
"projects.removeTitle": "Remove {name}?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "Esta máquina",
"projects.add.storageLocalHint": "No se guarda en config.yaml, así que tus otras máquinas no lo recibirán.",
"projects.added": "Se añadió {name}. Ejecuta Sync para escribirlo.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Añadir también cada checkout dentro de esta carpeta",
"projects.scan.toggleHint": "Cada uno se convierte en su propio proyecto con esta configuración. Las carpetas que ya son proyectos se quedan como están.",
"projects.scan.lookIn": "Buscar en",
"projects.scan.addFolder": "Escribe una carpeta, como .worktrees, y pulsa Enter",
"projects.scan.foldersHint": "Carpetas dentro de la carpeta del proyecto. Se omiten las carpetas ocultas, node_modules y los enlaces, así que añade aquí una carpeta como .worktrees.",
"projects.scan.inside": "Cada carpeta debe estar dentro de la carpeta del proyecto.",
"projects.scan.review": "Revisar",
"projects.scan.reviewTitle": "Revisar proyectos",
"projects.scan.same": "Cada proyecto nuevo recibe la misma configuración: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} por añadir",
"projects.scan.toAdd.other": "{count} por añadir",
"projects.scan.already.one": "{count} ya es un proyecto",
"projects.scan.already.other": "{count} ya son proyectos",
"projects.scan.skipped.one": "{count} omitido",
"projects.scan.skipped.other": "{count} omitidos",
"projects.scan.picked": "La carpeta que elegiste.",
"projects.scan.kept": "Ya es un proyecto con esta configuración.",
"projects.scan.renamed": "{base} ya está en uso, así que el nombre sale de su ruta.",
"projects.scan.skip.different": "Ya es un proyecto con otra configuración.",
"projects.scan.skip.storage": "Ya es un proyecto, guardado en el otro lugar.",
"projects.scan.skip.removed": "Se quitó en este equipo. Añádelo por separado para recuperarlo.",
"projects.scan.skip.ownConfig": "Tiene su propia configuración de proyecto en .skillshare/.",
"projects.scan.skip.nameTaken": "El nombre {name} ya está en uso. Añádelo por separado para elegir un nombre.",
"projects.scan.skip.badName": "{name} no puede ser un nombre de proyecto. Añádelo por separado para elegir un nombre.",
"projects.scan.open": "Abrir {name}",
"projects.scan.missing": "{folder} no existe, así que no se encontró nada ahí.",
"projects.scan.unreadable": "No se pudo leer {folder} ({detail}), así que no se revisaron los checkouts que contiene.",
"projects.scan.nothing": "No hay nada nuevo que añadir.",
"projects.scan.submit.one": "Añadir {count} proyecto",
"projects.scan.submit.other": "Añadir {count} proyectos",
"projects.scan.added.one": "Se añadió {count} proyecto. Ejecuta Sync para escribirlo.",
"projects.scan.added.other": "Se añadieron {count} proyectos. Ejecuta Sync para escribirlos.",
"projects.saved": "{name} guardado.",
"projects.remove": "Quitar proyecto",
"projects.removeTitle": "¿Quitar {name}?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "این دستگاه",
"projects.add.storageLocalHint": "در config.yaml ذخیره نمی‌شود، پس دستگاه‌های دیگر شما آن را نخواهند داشت.",
"projects.added": "{name} اضافه شد. برای نوشتن آن Sync را اجرا کنید.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "هر checkout داخل این پوشه را هم اضافه کن",
"projects.scan.toggleHint": "هر کدام یک پروژه‌ی جدا با همین تنظیمات می‌شود. پوشه‌هایی که از قبل پروژه هستند همان‌طور می‌مانند.",
"projects.scan.lookIn": "جستجو در",
"projects.scan.addFolder": "نام پوشه را بنویسید، مثل .worktrees، و Enter را بزنید",
"projects.scan.foldersHint": "پوشه‌های داخل پوشه‌ی پروژه. پوشه‌های پنهان، node_modules و لینک‌ها نادیده گرفته می‌شوند، پس پوشه‌ای مثل .worktrees را اینجا اضافه کنید.",
"projects.scan.inside": "هر پوشه باید داخل پوشه‌ی پروژه باشد.",
"projects.scan.review": "بررسی",
"projects.scan.reviewTitle": "بررسی پروژه‌ها",
"projects.scan.same": "هر پروژه‌ی جدید همین تنظیمات را می‌گیرد: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} برای افزودن",
"projects.scan.toAdd.other": "{count} برای افزودن",
"projects.scan.already.one": "{count} از قبل پروژه است",
"projects.scan.already.other": "{count} از قبل پروژه هستند",
"projects.scan.skipped.one": "{count} رد شد",
"projects.scan.skipped.other": "{count} رد شدند",
"projects.scan.picked": "پوشه‌ای که انتخاب کردید.",
"projects.scan.kept": "از قبل پروژه‌ای با همین تنظیمات است.",
"projects.scan.renamed": "{base} قبلاً استفاده شده، پس نام از مسیرش گرفته می‌شود.",
"projects.scan.skip.different": "از قبل پروژه‌ای با تنظیمات متفاوت است.",
"projects.scan.skip.storage": "از قبل پروژه است و در جای دیگری ذخیره شده.",
"projects.scan.skip.removed": "روی این دستگاه حذف شده. برای برگرداندنش آن را جداگانه اضافه کنید.",
"projects.scan.skip.ownConfig": "پیکربندی پروژه‌ی .skillshare/ خودش را دارد.",
"projects.scan.skip.nameTaken": "نام {name} قبلاً استفاده شده. آن را جداگانه اضافه کنید تا نامی انتخاب کنید.",
"projects.scan.skip.badName": "{name} نمی‌تواند نام پروژه باشد. آن را جداگانه اضافه کنید تا نامی انتخاب کنید.",
"projects.scan.open": "باز کردن {name}",
"projects.scan.missing": "{folder} وجود ندارد، پس چیزی آنجا پیدا نشد.",
"projects.scan.unreadable": "{folder} خوانده نشد ({detail})، پس checkoutهای داخلش بررسی نشدند.",
"projects.scan.nothing": "چیز جدیدی برای افزودن نیست.",
"projects.scan.submit.one": "افزودن {count} پروژه",
"projects.scan.submit.other": "افزودن {count} پروژه",
"projects.scan.added.one": "{count} پروژه اضافه شد. برای نوشتن، Sync را اجرا کنید.",
"projects.scan.added.other": "{count} پروژه اضافه شد. برای نوشتن، Sync را اجرا کنید.",
"projects.saved": "{name} ذخیره شد.",
"projects.remove": "حذف پروژه",
"projects.removeTitle": "{name} حذف شود؟",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "Cette machine",
"projects.add.storageLocalHint": "Non enregistré dans config.yaml, donc vos autres machines ne l'auront pas.",
"projects.added": "{name} ajouté. Lancez Sync pour l'écrire.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Ajouter aussi chaque checkout de ce dossier",
"projects.scan.toggleHint": "Chacun devient un projet à part avec ces réglages. Les dossiers qui sont déjà des projets restent tels quels.",
"projects.scan.lookIn": "Chercher dans",
"projects.scan.addFolder": "Saisissez un dossier, par exemple .worktrees, puis appuyez sur Entrée",
"projects.scan.foldersHint": "Dossiers dans le dossier du projet. Les dossiers cachés, node_modules et les liens sont ignorés, ajoutez donc ici un dossier comme .worktrees.",
"projects.scan.inside": "Chaque dossier doit se trouver dans le dossier du projet.",
"projects.scan.review": "Vérifier",
"projects.scan.reviewTitle": "Vérifier les projets",
"projects.scan.same": "Chaque nouveau projet reçoit les mêmes réglages : {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} à ajouter",
"projects.scan.toAdd.other": "{count} à ajouter",
"projects.scan.already.one": "{count} déjà un projet",
"projects.scan.already.other": "{count} déjà des projets",
"projects.scan.skipped.one": "{count} ignoré",
"projects.scan.skipped.other": "{count} ignorés",
"projects.scan.picked": "Le dossier que vous avez choisi.",
"projects.scan.kept": "Déjà un projet avec ces réglages.",
"projects.scan.renamed": "{base} est déjà pris, le nom vient donc de son chemin.",
"projects.scan.skip.different": "Déjà un projet avec d'autres réglages.",
"projects.scan.skip.storage": "Déjà un projet, enregistré à l'autre endroit.",
"projects.scan.skip.removed": "Retiré sur cette machine. Ajoutez-le seul pour le rétablir.",
"projects.scan.skip.ownConfig": "A sa propre configuration de projet .skillshare/.",
"projects.scan.skip.nameTaken": "Le nom {name} est déjà utilisé. Ajoutez-le seul pour choisir un nom.",
"projects.scan.skip.badName": "{name} ne peut pas être un nom de projet. Ajoutez-le seul pour choisir un nom.",
"projects.scan.open": "Ouvrir {name}",
"projects.scan.missing": "{folder} n'existe pas, rien n'y a été trouvé.",
"projects.scan.unreadable": "Impossible de lire {folder} ({detail}), les checkouts qu'il contient n'ont donc pas été examinés.",
"projects.scan.nothing": "Rien de nouveau à ajouter.",
"projects.scan.submit.one": "Ajouter {count} projet",
"projects.scan.submit.other": "Ajouter {count} projets",
"projects.scan.added.one": "{count} projet ajouté. Lancez Sync pour l'écrire.",
"projects.scan.added.other": "{count} projets ajoutés. Lancez Sync pour les écrire.",
"projects.saved": "{name} enregistré.",
"projects.remove": "Retirer le projet",
"projects.removeTitle": "Retirer {name} ?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "Mesin ini",
"projects.add.storageLocalHint": "Tidak disimpan di config.yaml, jadi mesin Anda yang lain tidak akan mendapatkannya.",
"projects.added": "{name} ditambahkan. Jalankan Sync untuk menulisnya.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Tambahkan juga setiap checkout di dalam folder ini",
"projects.scan.toggleHint": "Masing-masing menjadi proyek sendiri dengan pengaturan ini. Folder yang sudah menjadi proyek tetap seperti apa adanya.",
"projects.scan.lookIn": "Cari di",
"projects.scan.addFolder": "Ketik folder, misalnya .worktrees, lalu tekan Enter",
"projects.scan.foldersHint": "Folder di dalam folder proyek. Folder tersembunyi, node_modules, dan tautan dilewati, jadi tambahkan folder seperti .worktrees di sini.",
"projects.scan.inside": "Setiap folder harus berada di dalam folder proyek.",
"projects.scan.review": "Tinjau",
"projects.scan.reviewTitle": "Tinjau proyek",
"projects.scan.same": "Setiap proyek baru mendapat pengaturan yang sama: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} akan ditambahkan",
"projects.scan.toAdd.other": "{count} akan ditambahkan",
"projects.scan.already.one": "{count} sudah menjadi proyek",
"projects.scan.already.other": "{count} sudah menjadi proyek",
"projects.scan.skipped.one": "{count} dilewati",
"projects.scan.skipped.other": "{count} dilewati",
"projects.scan.picked": "Folder yang kamu pilih.",
"projects.scan.kept": "Sudah menjadi proyek dengan pengaturan ini.",
"projects.scan.renamed": "{base} sudah dipakai, jadi namanya diambil dari path-nya.",
"projects.scan.skip.different": "Sudah menjadi proyek dengan pengaturan berbeda.",
"projects.scan.skip.storage": "Sudah menjadi proyek, disimpan di tempat lain.",
"projects.scan.skip.removed": "Dihapus di mesin ini. Tambahkan secara terpisah untuk mengembalikannya.",
"projects.scan.skip.ownConfig": "Punya konfigurasi proyek .skillshare/ sendiri.",
"projects.scan.skip.nameTaken": "Nama {name} sudah dipakai. Tambahkan secara terpisah untuk memilih nama.",
"projects.scan.skip.badName": "{name} tidak bisa menjadi nama proyek. Tambahkan secara terpisah untuk memilih nama.",
"projects.scan.open": "Buka {name}",
"projects.scan.missing": "{folder} tidak ada, jadi tidak ada yang ditemukan di sana.",
"projects.scan.unreadable": "Tidak bisa membaca {folder} ({detail}), jadi checkout di dalamnya tidak diperiksa.",
"projects.scan.nothing": "Tidak ada yang baru untuk ditambahkan.",
"projects.scan.submit.one": "Tambahkan {count} proyek",
"projects.scan.submit.other": "Tambahkan {count} proyek",
"projects.scan.added.one": "{count} proyek ditambahkan. Jalankan Sync untuk menulisnya.",
"projects.scan.added.other": "{count} proyek ditambahkan. Jalankan Sync untuk menulisnya.",
"projects.saved": "{name} disimpan.",
"projects.remove": "Hapus proyek",
"projects.removeTitle": "Hapus {name}?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "このマシン",
"projects.add.storageLocalHint": "config.yaml には保存されないため、他のマシンには入りません。",
"projects.added": "{name} を追加しました。書き込むには同期を実行してください。",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "このフォルダー内の各 checkout も追加",
"projects.scan.toggleHint": "それぞれが同じ設定の独立したプロジェクトになります。すでにプロジェクトのフォルダーはそのままです。",
"projects.scan.lookIn": "検索する場所",
"projects.scan.addFolder": "フォルダーを入力して Enter(例: .worktrees)",
"projects.scan.foldersHint": "プロジェクトフォルダー内のフォルダーです。隠しフォルダー、node_modules、リンクはスキップされるため、.worktrees のようなフォルダーはここで追加してください。",
"projects.scan.inside": "各フォルダーはプロジェクトフォルダー内にある必要があります。",
"projects.scan.review": "確認",
"projects.scan.reviewTitle": "追加するプロジェクトを確認",
"projects.scan.same": "新しいプロジェクトにはすべて同じ設定が使われます: {targets} · {parts}。",
"projects.scan.toAdd.one": "{count} 件を追加",
"projects.scan.toAdd.other": "{count} 件を追加",
"projects.scan.already.one": "{count} 件はすでにプロジェクト",
"projects.scan.already.other": "{count} 件はすでにプロジェクト",
"projects.scan.skipped.one": "{count} 件をスキップ",
"projects.scan.skipped.other": "{count} 件をスキップ",
"projects.scan.picked": "選択したフォルダーです。",
"projects.scan.kept": "同じ設定のプロジェクトとして登録済みです。",
"projects.scan.renamed": "{base} は使用済みのため、パスから名前を付けます。",
"projects.scan.skip.different": "異なる設定のプロジェクトとして登録済みです。",
"projects.scan.skip.storage": "別の保存先に登録済みのプロジェクトです。",
"projects.scan.skip.removed": "このマシンでは削除されています。単独で追加すると元に戻せます。",
"projects.scan.skip.ownConfig": "独自の .skillshare/ プロジェクト設定があります。",
"projects.scan.skip.nameTaken": "名前 {name} はすでに使われています。単独で追加して名前を指定してください。",
"projects.scan.skip.badName": "{name} はプロジェクト名に使えません。単独で追加して名前を指定してください。",
"projects.scan.open": "{name} を開く",
"projects.scan.missing": "{folder} が存在しないため、何も見つかりませんでした。",
"projects.scan.unreadable": "{folder} を読み取れなかったため({detail})、その中の checkout は確認していません。",
"projects.scan.nothing": "新しく追加するプロジェクトはありません。",
"projects.scan.submit.one": "{count} 件のプロジェクトを追加",
"projects.scan.submit.other": "{count} 件のプロジェクトを追加",
"projects.scan.added.one": "{count} 件のプロジェクトを追加しました。Sync を実行すると書き込まれます。",
"projects.scan.added.other": "{count} 件のプロジェクトを追加しました。Sync を実行すると書き込まれます。",
"projects.saved": "{name} を保存しました。",
"projects.remove": "プロジェクトを削除",
"projects.removeTitle": "{name} を削除しますか?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "이 기기",
"projects.add.storageLocalHint": "config.yaml에 저장되지 않으므로 다른 기기에는 생기지 않습니다.",
"projects.added": "{name}을(를) 추가했습니다. 동기화를 실행하면 기록됩니다.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "이 폴더 안의 각 checkout도 추가",
"projects.scan.toggleHint": "각각 같은 설정을 가진 별도의 프로젝트가 됩니다. 이미 프로젝트인 폴더는 그대로 둡니다.",
"projects.scan.lookIn": "찾을 위치",
"projects.scan.addFolder": "폴더를 입력하고 Enter를 누르세요 (예: .worktrees)",
"projects.scan.foldersHint": "프로젝트 폴더 안의 폴더입니다. 숨김 폴더, node_modules, 링크는 건너뛰므로 .worktrees 같은 폴더는 여기에 추가하세요.",
"projects.scan.inside": "각 폴더는 프로젝트 폴더 안에 있어야 합니다.",
"projects.scan.review": "검토",
"projects.scan.reviewTitle": "추가할 프로젝트 검토",
"projects.scan.same": "새 프로젝트는 모두 같은 설정을 사용합니다: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count}개 추가",
"projects.scan.toAdd.other": "{count}개 추가",
"projects.scan.already.one": "{count}개는 이미 프로젝트",
"projects.scan.already.other": "{count}개는 이미 프로젝트",
"projects.scan.skipped.one": "{count}개 건너뜀",
"projects.scan.skipped.other": "{count}개 건너뜀",
"projects.scan.picked": "선택한 폴더입니다.",
"projects.scan.kept": "같은 설정의 프로젝트로 이미 등록되어 있습니다.",
"projects.scan.renamed": "{base} 이름이 이미 사용 중이라 경로로 이름을 붙입니다.",
"projects.scan.skip.different": "다른 설정의 프로젝트로 이미 등록되어 있습니다.",
"projects.scan.skip.storage": "다른 저장 위치에 이미 등록된 프로젝트입니다.",
"projects.scan.skip.removed": "이 기기에서 제거되었습니다. 따로 추가하면 복원됩니다.",
"projects.scan.skip.ownConfig": "자체 .skillshare/ 프로젝트 설정이 있습니다.",
"projects.scan.skip.nameTaken": "이름 {name}은(는) 이미 사용 중입니다. 따로 추가해서 이름을 정하세요.",
"projects.scan.skip.badName": "{name}은(는) 프로젝트 이름으로 쓸 수 없습니다. 따로 추가해서 이름을 정하세요.",
"projects.scan.open": "{name} 열기",
"projects.scan.missing": "{folder}이(가) 없어서 아무것도 찾지 못했습니다.",
"projects.scan.unreadable": "{folder}을(를) 읽을 수 없어({detail}) 그 안의 checkout은 확인하지 않았습니다.",
"projects.scan.nothing": "새로 추가할 프로젝트가 없습니다.",
"projects.scan.submit.one": "프로젝트 {count}개 추가",
"projects.scan.submit.other": "프로젝트 {count}개 추가",
"projects.scan.added.one": "프로젝트 {count}개를 추가했습니다. Sync를 실행하면 기록됩니다.",
"projects.scan.added.other": "프로젝트 {count}개를 추가했습니다. Sync를 실행하면 기록됩니다.",
"projects.saved": "{name}을(를) 저장했습니다.",
"projects.remove": "프로젝트 제거",
"projects.removeTitle": "{name}을(를) 제거하시겠습니까?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "Esta máquina",
"projects.add.storageLocalHint": "Não é salvo em config.yaml, então suas outras máquinas não o receberão.",
"projects.added": "Adicionado {name}. Execute o Sync para gravá-lo.",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "Adicionar também cada checkout dentro desta pasta",
"projects.scan.toggleHint": "Cada um vira um projeto próprio com estas configurações. Pastas que já são projetos ficam como estão.",
"projects.scan.lookIn": "Procurar em",
"projects.scan.addFolder": "Digite uma pasta, como .worktrees, e pressione Enter",
"projects.scan.foldersHint": "Pastas dentro da pasta do projeto. Pastas ocultas, node_modules e links são ignorados, então adicione aqui uma pasta como .worktrees.",
"projects.scan.inside": "Cada pasta precisa estar dentro da pasta do projeto.",
"projects.scan.review": "Revisar",
"projects.scan.reviewTitle": "Revisar projetos",
"projects.scan.same": "Cada novo projeto recebe as mesmas configurações: {targets} · {parts}.",
"projects.scan.toAdd.one": "{count} para adicionar",
"projects.scan.toAdd.other": "{count} para adicionar",
"projects.scan.already.one": "{count} já é um projeto",
"projects.scan.already.other": "{count} já são projetos",
"projects.scan.skipped.one": "{count} ignorado",
"projects.scan.skipped.other": "{count} ignorados",
"projects.scan.picked": "A pasta que você escolheu.",
"projects.scan.kept": "Já é um projeto com estas configurações.",
"projects.scan.renamed": "{base} já está em uso, então o nome vem do caminho.",
"projects.scan.skip.different": "Já é um projeto com outras configurações.",
"projects.scan.skip.storage": "Já é um projeto, salvo no outro lugar.",
"projects.scan.skip.removed": "Removido nesta máquina. Adicione-o sozinho para trazê-lo de volta.",
"projects.scan.skip.ownConfig": "Tem sua própria configuração de projeto em .skillshare/.",
"projects.scan.skip.nameTaken": "O nome {name} já está em uso. Adicione-o sozinho para escolher um nome.",
"projects.scan.skip.badName": "{name} não pode ser um nome de projeto. Adicione-o sozinho para escolher um nome.",
"projects.scan.open": "Abrir {name}",
"projects.scan.missing": "{folder} não existe, então nada foi encontrado lá.",
"projects.scan.unreadable": "Não foi possível ler {folder} ({detail}), então os checkouts dentro dela não foram verificados.",
"projects.scan.nothing": "Nada novo para adicionar.",
"projects.scan.submit.one": "Adicionar {count} projeto",
"projects.scan.submit.other": "Adicionar {count} projetos",
"projects.scan.added.one": "{count} projeto adicionado. Execute Sync para gravá-lo.",
"projects.scan.added.other": "{count} projetos adicionados. Execute Sync para gravá-los.",
"projects.saved": "{name} salvo.",
"projects.remove": "Remover projeto",
"projects.removeTitle": "Remover {name}?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "这台机器",
"projects.add.storageLocalHint": "不写入 config.yaml,你其他的机器不会有这个项目。",
"projects.added": "已添加 {name}。运行 Sync 后写入。",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "同时添加这个文件夹里的每个 checkout",
"projects.scan.toggleHint": "每个都会成为独立的项目,使用相同的设置。已经是项目的文件夹保持不变。",
"projects.scan.lookIn": "查找位置",
"projects.scan.addFolder": "输入文件夹,例如 .worktrees,然后按 Enter",
"projects.scan.foldersHint": "项目文件夹里的文件夹。隐藏文件夹、node_modules 和链接会跳过,所以像 .worktrees 这样的文件夹要在这里添加。",
"projects.scan.inside": "每个文件夹都必须位于项目文件夹内。",
"projects.scan.review": "检查",
"projects.scan.reviewTitle": "检查要添加的项目",
"projects.scan.same": "每个新项目都使用相同的设置:{targets} · {parts}。",
"projects.scan.toAdd.one": "{count} 个要添加",
"projects.scan.toAdd.other": "{count} 个要添加",
"projects.scan.already.one": "{count} 个已经是项目",
"projects.scan.already.other": "{count} 个已经是项目",
"projects.scan.skipped.one": "{count} 个跳过",
"projects.scan.skipped.other": "{count} 个跳过",
"projects.scan.picked": "你选择的文件夹。",
"projects.scan.kept": "已经是项目,设置相同。",
"projects.scan.renamed": "{base} 这个名称已被使用,所以改用路径命名。",
"projects.scan.skip.different": "已经是项目,但设置不同。",
"projects.scan.skip.storage": "已经是项目,但保存在另一个位置。",
"projects.scan.skip.removed": "已在这台机器上移除。单独添加它即可恢复。",
"projects.scan.skip.ownConfig": "有自己的 .skillshare/ 项目配置。",
"projects.scan.skip.nameTaken": "名称 {name} 已被使用。单独添加它来指定名称。",
"projects.scan.skip.badName": "{name} 不能作为项目名称。单独添加它来指定名称。",
"projects.scan.open": "打开 {name}",
"projects.scan.missing": "{folder} 不存在,那里没有找到任何内容。",
"projects.scan.unreadable": "无法读取 {folder}({detail}),所以没有检查里面的 checkout。",
"projects.scan.nothing": "没有新的项目可以添加。",
"projects.scan.submit.one": "添加 {count} 个项目",
"projects.scan.submit.other": "添加 {count} 个项目",
"projects.scan.added.one": "已添加 {count} 个项目。运行 Sync 后写入。",
"projects.scan.added.other": "已添加 {count} 个项目。运行 Sync 后写入。",
"projects.saved": "已保存 {name}。",
"projects.remove": "移除项目",
"projects.removeTitle": "要移除 {name} 吗?",
+33
View File
@@ -2778,6 +2778,39 @@
"projects.add.storageLocalShort": "這台機器",
"projects.add.storageLocalHint": "不寫入 config.yaml,你其他的機器不會有這個專案。",
"projects.added": "已新增 {name}。執行 Sync 後寫入。",
"projects.scan.title": "Git checkouts",
"projects.scan.toggle": "一併加入這個資料夾裡的每個 checkout",
"projects.scan.toggleHint": "每個都會成為獨立的專案,使用相同的設定。已經是專案的資料夾維持原樣。",
"projects.scan.lookIn": "搜尋位置",
"projects.scan.addFolder": "輸入資料夾,例如 .worktrees,然後按 Enter",
"projects.scan.foldersHint": "專案資料夾裡的資料夾。隱藏資料夾、node_modules 和連結會略過,所以像 .worktrees 這種資料夾要在這裡加入。",
"projects.scan.inside": "每個資料夾都必須在專案資料夾裡。",
"projects.scan.review": "檢查",
"projects.scan.reviewTitle": "檢查要新增的專案",
"projects.scan.same": "每個新專案都使用相同的設定:{targets} · {parts}。",
"projects.scan.toAdd.one": "{count} 個要新增",
"projects.scan.toAdd.other": "{count} 個要新增",
"projects.scan.already.one": "{count} 個已經是專案",
"projects.scan.already.other": "{count} 個已經是專案",
"projects.scan.skipped.one": "{count} 個略過",
"projects.scan.skipped.other": "{count} 個略過",
"projects.scan.picked": "你選的資料夾。",
"projects.scan.kept": "已經是專案,設定相同。",
"projects.scan.renamed": "{base} 這個名稱已被使用,所以改用路徑命名。",
"projects.scan.skip.different": "已經是專案,但設定不同。",
"projects.scan.skip.storage": "已經是專案,但儲存在另一個位置。",
"projects.scan.skip.removed": "已在這台機器上移除。單獨新增它即可恢復。",
"projects.scan.skip.ownConfig": "有自己的 .skillshare/ 專案設定。",
"projects.scan.skip.nameTaken": "名稱 {name} 已被使用。單獨新增它來指定名稱。",
"projects.scan.skip.badName": "{name} 不能當作專案名稱。單獨新增它來指定名稱。",
"projects.scan.open": "開啟 {name}",
"projects.scan.missing": "{folder} 不存在,那裡沒有找到任何東西。",
"projects.scan.unreadable": "無法讀取 {folder}({detail}),所以沒有檢查裡面的 checkout。",
"projects.scan.nothing": "沒有新的專案可以新增。",
"projects.scan.submit.one": "新增 {count} 個專案",
"projects.scan.submit.other": "新增 {count} 個專案",
"projects.scan.added.one": "已新增 {count} 個專案。執行 Sync 後寫入。",
"projects.scan.added.other": "已新增 {count} 個專案。執行 Sync 後寫入。",
"projects.saved": "已儲存 {name}。",
"projects.remove": "移除專案",
"projects.removeTitle": "要移除 {name} 嗎?",
+1 -1
View File
@@ -102,7 +102,7 @@ const stale: Record<QueryEvent, Label[] | { args: string[]; stale: Label[] }> =
syncRan: [...TARGETS, 'extrasDiff', ...X, ...M, ...H, 'log'],
projectSynced: [...TARGETS, ...M, ...H, 'log'],
projectChanged: [...TARGETS, ...M, ...H],
projectAdded: [...TARGETS, ...M],
projectAdded: [...TARGETS, ...M, ...H],
targetFilesChanged: { args: ['claude'], stale: ['targetFiles', 'targetFile'] },
targetFileRemoved: { args: ['claude'], stale: ['targetFiles'] },
+1 -1
View File
@@ -43,7 +43,7 @@ const events = {
syncRan: () => keys(...targets, k.extrasDiff(), k.extras, k.mcp, k.hooks, k.logAll),
projectSynced: () => keys(...targets, k.mcp, k.hooks, k.logAll),
projectChanged: () => keys(...targets, k.mcp, k.hooks),
projectAdded: () => keys(...targets, k.mcp),
projectAdded: () => keys(...targets, k.mcp, k.hooks),
targetFilesChanged: (target: string) => keys(k.targetFiles.list(target)),
// Only the list: the removed file's content query is still mounted and would fetch again.
targetFileRemoved: (target: string): InvalidateQueryFilters[] => [
+10 -1
View File
@@ -254,7 +254,11 @@ export default function ProjectsPage() {
defaultStorage={list.data.storage}
storagePaths={list.data.storagePaths}
existing={rows.filter((p) => p.declared).map((p) => p.path)}
onClose={() => setAdding(false)}
onClose={() => {
setAdding(false);
// A failure after the write (MCP or hooks) leaves the dialog open on saved projects.
void invalidate(queryClient, 'projectAdded');
}}
onAdded={(root) => {
setAdding(false);
void invalidate(queryClient, 'projectAdded');
@@ -265,6 +269,11 @@ export default function ProjectsPage() {
if (added) void navigate(projectUrl(added.path));
});
}}
onScanned={(count) => {
setAdding(false);
void invalidate(queryClient, 'projectAdded');
toast(t(plural('projects.scan.added', count), { count }), 'success');
}}
/>
)}
<ConfirmDialog
+27 -1
View File
@@ -15,6 +15,7 @@ skillshare project # Same as project list
skillshare project list --json
skillshare project show <project> --json
skillshare project add <root> --target T [options]
skillshare project add <root> --scan DIR --target T [options]
skillshare project edit <project> [options]
skillshare project sync <project> [--dry-run] [--json]
skillshare project localize <project> [--dry-run] [--json]
@@ -36,6 +37,7 @@ skillshare project remove <project> [--shared] [--yes] [--dry-run] [--json]
| `--skills-naming NAMING` | add, edit | `flat`, `standard`, or `prefixed`; empty value inherits |
| `--skills-include P`, `--skills-exclude P` | add, edit | Repeat for multiple glob patterns; replaces the corresponding list; empty value clears it |
| `--agents-include P`, `--agents-exclude P` | add, edit | Same replacement semantics for agents; filters require merge or copy mode |
| `--scan DIR` | add | Also add each Git checkout below this folder of the root, with the same settings; repeat for more folders. See [checkouts in a workspace](#scan) |
| `--machine-local` | add | Save on this machine only, not in `config.yaml` |
| `--shared` | add, remove | add: save in `config.yaml` even when [`projects_storage`](#local-registrations) is `machine-local`. remove: also remove `config.yaml`'s copy of a project this machine overrides |
| `--sync` | add, edit | Save, then sync this project's skills and agents; force is off |
@@ -63,6 +65,28 @@ The project is saved under [`projects`](/docs/reference/targets/configuration#pr
Projects with skills disabled never run the skills pass, including in global symlink mode. An empty requested/enabled resource selection succeeds without discovery, backups or target writes.
### Register every checkout in a workspace {#scan}
Some tools, such as Codex, look for project skills only up to the Git root of the folder you open. When one workspace folder holds several checkouts, skills synced to the workspace are not seen inside them. `--scan` registers each checkout as its own project, with the same settings:
```bash
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --dry-run
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --sync
```
`--scan` takes a folder inside the root (`.` is the root itself) and searches it for checkouts: folders with a `.git` folder, or with the `.git` file of a linked worktree. A checkout is not searched further. Hidden folders below a scan folder, `node_modules`, and links are skipped, so name hidden folders such as `.worktrees` explicitly. A scan folder that does not exist yet, or a folder that cannot be read, is skipped with a warning.
Each checkout becomes an ordinary project entry. No scan setting is saved, and `project edit`, `project remove`, and `--machine-local` work as usual. The scan runs only when you run the command, so run it again after a new clone or worktree. It only adds projects:
- A folder already registered with the same settings is kept.
- A folder registered with different settings, the root included, is skipped and left as it is; change it with `project edit`.
- A checkout with its own `.skillshare/` project config is skipped.
- New checkouts are registered in the same run, in one write, so the command is safe to rerun from a script.
A checkout is named after its folder. When another project, or another checkout found in the same run, has that name, the checkout is named from its path under the root instead: `.worktrees/app-a` becomes `worktrees-app-a`, saved as `name` so later scans keep it. A checkout directly under the root keeps its folder name. If the derived name is taken too, that checkout is skipped with the reason; add it on its own with `--name`. `--sync` syncs the root and every added or kept checkout.
### Replace filters or reset overrides {#edit-settings}
```bash
@@ -72,7 +96,7 @@ skillshare project sync shop-web --dry-run --json
skillshare project sync shop-web --json
```
Add and edit validate the full effective configuration before writing. An edit is saved where the project is: in `config.yaml`, or on this machine for a machine-local project. In `config.yaml`, editing a project declared through a YAML anchor also changes the aliases of that anchor. Mutation results list every affected root. A no-op add or edit returns `applied: false` and `unchanged: true`, and still honors `--sync`. Repeating add with different settings fails and points at `project edit`. Custom names must not look like roots (for example `~name`, `./name`, or `C:name`).
Add and edit validate the full effective configuration before writing. An edit is saved where the project is: in `config.yaml`, or on this machine for a machine-local project. In `config.yaml`, editing a project declared through a YAML anchor also changes the aliases of that anchor. Mutation results list every affected root. A no-op add or edit returns `applied: false` and `unchanged: true`, and still honors `--sync`. Repeating add with different settings fails and points at `project edit`; with `--scan` that folder is skipped instead. Custom names must not look like roots (for example `~name`, `./name`, or `C:name`).
### Remove a project {#remove}
@@ -98,6 +122,8 @@ CLI edits detach dropped skill paths by the same rules. While a project's skills
| add, edit, remove, localize, share | `action`, `project`, `applied`, `affected`, `warnings`; optional `sync`, `detach`, or `remaining` (remove) |
| sync | `action`, `project`, `sync`; previews also have `applied: false` |
With `--scan`, `project` is the root and add also returns a `scan` array with one entry per folder: `root`, `path` (relative to the root; `.` for the root itself), `name`, `result` (`added`, `kept`, or `skipped`), and for a skipped folder `skip` (`different`, `storage`, `removed`, `own-config`, `name-taken`, or `bad-name`) and `reason`. With `--sync`, each entry also has that project's `sync` and any `error`.
Project objects include `root` (stored spelling), `path` (expanded path), `name`, `targets`, `skills`, `agents`, `groups`, `missing`, and `hasOwnConfig`, `origin` (`shared` or `local`), `originPath` (the owning file), and `sharedCopy` (a local project that `config.yaml` also declares). An omitted or disabled resource is `null`. Enabled resources expose their settings. Text `project list` and `project show` report the on/off state and origin. The sync result includes `results`, `failed`, `warnings`, and discovery/filter diagnostics.
A failed target makes sync exit 1 while reporting completed targets. Sync previews report conflicts in `failed` and exit 0; invalid input still fails. If add/edit saves successfully but its sync fails, the registration stays saved; fix the target and retry with `project sync`. A missing project folder can still be edited, but cannot be synced.
+1 -1
View File
@@ -98,7 +98,7 @@ Some pages show a count in the sidebar when they need attention. The counts refr
| **MCP** | One row per server; the count button on the row shows the logos of the Agents it syncs to and opens their toggles. **Add server** takes a URL, a command, a pasted snippet or a file; **Import from a target** reads what an installed Agent already has. Each server's menu has **View what each Agent gets**, which lists the source and every Agent's file and shows the one you pick, including unsaved edits. Conflicts offer **Import from** the Agent or **Replace with source**. The server dialog's **Tools** section sets the [tool policy](./mcp.md#tool-policy): **Load tools**, which starts the server once with the dialog's settings, saved or not, and lists its tools to tick; an **Exclude rules** row for `*` patterns; it lists each selected Agent that does not apply part of the policy, and the row shows a tag when a policy is set. For a Pi server, the dialog also has [Pi's built-in MCP](./mcp.md#pi) settings: tool exposure and other Pi settings, which take [`piOptions`](./mcp.md#pi-options) as JSON, with their help in info tooltips. **Defaults** edits `mcp.targets`. **Sync MCP**, in the Sync box, lists the pending changes and writes only the MCP config files, keeping a backup of each; below it, [**Check**](./mcp.md#check-servers-before-an-agent-starts-them) checks the servers and **Backups and restore** previews and restores those backups. |
| **Plugins** | One row per plugin, with its Agents as toggles. Expanding a row also lists the other Agents the source supports; ticking one previews an install. The row menu syncs, updates, removes, or opens **View files**, a read-only browser of the local copy Skillshare reviewed. **Share** copies one command that adds the ticked plugins from their HTTPS sources and has Pi install the ticked npm Pi packages. See [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) |
| **Targets** | Target list with status. **Add target** also takes **Another account**: a second config folder of an Agent you already use, with a preview of where it writes. Each target's page edits include/exclude filters and collects local-only skills back to source. A search box above the filter preview narrows its rows by name and marks the matching text; it changes only what is shown, not the filters. Project pages and the Extras **Edit target** dialog share this preview and its search. The **Syncing** column shows what each target gets, as links: **Skills**, **Agents**, **MCP** and **Hooks** with their counts, **Extensions** for Pi, and the target's instruction file when a shared `AGENTS.md` is connected to it; each opens that tab of the target's page. A target that has an MCP config file gets an **MCP** tab with one row per server; a click saves at once, and **Sync all targets** writes the MCP files of every target. Each target also has a tab named after its instruction file (**CLAUDE.md**, **GEMINI.md**, **AGENTS.md**, ...) that shows the read order, edits the file and converts it to `AGENTS.md` |
| **Projects** | Global mode only. Project folders that the global config syncs into, from [`projects`](/docs/reference/targets/configuration#projects) in `config.yaml`, projects kept on this machine only (marked **This machine**), and [`mcp.projects`](./mcp.md#projects-in-the-dashboard). The same projects can be managed from the terminal with [`skillshare project`](./project.md). **Add project** takes a folder, its targets and what to sync, and saves it in `config.yaml` unless you pick **This machine only** under **Saved to** at the bottom of the dialog (the default when [`projects_storage`](/docs/reference/targets/configuration#projects-storage) is `machine-local`). Edits are saved where the project is. To move a saved project, use `skillshare project localize` or `share`. Removing a project that this machine overrides asks whether to remove only this machine's copy or `config.yaml`'s as well. A removed project's `mcp.projects` and `hooks.projects` entries stay, so the folder stays listed; removing it again deletes them. Each project has **Skills** and **Agents** tabs with filters, a preview and the folders that get written, and an **MCP** tab that turns global servers off in that folder or gives it servers of its own, with **Check** for those servers. **Sync project** previews, then syncs only that project's skills, agents and MCP. Targets that already point into a project folder can be converted |
| **Projects** | Global mode only. Project folders that the global config syncs into, from [`projects`](/docs/reference/targets/configuration#projects) in `config.yaml`, projects kept on this machine only (marked **This machine**), and [`mcp.projects`](./mcp.md#projects-in-the-dashboard). The same projects can be managed from the terminal with [`skillshare project`](./project.md). **Add project** takes a folder, its targets and what to sync, and saves it in `config.yaml` unless you pick **This machine only** under **Saved to** at the bottom of the dialog (the default when [`projects_storage`](/docs/reference/targets/configuration#projects-storage) is `machine-local`). **Also add each checkout inside this folder** does what [`project add --scan`](./project.md#scan) does: list folders such as `.worktrees` under **Look in**, then **Review** shows each folder as Added, Kept or Skipped, with the reason, before anything is saved. MCP and Hooks, when picked, are set up for each added project. Edits are saved where the project is. To move a saved project, use `skillshare project localize` or `share`. Removing a project that this machine overrides asks whether to remove only this machine's copy or `config.yaml`'s as well. A removed project's `mcp.projects` and `hooks.projects` entries stay, so the folder stays listed; removing it again deletes them. Each project has **Skills** and **Agents** tabs with filters, a preview and the folders that get written, and an **MCP** tab that turns global servers off in that folder or gives it servers of its own, with **Check** for those servers. **Sync project** previews, then syncs only that project's skills, agents and MCP. Targets that already point into a project folder can be converted |
| **Audit** | Security scan of skills and agents, with findings by severity. When a [followed source link](/docs/reference/targets/configuration#follow_source_links) could not be read, the counts are marked **Scan incomplete** beside the Skills and Agents tabs, so a partial scan is not mistaken for a full one; the scan then warns instead of reporting all clear, and the Dashboard lists it under **Needs attention**. The **Rules** tab browses every rule by category: switch one off, change its severity, apply a severity to a whole category, pick the scan profile (`default`, `strict`, `permissive`), or open the editor for custom `audit-rules.yaml` |
| **Settings** | Tabbed: **General** (source paths, sync mode, appearance), **Backup** (target folder snapshots, earlier versions of files such as `AGENTS.md`, and MCP config backups; see [`backup`](./backup.md#dashboard)), **Log** (operation history), **Health** (the same checks as [`doctor`](/docs/reference/commands/doctor)), **Extensions** (sync-time file transforms), **Files** (direct editors for `config.yaml`, `.skillignore`, and `.agentignore`; when a `.skillignore.local` or `.agentignore.local` exists, the editor shows its rules above the file, since they apply after it and can override it) |
@@ -15,6 +15,7 @@ skillshare project # Same as project list
skillshare project list --json
skillshare project show <project> --json
skillshare project add <root> --target T [options]
skillshare project add <root> --scan DIR --target T [options]
skillshare project edit <project> [options]
skillshare project sync <project> [--dry-run] [--json]
skillshare project localize <project> [--dry-run] [--json]
@@ -36,6 +37,7 @@ skillshare project remove <project> [--shared] [--yes] [--dry-run] [--json]
| `--skills-naming NAMING` | add, edit | `flat`、`standard`、`prefixed` のいずれか。空の値で継承に戻します |
| `--skills-include P`, `--skills-exclude P` | add, edit | 繰り返して複数の glob パターンを指定します。対応するリストを置き換え、空の値で解除します |
| `--agents-include P`, `--agents-exclude P` | add, edit | Agent 用で、置き換えの扱いは同じです。フィルタには merge または copy モードが必要です |
| `--scan DIR` | add | ルート内のこのフォルダー以下にある各 Git checkout も同じ設定で追加します。複数のフォルダーは繰り返し指定します。[ワークスペース内の checkout](#scan) を参照してください |
| `--machine-local` | add | `config.yaml` ではなく、このマシンだけに保存します |
| `--shared` | add, remove | add: [`projects_storage`](#local-registrations) が `machine-local` でも `config.yaml` に保存します。remove: このマシンが上書きしている project の `config.yaml` 側のコピーも削除します |
| `--sync` | add, edit | 保存してから、この project の Skill と Agent を sync します。force はオフです |
@@ -63,6 +65,28 @@ project は `config.yaml` の [`projects`](/docs/reference/targets/configuration
Skill を無効化した project では、global の symlink モードを含め、Skill の sync 処理は一切実行されません。要求された、または有効なリソースの選択が空の場合は、検出、バックアップ、Target への書き込みを行わずに成功します。
### ワークスペース内のすべての checkout を登録する {#scan}
Codex などの一部のツールは、開いたフォルダーの Git ルートまでしか project skills を探しません。1 つのワークスペースフォルダーに複数の checkout があると、ワークスペースに sync した skills はそれらの checkout の中から見えません。`--scan` は各 checkout を同じ設定で個別の project として登録します:
```bash
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --dry-run
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --sync
```
`--scan` にはルート内のフォルダーを指定します(`.` はルート自身)。そのフォルダーから checkout、つまり `.git` フォルダー、またはリンクされた worktree の `.git` ファイルを持つフォルダーを探します。checkout の中はそれ以上探しません。スキャンフォルダー以下の隠しフォルダー、`node_modules`、リンクはスキップするため、`.worktrees` のような隠しフォルダーは明示的に指定してください。まだ存在しないスキャンフォルダーや読み取れないフォルダーは、警告を出してスキップします。
各 checkout は通常の project エントリーになります。スキャンの設定は保存されず、`project edit`、`project remove`、`--machine-local` はいつもどおり使えます。スキャンはコマンドを実行したときだけ行われるため、新しい clone や worktree を作ったら再実行してください。追加だけを行います:
- 同じ設定で登録済みのフォルダーはそのまま残ります。
- 異なる設定で登録済みのフォルダー(ルートを含む)はスキップされ、変更されません。変更するには `project edit` を使います。
- 独自の `.skillshare/` project 設定を持つ checkout はスキップされます。
- 新しい checkout は同じ実行の中で 1 回の書き込みで登録されるため、スクリプトから安全に再実行できます。
checkout にはフォルダー名が付きます。ほかの project、または同じ実行で見つかった別の checkout がその名前を使っている場合は、ルートからのパスで名前を付けます: `.worktrees/app-a` は `worktrees-app-a` になり、`name` として保存されるので、以降のスキャンでも変わりません。ルート直下の checkout はフォルダー名を使います。導き出した名前も使われている場合、その checkout は理由とともにスキップされます。`--name` を付けて個別に追加してください。`--sync` はルートと、追加または維持されたすべての checkout を sync します。
### フィルタの置き換えと上書き設定のリセット {#edit-settings}
```bash
@@ -72,7 +96,7 @@ skillshare project sync shop-web --dry-run --json
skillshare project sync shop-web --json
```
add と edit は、書き込む前に有効な設定全体を検証します。編集は project が保存されている場所(`config.yaml`、またはこのマシンだけの project ならこのマシン)に保存されます。`config.yaml` では、YAML アンカーで宣言された project を編集すると、そのアンカーのエイリアスも変更されます。変更の結果には影響を受けたルートが列挙されます。何も変わらない add や edit は `applied: false` と `unchanged: true` を返し、それでも `--sync` は実行されます。異なる設定で add を繰り返すと失敗し、`project edit` を案内します。カスタム名はルートに見える形(例: `~name`、`./name`、`C:name`)にはできません。
add と edit は、書き込む前に有効な設定全体を検証します。編集は project が保存されている場所(`config.yaml`、またはこのマシンだけの project ならこのマシン)に保存されます。`config.yaml` では、YAML アンカーで宣言された project を編集すると、そのアンカーのエイリアスも変更されます。変更の結果には影響を受けたルートが列挙されます。何も変わらない add や edit は `applied: false` と `unchanged: true` を返し、それでも `--sync` は実行されます。異なる設定で add を繰り返すと失敗し、`project edit` を案内します。`--scan` を付けた場合は、そのフォルダーをスキップします。カスタム名はルートに見える形(例: `~name`、`./name`、`C:name`)にはできません。
### project の削除 {#remove}
@@ -98,6 +122,8 @@ CLI の edit は、外された Skill のパスも同じルールで切り離し
| add, edit, remove, localize, share | `action`、`project`、`applied`、`affected`、`warnings`。必要に応じて `sync`、`detach`、または `remaining`(remove) |
| sync | `action`、`project`、`sync`。プレビューでは `applied: false` も含みます |
`--scan` を付けると、`project` はルートになり、add はフォルダーごとに 1 件の `scan` 配列も返します: `root`、`path`(ルートからの相対パス。ルート自体は `.`)、`name`、`result`(`added`、`kept`、`skipped`)、スキップしたフォルダーでは `skip`(`different`、`storage`、`removed`、`own-config`、`name-taken`、`bad-name`)と `reason`。`--sync` を付けると、各要素にその project の `sync` と、あれば `error` も含まれます。
project オブジェクトには `root`(保存された表記)、`path`(展開済みのパス)、`name`、`targets`、`skills`、`agents`、`groups`、`missing`、`hasOwnConfig`、`origin`(`shared` または `local`)、`originPath`(所有ファイル)、`sharedCopy`(`config.yaml` にも宣言されているローカルの project)が含まれます。省略または無効化されたリソースは `null` です。有効なリソースはその設定を公開します。テキスト形式の `project list` と `project show` はオン/オフの状態を表示します。sync の結果には `results`、`failed`、`warnings`、および検出・フィルタの診断情報が含まれます。
Target が失敗すると、sync は完了した Target を報告しつつ終了コード 1 で終了します。sync のプレビューは競合を `failed` に報告して終了コード 0 で終了しますが、不正な入力は引き続き失敗します。add/edit の保存に成功して sync が失敗した場合、登録は保存されたままです。Target を修正してから `project sync` で再試行してください。見つからない project フォルダーも edit はできますが、sync はできません。
@@ -98,7 +98,7 @@ skillshare ui start --clear-cache
| **MCP** | サーバーごとに 1 行表示され、行のカウントボタンに sync 先の Agent のロゴが並び、そのボタンでそれらのトグルを開く。**サーバーを追加** は URL、コマンド、貼り付けたスニペット、またはファイルを受け付ける。**target からインポート** はインストール済みの Agent が既に持っているものを読み込む。各サーバーのメニューには **各 Agent に書き込まれる設定を表示** があり、source とすべての Agent のファイルを一覧表示し、選んだものを未保存の編集を含めて表示する。コンフリクトでは **その Agent からインポート** か **ソースで上書き** を選べる。サーバーのダイアログの **ツール** セクションでは [ツールポリシー](./mcp.md#tool-policy) を設定する。保存済みかどうかに関係なくダイアログの現在の設定でサーバーを一度起動し、ツールをチェックできる一覧にする **ツールを読み込む**、`*` パターン用の **除外ルール** の行がある。ポリシーの一部を適用しない選択中の Agent がそれぞれ表示され、ポリシーを設定すると行にタグが付く。Pi サーバーでは、ダイアログに [Pi の内蔵 MCP](./mcp.md#pi) の設定もあり、ツールの公開方法とその他の Pi 設定を扱い、後者は [`piOptions`](./mcp.md#pi-options) を JSON で受け付ける。説明は情報アイコンのツールチップに表示される。**デフォルト** は `mcp.targets` を編集する。Sync ボックスの **Sync MCP** は保留中の変更を一覧表示し、MCP の設定ファイルだけを書き込み、それぞれのバックアップを保存する。その下では [**チェック**](./mcp.md#check-servers-before-an-agent-starts-them) がサーバーをチェックし、**バックアップと復元** でそれらのバックアップをプレビューして復元できる。 |
| **Plugins** | Plugin ごとに 1 行表示され、その Agent がトグルとして並ぶ。行を展開すると、そのソースが対応する他の Agent も一覧され、いずれかにチェックを入れるとインストールのプレビューが表示される。行のメニューから sync、update、削除ができ、Skillshare がレビューしたローカルコピーを読み取り専用で閲覧する **View files** も開ける。**Share** は、チェックした plugin を HTTPS ソースから追加し、チェックした npm の Pi パッケージを Pi にインストールさせるコマンドを 1 つコピーする。[Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) を参照 |
| **Targets** | ステータス付きの Target 一覧。**ターゲットを追加** では **別のアカウント** も選べます。すでに使っている Agent の 2 つ目の config フォルダで、書き込み先のプレビューが付きます。各 Target のページで include/exclude フィルタを編集し、ローカルのみの Skill を Source に collect し戻せる。フィルタのプレビュー上部の検索ボックスで行を名前で絞り込み、一致した部分を強調表示できる。変わるのは表示だけで、フィルタ自体は変わらない。Project のページと Extras の **Edit target** ダイアログも同じプレビューと検索を使う。**Syncing** 列には各 Target が受け取るものがリンクとして並ぶ。**Skills**、**Agents**、**MCP**、**Hooks** とその数、Pi の **Extensions**、そして共有 `AGENTS.md` が接続済みの Target の指示ファイルで、クリックすると Target ページの該当タブが開く。MCP 設定ファイルを持つ Target には **MCP** タブがあり、サーバーごとに 1 行で選ぶ。クリックするとすぐ保存され、**Sync all targets** ですべての Target の MCP ファイルに書き込まれる。各 Target には、そのファイル名のタブ(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md** など)もあり、読み込み順を表示し、ファイルを編集し、`AGENTS.md` に変換できる |
| **Projects** | global mode のみ。global config が sync する project フォルダーで、`config.yaml` の [`projects`](/docs/reference/targets/configuration#projects)、このマシンだけに保存された project(**このマシン** と表示)、[`mcp.projects`](./mcp.md#projects-in-the-dashboard) から一覧される。同じ project はターミナルから [`skillshare project`](./project.md) でも管理できる。**プロジェクトを追加** はフォルダー、その target、sync する内容を指定し、ダイアログ下部の **保存先** で **このマシンのみ** を選ばない限り `config.yaml` に保存する([`projects_storage`](/docs/reference/targets/configuration#projects-storage) が `machine-local` のときはこちらが既定)。編集は project が保存されている場所に保存される。保存済みの project を移すには `skillshare project localize` または `share` を使う。このマシンが上書きしている project を削除すると、このマシンのコピーだけを削除するか、`config.yaml` 側も削除するかを確認する。削除した project の `mcp.projects` と `hooks.projects` のエントリーは残るため、フォルダーは一覧に残る。もう一度削除するとそれらも消える。各 project には **Skills** と **Agents** タブがあり、フィルター、プレビュー、書き込まれるフォルダーを表示する。**MCP** タブでは、そのフォルダー内で global サーバーをオフにしたり、その project 独自のサーバーを追加したりでき、それらのサーバー用の **チェック** もある。**Sync project** はプレビューしてから、その project の skills、agents、MCP だけを sync する。すでに project フォルダーを指している Target は変換できる |
| **Projects** | global mode のみ。global config が sync する project フォルダーで、`config.yaml` の [`projects`](/docs/reference/targets/configuration#projects)、このマシンだけに保存された project(**このマシン** と表示)、[`mcp.projects`](./mcp.md#projects-in-the-dashboard) から一覧される。同じ project はターミナルから [`skillshare project`](./project.md) でも管理できる。**プロジェクトを追加** はフォルダー、その target、sync する内容を指定し、ダイアログ下部の **保存先** で **このマシンのみ** を選ばない限り `config.yaml` に保存する([`projects_storage`](/docs/reference/targets/configuration#projects-storage) が `machine-local` のときはこちらが既定)。**このフォルダー内の各 checkout も追加** は [`project add --scan`](./project.md#scan) と同じ動作です。**検索する場所** に `.worktrees` などのフォルダーを並べ、**確認** で各フォルダーが Added、Kept、Skipped のどれかと理由を保存前に表示します。MCP と Hooks を選んだ場合は、追加された各 project に設定します。編集は project が保存されている場所に保存される。保存済みの project を移すには `skillshare project localize` または `share` を使う。このマシンが上書きしている project を削除すると、このマシンのコピーだけを削除するか、`config.yaml` 側も削除するかを確認する。削除した project の `mcp.projects` と `hooks.projects` のエントリーは残るため、フォルダーは一覧に残る。もう一度削除するとそれらも消える。各 project には **Skills** と **Agents** タブがあり、フィルター、プレビュー、書き込まれるフォルダーを表示する。**MCP** タブでは、そのフォルダー内で global サーバーをオフにしたり、その project 独自のサーバーを追加したりでき、それらのサーバー用の **チェック** もある。**Sync project** はプレビューしてから、その project の skills、agents、MCP だけを sync する。すでに project フォルダーを指している Target は変換できる |
| **Audit** | Skill と Agent のセキュリティスキャン。重大度別の検出結果を表示。[たどる source link](/docs/reference/targets/configuration#follow_source_links) を読み取れなかった場合は、Skills / Agents タブの横に **スキャン未完了** と表示され、部分的なスキャンが完全なスキャンと誤認されないようになる。このときスキャン後は問題なしではなく警告を表示し、ダッシュボードの **Needs attention** にも表示される。**Rules** タブでは、カテゴリごとにすべてのルールを閲覧できる: ルールをオフにする、重大度を変更する、カテゴリ全体に重大度を適用する、スキャンプロファイル(`default`、`strict`、`permissive`)を選ぶ、カスタム `audit-rules.yaml` のエディタを開く、のいずれかができる |
| **Settings** | タブ分け: **General**(Source パス、sync モード、外観)、**Backup**(Target フォルダのスナップショット、`AGENTS.md` などのファイルの以前のバージョン、MCP 設定のバックアップ。[`backup`](./backup.md#dashboard) を参照)、**Log**(操作履歴)、**Health**([`doctor`](/docs/reference/commands/doctor) と同じチェック)、**Extensions**(sync 時のファイル変換)、**Files**(`config.yaml`、`.skillignore`、`.agentignore` の直接編集。`.skillignore.local` または `.agentignore.local` がある場合は、ファイルの後に適用されて上書きできるため、エディタの上にそのルールを表示します) |
@@ -15,6 +15,7 @@ skillshare project # Same as project list
skillshare project list --json
skillshare project show <project> --json
skillshare project add <root> --target T [options]
skillshare project add <root> --scan DIR --target T [options]
skillshare project edit <project> [options]
skillshare project sync <project> [--dry-run] [--json]
skillshare project localize <project> [--dry-run] [--json]
@@ -36,6 +37,7 @@ skillshare project remove <project> [--shared] [--yes] [--dry-run] [--json]
| `--skills-naming NAMING` | add, edit | `flat`, `standard`, `prefixed` 중 하나. 빈 값은 상속으로 돌아갑니다 |
| `--skills-include P`, `--skills-exclude P` | add, edit | 여러 glob 패턴은 반복해서 지정합니다. 해당 목록을 교체하며, 빈 값은 목록을 지웁니다 |
| `--agents-include P`, `--agents-exclude P` | add, edit | agent에 대해 같은 교체 규칙을 적용합니다. 필터에는 merge 또는 copy mode가 필요합니다 |
| `--scan DIR` | add | 루트 안의 이 폴더 아래에 있는 각 Git checkout도 같은 설정으로 추가합니다. 여러 폴더는 반복해서 지정합니다. [워크스페이스의 checkout](#scan) 참고 |
| `--machine-local` | add | `config.yaml`이 아니라 이 기기에만 저장합니다 |
| `--shared` | add, remove | add: [`projects_storage`](#local-registrations)가 `machine-local`이어도 `config.yaml`에 저장합니다. remove: 이 기기가 재정의한 프로젝트의 `config.yaml` 사본도 함께 제거합니다 |
| `--sync` | add, edit | 저장한 뒤 이 프로젝트의 skill과 agent를 동기화합니다. force는 꺼져 있습니다 |
@@ -63,6 +65,28 @@ skillshare project show shop-web --json
skill이 꺼진 프로젝트는 global symlink mode를 포함해 skill 동기화 단계를 전혀 실행하지 않습니다. 요청되었거나 켜진 리소스 선택이 비어 있으면 탐색, 백업, target 쓰기 없이 성공합니다.
### 워크스페이스의 모든 checkout 등록하기 {#scan}
Codex 같은 일부 도구는 연 폴더의 Git 루트까지만 프로젝트 skills를 찾습니다. 워크스페이스 폴더 하나에 checkout이 여러 개 있으면, 워크스페이스에 sync한 skills가 그 checkout 안에서는 보이지 않습니다. `--scan`은 각 checkout을 같은 설정의 개별 프로젝트로 등록합니다:
```bash
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --dry-run
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --sync
```
`--scan`에는 루트 안의 폴더를 지정합니다(`.`은 루트 자체). 그 폴더에서 checkout, 즉 `.git` 폴더나 연결된 worktree의 `.git` 파일이 있는 폴더를 찾습니다. checkout 안은 더 찾지 않습니다. 스캔 폴더 아래의 숨김 폴더, `node_modules`, 링크는 건너뛰므로 `.worktrees` 같은 숨김 폴더는 직접 지정하세요. 아직 없는 스캔 폴더나 읽을 수 없는 폴더는 경고와 함께 건너뜁니다.
각 checkout은 일반 프로젝트 항목이 됩니다. 스캔 설정은 저장되지 않으며 `project edit`, `project remove`, `--machine-local`은 평소처럼 동작합니다. 스캔은 명령을 실행할 때만 하므로, 새 clone이나 worktree를 만든 뒤에는 다시 실행하세요. 추가만 합니다:
- 같은 설정으로 등록된 폴더는 그대로 유지됩니다.
- 다른 설정으로 등록된 폴더(루트 포함)는 건너뛰고 그대로 둡니다. 바꾸려면 `project edit`을 쓰세요.
- 자체 `.skillshare/` 프로젝트 설정이 있는 checkout은 건너뜁니다.
- 새 checkout은 같은 실행에서 한 번의 쓰기로 등록되므로, 스크립트에서 안전하게 다시 실행할 수 있습니다.
checkout의 이름은 폴더 이름입니다. 다른 프로젝트나 같은 실행에서 찾은 다른 checkout이 그 이름을 쓰고 있으면, 루트 아래 경로로 이름을 짓습니다: `.worktrees/app-a`는 `worktrees-app-a`가 되고 `name`으로 저장되므로 이후 스캔에서도 유지됩니다. 루트 바로 아래의 checkout은 폴더 이름을 유지합니다. 만든 이름도 이미 쓰이고 있으면 그 checkout은 이유와 함께 건너뜁니다. `--name`으로 따로 추가하세요. `--sync`는 루트와 추가되거나 유지된 모든 checkout을 sync합니다.
### 필터 교체 또는 override 초기화 {#edit-settings}
```bash
@@ -72,7 +96,7 @@ skillshare project sync shop-web --dry-run --json
skillshare project sync shop-web --json
```
add와 edit은 쓰기 전에 유효한 전체 설정을 검증합니다. 편집은 프로젝트가 저장된 곳, 즉 `config.yaml` 또는 이 기기에 저장됩니다. `config.yaml`에서 YAML 앵커로 선언된 프로젝트를 편집하면 그 앵커의 별칭도 함께 바뀝니다. 변경 결과에는 영향을 받은 루트가 나열됩니다. 아무것도 바뀌지 않는 add나 edit은 `applied: false`와 `unchanged: true`를 반환하며, `--sync`는 그대로 수행합니다. 다른 설정으로 add를 반복하면 실패하고 `project edit`을 안내합니다. 사용자 지정 이름은 루트처럼 보이면 안 됩니다(예: `~name`, `./name`, `C:name`).
add와 edit은 쓰기 전에 유효한 전체 설정을 검증합니다. 편집은 프로젝트가 저장된 곳, 즉 `config.yaml` 또는 이 기기에 저장됩니다. `config.yaml`에서 YAML 앵커로 선언된 프로젝트를 편집하면 그 앵커의 별칭도 함께 바뀝니다. 변경 결과에는 영향을 받은 루트가 나열됩니다. 아무것도 바뀌지 않는 add나 edit은 `applied: false`와 `unchanged: true`를 반환하며, `--sync`는 그대로 수행합니다. 다른 설정으로 add를 반복하면 실패하고 `project edit`을 안내합니다. `--scan`을 쓰면 그 폴더를 건너뜁니다. 사용자 지정 이름은 루트처럼 보이면 안 됩니다(예: `~name`, `./name`, `C:name`).
### 프로젝트 제거 {#remove}
@@ -98,6 +122,8 @@ CLI edit은 빠진 skill 경로를 같은 규칙으로 분리합니다. 프로
| add, edit, remove, localize, share | `action`, `project`, `applied`, `affected`, `warnings`; 선택적으로 `sync`, `detach`, 또는 `remaining`(remove) |
| sync | `action`, `project`, `sync`; 미리보기에는 `applied: false`도 포함 |
`--scan`을 쓰면 `project`는 루트이고, add는 폴더마다 한 항목씩 담긴 `scan` 배열도 반환합니다: `root`, `path`(루트 기준 상대 경로, 루트 자체는 `.`), `name`, `result`(`added`, `kept`, `skipped`), 그리고 건너뛴 폴더에는 `skip`(`different`, `storage`, `removed`, `own-config`, `name-taken`, `bad-name`)과 `reason`. `--sync`를 쓰면 각 항목에 그 프로젝트의 `sync`와, 있다면 `error`도 포함됩니다.
프로젝트 객체에는 `root`(저장된 표기), `path`(확장된 경로), `name`, `targets`, `skills`, `agents`, `groups`, `missing`, `hasOwnConfig`, `origin`(`shared` 또는 `local`), `originPath`(소유 파일), `sharedCopy`(`config.yaml`에도 선언된 로컬 프로젝트)가 포함됩니다. 생략되었거나 꺼진 리소스는 `null`입니다. 켜진 리소스는 해당 설정을 노출합니다. 텍스트 형식의 `project list`와 `project show`는 켜짐/꺼짐 상태를 보고합니다. sync 결과에는 `results`, `failed`, `warnings`, 그리고 탐색/필터 진단 정보가 포함됩니다.
target 하나가 실패하면 sync는 완료된 target을 보고하면서 종료 코드 1로 끝납니다. sync 미리보기는 충돌을 `failed`에 보고하고 종료 코드 0으로 끝나지만, 잘못된 입력은 여전히 실패합니다. add/edit 저장은 성공했지만 sync가 실패하면 등록은 저장된 상태로 남습니다. target을 수정한 뒤 `project sync`로 다시 시도하세요. 없는 프로젝트 폴더도 edit은 할 수 있지만 sync는 할 수 없습니다.
@@ -98,7 +98,7 @@ skillshare ui start --clear-cache
| **MCP** | 서버당 한 행이며, 행의 카운트 버튼에 동기화 대상인 Agent의 로고가 표시되고, 이 버튼을 누르면 해당 토글이 열립니다. **서버 추가**는 URL, command, 붙여넣은 snippet 또는 파일을 받습니다. **target에서 가져오기**는 설치된 Agent가 이미 가지고 있는 것을 읽어옵니다. 각 서버의 메뉴에는 **각 Agent에 기록될 설정 보기**가 있어 source와 모든 Agent의 파일을 나열하고, 선택한 파일을 저장되지 않은 편집을 포함해 보여줍니다. 충돌 시 **해당 Agent에서 가져오기** 또는 **원본으로 덮어쓰기**를 제공합니다. 서버 대화상자의 **도구** 섹션은 [도구 정책](./mcp.md#tool-policy)을 설정합니다: 저장 여부와 관계없이 대화상자의 현재 설정으로 서버를 한 번 시작해 도구를 선택할 수 있는 목록으로 보여 주는 **도구 불러오기**, `*` 패턴용 **제외 규칙** 행이 있습니다. 이 섹션은 정책 일부를 적용하지 않는 선택된 Agent를 각각 나열하며, 정책이 설정되면 행에 태그가 표시됩니다. Pi 서버의 경우, 대화상자에는 [Pi 내장 MCP](./mcp.md#pi) 설정도 있습니다: 도구 노출 방식과 기타 Pi 설정이며, 이 설정은 [`piOptions`](./mcp.md#pi-options)를 JSON으로 받고 도움말은 정보 툴팁에 있습니다. **기본값**은 `mcp.targets`를 편집합니다. Sync 박스의 **Sync MCP**는 대기 중인 변경 사항을 나열하고 MCP 설정 파일만 작성하며, 각 파일의 백업을 남깁니다. 그 아래에서 [**검사**](./mcp.md#check-servers-before-an-agent-starts-them)는 서버를 검사하고, **백업 및 복원**는 그 백업을 미리 보고 복원합니다. |
| **Plugins** | plugin당 한 행이며, 해당 Agent가 토글로 표시됩니다. 행을 펼치면 소스가 지원하는 다른 Agent도 나열되며, 하나를 선택하면 설치를 미리 봅니다. 행 메뉴는 sync, update, remove를 수행하거나, Skillshare가 검토한 로컬 사본을 읽기 전용으로 탐색하는 **View files**를 엽니다. **Share**는 선택한 plugin을 HTTPS 소스에서 추가하고 선택한 npm Pi 패키지를 Pi가 설치하게 하는 명령 하나를 복사합니다. [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) 참고 |
| **Targets** | 상태가 표시된 target 목록. **대상 추가**는 **다른 계정**도 받습니다. 이미 사용 중인 Agent의 두 번째 config 폴더이며, 어디에 기록되는지 미리보기로 보여줍니다. 각 target의 페이지에서 include/exclude 필터를 편집하고 로컬 전용 skill을 source로 다시 수집합니다. 필터 미리보기 위의 검색 상자로 행을 이름으로 좁히고 일치하는 부분을 강조합니다. 보이는 행만 바뀌고 필터는 바뀌지 않습니다. 프로젝트 페이지와 Extras의 **Edit target** 대화상자도 같은 미리보기와 검색을 씁니다. **Syncing** 열에는 각 target이 받는 것이 링크로 표시됩니다. **Skills**, **Agents**, **MCP**, **Hooks**와 그 수, Pi의 **Extensions**, 그리고 공유 `AGENTS.md`가 연결된 target의 지침 파일이며, 클릭하면 target 페이지의 해당 탭이 열립니다. MCP 설정 파일이 있는 target에는 **MCP** 탭이 있어 서버마다 한 행으로 고릅니다. 클릭하면 바로 저장되고 **Sync all targets**가 모든 target의 MCP 파일에 기록합니다. 각 target에는 지침 파일 이름을 딴 탭(**CLAUDE.md**, **GEMINI.md**, **AGENTS.md**, ...)도 있어, 읽는 순서를 보여 주고 파일을 편집하며 `AGENTS.md`로 변환합니다 |
| **프로젝트** | Global mode 전용. global 설정이 동기화하는 프로젝트 폴더이며, `config.yaml`의 [`projects`](/docs/reference/targets/configuration#projects), 이 기기에만 보관한 프로젝트(**이 기기**으로 표시), [`mcp.projects`](./mcp.md#projects-in-the-dashboard)에서 옵니다. 같은 프로젝트는 터미널에서 [`skillshare project`](./project.md)로도 관리할 수 있습니다. **프로젝트 추가**는 폴더, 그 target, 동기화할 항목을 받고, 대화 상자 아래쪽 **저장 위치**에서 **이 기기에만**을 고르지 않으면 `config.yaml`에 저장합니다([`projects_storage`](/docs/reference/targets/configuration#projects-storage)가 `machine-local`이면 이것이 기본값입니다). 편집은 프로젝트가 저장된 곳에 저장됩니다. 저장된 프로젝트를 옮기려면 `skillshare project localize` 또는 `share`를 사용하세요. 이 기기가 재정의한 프로젝트를 제거하면 이 기기의 사본만 제거할지 `config.yaml`의 항목도 함께 제거할지 묻습니다. 제거한 프로젝트의 `mcp.projects`와 `hooks.projects` 항목은 남으므로 폴더는 목록에 계속 표시됩니다. 한 번 더 제거하면 이 항목들도 삭제됩니다. 각 프로젝트에는 필터, 미리보기, 기록될 폴더를 보여주는 **Skills**와 **Agents** 탭, 그리고 해당 폴더에서 global 서버를 끄거나 프로젝트 자체 서버를 부여하며 그 서버를 위한 **검사**가 있는 **MCP** 탭이 있습니다. **Sync project**는 미리 본 뒤 해당 프로젝트의 skill, agent, MCP만 동기화합니다. 이미 프로젝트 폴더를 가리키는 Target은 변환할 수 있습니다 |
| **프로젝트** | Global mode 전용. global 설정이 동기화하는 프로젝트 폴더이며, `config.yaml`의 [`projects`](/docs/reference/targets/configuration#projects), 이 기기에만 보관한 프로젝트(**이 기기**으로 표시), [`mcp.projects`](./mcp.md#projects-in-the-dashboard)에서 옵니다. 같은 프로젝트는 터미널에서 [`skillshare project`](./project.md)로도 관리할 수 있습니다. **프로젝트 추가**는 폴더, 그 target, 동기화할 항목을 받고, 대화 상자 아래쪽 **저장 위치**에서 **이 기기에만**을 고르지 않으면 `config.yaml`에 저장합니다([`projects_storage`](/docs/reference/targets/configuration#projects-storage)가 `machine-local`이면 이것이 기본값입니다). **이 폴더 안의 각 checkout도 추가**는 [`project add --scan`](./project.md#scan)과 같습니다. **찾을 위치**에 `.worktrees` 같은 폴더를 적고 **검토**를 누르면, 저장하기 전에 각 폴더가 Added, Kept, Skipped 중 무엇인지와 이유를 보여 줍니다. MCP와 Hooks를 고르면 추가된 각 프로젝트에 설정합니다. 편집은 프로젝트가 저장된 곳에 저장됩니다. 저장된 프로젝트를 옮기려면 `skillshare project localize` 또는 `share`를 사용하세요. 이 기기가 재정의한 프로젝트를 제거하면 이 기기의 사본만 제거할지 `config.yaml`의 항목도 함께 제거할지 묻습니다. 제거한 프로젝트의 `mcp.projects`와 `hooks.projects` 항목은 남으므로 폴더는 목록에 계속 표시됩니다. 한 번 더 제거하면 이 항목들도 삭제됩니다. 각 프로젝트에는 필터, 미리보기, 기록될 폴더를 보여주는 **Skills**와 **Agents** 탭, 그리고 해당 폴더에서 global 서버를 끄거나 프로젝트 자체 서버를 부여하며 그 서버를 위한 **검사**가 있는 **MCP** 탭이 있습니다. **Sync project**는 미리 본 뒤 해당 프로젝트의 skill, agent, MCP만 동기화합니다. 이미 프로젝트 폴더를 가리키는 Target은 변환할 수 있습니다 |
| **Audit** | skill과 agent에 대한 보안 스캔이며, 심각도별로 findings를 표시합니다. [따라가는 source link](/docs/reference/targets/configuration#follow_source_links)를 읽지 못하면 Skills / Agents 탭 옆에 **스캔 미완료**가 표시되어 부분 스캔이 전체 스캔으로 오인되지 않습니다. 이때 스캔 후에는 문제 없음 대신 경고를 표시하고, 대시보드의 **Needs attention**에도 표시됩니다. **Rules** 탭에서는 카테고리별로 모든 rule을 탐색할 수 있습니다: rule을 끄거나, 심각도를 변경하거나, 카테고리 전체에 심각도를 적용하거나, 스캔 profile(`default`, `strict`, `permissive`)을 선택하거나, 사용자 지정 `audit-rules.yaml` 편집기를 엽니다 |
| **Settings** | 탭으로 구성: **General**(source 경로, sync mode, 외관), **Backup**(대상 폴더 스냅샷, `AGENTS.md` 같은 파일의 이전 버전, MCP 설정 백업. [`backup`](./backup.md#dashboard) 참고), **Log**(작업 이력), **Health**([`doctor`](/docs/reference/commands/doctor)와 동일한 검사), **Extensions**(sync 시점의 파일 변환), **Files**(`config.yaml`, `.skillignore`, `.agentignore`를 위한 직접 편집기. `.skillignore.local`이나 `.agentignore.local`이 있으면 파일 뒤에 적용되어 덮어쓸 수 있으므로 편집기 위에 그 규칙을 보여 줍니다) |
@@ -15,6 +15,7 @@ skillshare project # Same as project list
skillshare project list --json
skillshare project show <project> --json
skillshare project add <root> --target T [options]
skillshare project add <root> --scan DIR --target T [options]
skillshare project edit <project> [options]
skillshare project sync <project> [--dry-run] [--json]
skillshare project localize <project> [--dry-run] [--json]
@@ -36,6 +37,7 @@ skillshare project remove <project> [--shared] [--yes] [--dry-run] [--json]
| `--skills-naming NAMING` | add, edit | `flat`、`standard` 或 `prefixed`;空值表示继承 |
| `--skills-include P`, `--skills-exclude P` | add, edit | 重复使用以指定多个 glob 模式;替换对应的列表;空值会清空列表 |
| `--agents-include P`, `--agents-exclude P` | add, edit | Agent 使用相同的替换规则;过滤器需要 merge 或 copy 模式 |
| `--scan DIR` | add | 同时添加根路径中此文件夹下的每个 Git checkout,设置相同;可重复指定多个文件夹。参见[工作区中的 checkout](#scan) |
| `--machine-local` | add | 只保存在本机,不写入 `config.yaml` |
| `--shared` | add, remove | add:即使 [`projects_storage`](#local-registrations) 为 `machine-local`,也保存到 `config.yaml`。remove:同时移除本机所覆盖项目在 `config.yaml` 中的副本 |
| `--sync` | add, edit | 保存后同步该项目的 Skill 和 Agent;不启用 force |
@@ -63,6 +65,28 @@ skillshare project show shop-web --json
禁用了 Skill 的项目永远不会执行 Skill 同步流程,全局 symlink 模式下也是如此。请求或启用的资源选择为空时,会直接成功,不进行发现、备份或 Target 写入。
### 注册工作区中的每个 checkout {#scan}
有些工具(例如 Codex)只会向上查找到所打开文件夹的 Git 根路径为止来寻找项目 skills。当一个工作区文件夹中有多个 checkout 时,同步到工作区的 skills 在这些 checkout 中看不到。`--scan` 会把每个 checkout 注册为各自的项目,设置相同:
```bash
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --dry-run
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --sync
```
`--scan` 接受根路径内的文件夹(`.` 表示根路径本身),并在其中查找 checkout:含有 `.git` 文件夹,或含有链接 worktree 的 `.git` 文件的文件夹。找到 checkout 后不再向下搜索。扫描文件夹下的隐藏文件夹、`node_modules` 和链接都会跳过,所以 `.worktrees` 这类隐藏文件夹需要明确指定。尚不存在的扫描文件夹,或无法读取的文件夹,会跳过并产生警告。
每个 checkout 都会成为普通的项目条目。不会保存任何扫描设置,`project edit`、`project remove` 和 `--machine-local` 照常工作。只有执行命令时才会扫描,所以新增 clone 或 worktree 后请再执行一次。它只会添加项目:
- 已用相同设置注册的文件夹会保留。
- 已用不同设置注册的文件夹(包括根路径)会跳过并保持原样;请用 `project edit` 修改。
- 有自己 `.skillshare/` 项目配置的 checkout 会跳过。
- 新的 checkout 会在同一次执行中一次写入注册,因此可以放心从脚本重复执行。
checkout 以文件夹名称命名。如果其他项目或同一次找到的另一个 checkout 已使用该名称,就改用它在根路径下的路径命名:`.worktrees/app-a` 会变成 `worktrees-app-a`,并保存为 `name`,之后的扫描会沿用。直接位于根路径下的 checkout 保留文件夹名称。如果推导出的名称也已被使用,该 checkout 会跳过并说明原因;请用 `--name` 单独添加。`--sync` 会同步根路径以及每个添加或保留的 checkout。
### 替换过滤器或重置覆盖设置 {#edit-settings}
```bash
@@ -72,7 +96,7 @@ skillshare project sync shop-web --dry-run --json
skillshare project sync shop-web --json
```
add 和 edit 会在写入前校验完整的有效配置。编辑会保存在项目所在的位置:`config.yaml`,或仅本机项目所在的本机。在 `config.yaml` 中,编辑通过 YAML 锚点声明的项目,也会改变该锚点的别名。变更结果会列出受影响的根路径。没有任何变化的 add 或 edit 会返回 `applied: false` 和 `unchanged: true`,但仍会执行 `--sync`。用不同的设置重复执行 add 会失败,并提示改用 `project edit`。自定义名称不能看起来像根路径(例如 `~name`、`./name` 或 `C:name`)。
add 和 edit 会在写入前校验完整的有效配置。编辑会保存在项目所在的位置:`config.yaml`,或仅本机项目所在的本机。在 `config.yaml` 中,编辑通过 YAML 锚点声明的项目,也会改变该锚点的别名。变更结果会列出受影响的根路径。没有任何变化的 add 或 edit 会返回 `applied: false` 和 `unchanged: true`,但仍会执行 `--sync`。用不同的设置重复执行 add 会失败,并提示改用 `project edit`;加上 `--scan` 时则会跳过该文件夹。自定义名称不能看起来像根路径(例如 `~name`、`./name` 或 `C:name`)。
### 移除项目 {#remove}
@@ -98,6 +122,8 @@ CLI edit 会按相同规则分离被移出的 Skill 路径。只要项目的 Ski
| add, edit, remove, localize, share | `action`、`project`、`applied`、`affected`、`warnings`;可选的 `sync`、`detach` 或 `remaining`(remove) |
| sync | `action`、`project`、`sync`;预览还包含 `applied: false` |
使用 `--scan` 时,`project` 是根路径,add 还会返回 `scan` 数组,每个文件夹一项:`root`、`path`(相对于根路径;根路径本身为 `.`)、`name`、`result`(`added`、`kept` 或 `skipped`),跳过的文件夹另有 `skip`(`different`、`storage`、`removed`、`own-config`、`name-taken` 或 `bad-name`)和 `reason`。加上 `--sync` 时,每项还包含该项目的 `sync` 和 `error`(如有)。
项目对象包含 `root`(保存时的写法)、`path`(展开后的路径)、`name`、`targets`、`skills`、`agents`、`groups`、`missing`、`hasOwnConfig`、`origin`(`shared` 或 `local`)、`originPath`(所属文件)和 `sharedCopy`(`config.yaml` 中也声明了的本机项目)。省略或禁用的资源为 `null`。启用的资源会给出其设置。文本格式的 `project list` 和 `project show` 会报告开/关状态。sync 结果包含 `results`、`failed`、`warnings`,以及发现与过滤的诊断信息。
某个 Target 失败时,sync 会在报告已完成的 Target 的同时以退出码 1 结束。sync 预览会在 `failed` 中报告冲突并以退出码 0 结束;无效输入仍然会失败。如果 add/edit 保存成功但其 sync 失败,注册会保持已保存状态;修复 Target 后用 `project sync` 重试。缺失的项目文件夹仍然可以 edit,但无法 sync。
@@ -98,7 +98,7 @@ skillshare ui start --clear-cache
| **MCP** | 每个 server 一行,行上的计数按钮显示它同步到的 Agents 的 logo,并会打开它们的开关。**添加服务器** 接受 URL、命令、粘贴的片段或文件;**从目标导入** 会读取某个已安装 Agent 现有的配置。每个 server 的菜单都有 **查看各 Agent 会写入的配置**,会列出来源和每个 Agent 的文件,并显示你选中的那一个,包括尚未保存的编辑。冲突会提供 **从该 Agent 导入** 或 **使用来源覆盖**。server 对话框的 **工具** 区块用于设置[工具策略](./mcp.md#tool-policy):**加载工具**,它会用对话框当前的设置(无论是否已保存)启动 server 一次并列出工具供勾选;用于 `*` 通配符的 **排除规则** 行;该区块会列出每个未应用部分策略的所选 Agent,设置了策略时该行会显示一个标签。对于 Pi server,对话框还提供 [Pi 内置 MCP](./mcp.md#pi) 的设置:工具暴露方式和其他 Pi 设置,后者以 JSON 形式填写 [`piOptions`](./mcp.md#pi-options),说明位于信息提示中。**默认值** 用于编辑 `mcp.targets`。Sync 框中的 **Sync MCP** 会列出待写入的更改,并只写入 MCP 配置文件,同时为每个文件保留一份备份;其下方的 [**检查**](./mcp.md#check-servers-before-an-agent-starts-them) 用于检查 server,**备份与还原** 用于预览并恢复这些备份。 |
| **Plugins** | 每个 plugin 一行,以及它的 Agents 开关。展开一行还会列出该来源支持的其他 Agents;勾选一个会预览安装效果。行菜单可以同步、更新、移除,或打开 **View files**,即 Skillshare 审阅过的本地副本的只读浏览器。**Share** 会复制一条命令,从 HTTPS 来源添加勾选的 plugin,并让 Pi 安装勾选的 npm Pi 包。 参见 [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) |
| **Targets** | 带状态的 Target 列表。**添加目标** 还提供 **另一个账号**:你已在使用的某个 Agent 的第二个配置文件夹,并会预览它的写入位置。每个 Target 的页面可编辑 include/exclude filter,并把本地专属的 skills 收集回 Source。filter 预览上方的搜索框可按名称筛选行,并标出匹配的文字;它只改变显示的行,不改变 filter。项目页面和 Extras 的 **Edit target** 对话框也使用同一个预览和搜索。**同步内容** 列以链接列出每个 target 拿到的内容:**Skills**、**Agents**、**MCP**、**Hooks** 及数量、Pi 的 **Extensions**,以及连接了共享 `AGENTS.md` 的 target 指令文件;点击即打开 target 页面的对应标签页。有 MCP 配置文件的 Target 会多一个 **MCP** 标签页,每个 server 一行;点一下就会保存,**Sync all targets** 会写入所有 Target 的 MCP 配置文件。每个 Target 还有一个以其指示文件命名的标签页(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md** 等),显示读取顺序、编辑该文件,并可将其转换为 `AGENTS.md` |
| **Projects** | 仅限 global mode。global 配置会 sync 进的项目文件夹,来自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只保存在本机的项目(标记为 **此机器**)和 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同样的项目也可以在终端中通过 [`skillshare project`](./project.md) 管理。**添加项目** 需要填写文件夹、它的 Target 和要 sync 的内容,除非在对话框底部的 **保存到** 选择 **只存在这台机器**,否则会保存到 `config.yaml`(当 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 为 `machine-local` 时默认选择只存在这台机器)。编辑会保存在项目所在的位置。要移动已保存的项目,请使用 `skillshare project localize` 或 `share`。移除一个被本机覆盖的项目时,会询问是只移除本机的副本,还是连 `config.yaml` 中的一并移除。移除项目后,它在 `mcp.projects` 和 `hooks.projects` 的设置会保留,所以文件夹仍会列出;再移除一次就会删除这些设置。每个项目都有带 filter 的 **Skills** 和 **Agents** 标签页,可以预览并查看会写入的文件夹,还有一个 **MCP** 标签页,用于在该文件夹中关闭 global server 或为它添加自己的 server,并提供 **检查** 来检查这些 server。**Sync project** 会先预览,然后只 sync 该项目的 skills、agents 和 MCP。已经指向某个项目文件夹的 Target 可以被转换 |
| **Projects** | 仅限 global mode。global 配置会 sync 进的项目文件夹,来自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只保存在本机的项目(标记为 **此机器**)和 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同样的项目也可以在终端中通过 [`skillshare project`](./project.md) 管理。**添加项目** 需要填写文件夹、它的 Target 和要 sync 的内容,除非在对话框底部的 **保存到** 选择 **只存在这台机器**,否则会保存到 `config.yaml`(当 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 为 `machine-local` 时默认选择只存在这台机器)。**同时添加这个文件夹里的每个 checkout** 的效果和 [`project add --scan`](./project.md#scan) 相同:在**查找位置**列出 `.worktrees` 这类文件夹,点**检查**后会先列出每个文件夹是 Added、Kept 还是 Skipped 以及原因,确认后才写入。勾选了 MCP 和 Hooks 时,会为每个新增的项目设置。编辑会保存在项目所在的位置。要移动已保存的项目,请使用 `skillshare project localize` 或 `share`。移除一个被本机覆盖的项目时,会询问是只移除本机的副本,还是连 `config.yaml` 中的一并移除。移除项目后,它在 `mcp.projects` 和 `hooks.projects` 的设置会保留,所以文件夹仍会列出;再移除一次就会删除这些设置。每个项目都有带 filter 的 **Skills** 和 **Agents** 标签页,可以预览并查看会写入的文件夹,还有一个 **MCP** 标签页,用于在该文件夹中关闭 global server 或为它添加自己的 server,并提供 **检查** 来检查这些 server。**Sync project** 会先预览,然后只 sync 该项目的 skills、agents 和 MCP。已经指向某个项目文件夹的 Target 可以被转换 |
| **Audit** | 对 skills 和 agents 的安全扫描,按严重程度列出 findings。[跟随的 source 链接](/docs/reference/targets/configuration#follow_source_links)无法读取时,Skills / Agents 标签页旁会标出 **扫描不完整**,以免把部分扫描误认为完整扫描;此时扫描完成后会显示警告而不是全部正常,dashboard 的 **Needs attention** 中也会列出。**Rules** 标签页按类别浏览每一条规则:可以关闭某一条、更改其严重程度、把某个严重程度应用到整个类别、选择扫描 profile(`default`、`strict`、`permissive`),或打开自定义 `audit-rules.yaml` 的编辑器 |
| **Settings** | 带标签页:**General**(source 路径、sync 模式、外观)、**Backup**(target 文件夹快照、`AGENTS.md` 等文件的早期版本,以及 MCP 配置备份;参见 [`backup`](./backup.md#dashboard))、**Log**(操作历史)、**Health**(与 [`doctor`](/docs/reference/commands/doctor) 相同的检查)、**Extensions**(同步时的文件转换)、**Files**(`config.yaml`、`.skillignore` 和 `.agentignore` 的直接编辑器;存在 `.skillignore.local` 或 `.agentignore.local` 时,因为它在该文件之后套用、可以覆盖它,编辑器会在上方显示它的规则) |
@@ -15,6 +15,7 @@ skillshare project # Same as project list
skillshare project list --json
skillshare project show <project> --json
skillshare project add <root> --target T [options]
skillshare project add <root> --scan DIR --target T [options]
skillshare project edit <project> [options]
skillshare project sync <project> [--dry-run] [--json]
skillshare project localize <project> [--dry-run] [--json]
@@ -36,6 +37,7 @@ skillshare project remove <project> [--shared] [--yes] [--dry-run] [--json]
| `--skills-naming NAMING` | add, edit | `flat`、`standard` 或 `prefixed`;空值代表沿用繼承值 |
| `--skills-include P`, `--skills-exclude P` | add, edit | 重複指定以提供多個 glob pattern;會取代對應的清單;空值會清空清單 |
| `--agents-include P`, `--agents-exclude P` | add, edit | Agents 套用相同的取代規則;filters 需要 merge 或 copy 模式 |
| `--scan DIR` | add | 一併新增根路徑中此資料夾底下的每個 Git checkout,設定相同;可重複指定多個資料夾。請參閱[工作區裡的 checkout](#scan) |
| `--machine-local` | add | 只儲存在本機,不寫入 `config.yaml` |
| `--shared` | add, remove | add:即使 [`projects_storage`](#local-registrations) 為 `machine-local`,也儲存到 `config.yaml`。remove:同時移除本機所覆寫專案在 `config.yaml` 中的副本 |
| `--sync` | add, edit | 儲存後同步這個 project 的 skills 與 agents;不啟用 force |
@@ -63,6 +65,28 @@ skillshare project show shop-web --json
停用 skills 的 project 永遠不會執行 skills 同步流程,在 global symlink 模式下也一樣。請求或啟用的資源選擇為空時,會直接成功,不進行探索、備份或 target 寫入。
### 註冊工作區裡的每個 checkout {#scan}
有些工具(例如 Codex)只會往上找到所開啟資料夾的 Git 根路徑為止來尋找專案 skills。當一個工作區資料夾裡有多個 checkout 時,同步到工作區的 skills 在這些 checkout 裡看不到。`--scan` 會把每個 checkout 註冊成各自的專案,設定相同:
```bash
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --dry-run
skillshare project add ~/work/suite --scan . --scan .worktrees \
--target codex --skills-include 'team-*' --sync
```
`--scan` 接受根路徑內的資料夾(`.` 代表根路徑本身),並在其中尋找 checkout:含有 `.git` 資料夾,或含有連結 worktree 的 `.git` 檔案的資料夾。找到 checkout 後不再往下搜尋。掃描資料夾底下的隱藏資料夾、`node_modules` 與連結都會略過,所以 `.worktrees` 這類隱藏資料夾請明確指定。尚不存在的掃描資料夾,或無法讀取的資料夾,會略過並產生警告。
每個 checkout 都會成為一般的專案項目。不會儲存任何掃描設定,`project edit`、`project remove` 與 `--machine-local` 照常運作。只有執行指令時才會掃描,所以新增 clone 或 worktree 後請再執行一次。它只會新增專案:
- 已用相同設定註冊的資料夾會保留。
- 已用不同設定註冊的資料夾(包含根路徑)會略過並維持原狀;請用 `project edit` 修改。
- 有自己 `.skillshare/` 專案設定的 checkout 會略過。
- 新的 checkout 會在同一次執行中一次寫入註冊,因此可以放心從 script 重複執行。
checkout 以資料夾名稱命名。若其他專案或同一次找到的另一個 checkout 已使用該名稱,就改用它在根路徑下的路徑命名:`.worktrees/app-a` 會變成 `worktrees-app-a`,並存為 `name`,之後的掃描會沿用。直接位於根路徑下的 checkout 保留資料夾名稱。若推導出的名稱也已被使用,該 checkout 會略過並說明原因;請用 `--name` 單獨新增。`--sync` 會同步根路徑以及每個新增或保留的 checkout。
### 取代 filters 或重設覆寫設定 {#edit-settings}
```bash
@@ -72,7 +96,7 @@ skillshare project sync shop-web --dry-run --json
skillshare project sync shop-web --json
```
Add 與 edit 會在寫入前驗證完整的有效設定。編輯會儲存在專案所在的位置:`config.yaml`,或僅限本機專案所在的本機。在 `config.yaml` 中,編輯透過 YAML anchor 宣告的專案,也會改變該 anchor 的別名。變更結果會列出受影響的根路徑。沒有任何變化的 add 或 edit 會回傳 `applied: false` 與 `unchanged: true`,但仍會執行 `--sync`。以不同設定重複執行 add 會失敗,並提示改用 `project edit`。自訂名稱不能看起來像根路徑(例如 `~name`、`./name` 或 `C:name`)。
Add 與 edit 會在寫入前驗證完整的有效設定。編輯會儲存在專案所在的位置:`config.yaml`,或僅限本機專案所在的本機。在 `config.yaml` 中,編輯透過 YAML anchor 宣告的專案,也會改變該 anchor 的別名。變更結果會列出受影響的根路徑。沒有任何變化的 add 或 edit 會回傳 `applied: false` 與 `unchanged: true`,但仍會執行 `--sync`。以不同設定重複執行 add 會失敗,並提示改用 `project edit`;加上 `--scan` 時則會略過該資料夾。自訂名稱不能看起來像根路徑(例如 `~name`、`./name` 或 `C:name`)。
### 移除專案 {#remove}
@@ -98,6 +122,8 @@ CLI edit 會依相同規則分離被移出的 skill 路徑。只要專案的 ski
| add, edit, remove, localize, share | `action`、`project`、`applied`、`affected`、`warnings`;可選的 `sync`、`detach` 或 `remaining`(remove) |
| sync | `action`、`project`、`sync`;預覽另外包含 `applied: false` |
使用 `--scan` 時,`project` 是根路徑,add 另外回傳 `scan` 陣列,每個資料夾一筆:`root`、`path`(相對於根路徑;根路徑本身為 `.`)、`name`、`result`(`added`、`kept` 或 `skipped`),略過的資料夾另有 `skip`(`different`、`storage`、`removed`、`own-config`、`name-taken` 或 `bad-name`)與 `reason`。加上 `--sync` 時,每筆還會包含該專案的 `sync` 與 `error`(若有)。
Project 物件包含 `root`(儲存時的寫法)、`path`(展開後的路徑)、`name`、`targets`、`skills`、`agents`、`groups`、`missing`、`hasOwnConfig`、`origin`(`shared` 或 `local`)、`originPath`(所屬檔案)與 `sharedCopy`(`config.yaml` 中也宣告了的本機專案)。省略或停用的資源為 `null`。啟用的資源會列出其設定。文字格式的 `project list` 與 `project show` 會回報開/關狀態。Sync 結果包含 `results`、`failed`、`warnings`,以及探索與 filter 的診斷資訊。
某個 target 失敗時,sync 會回報已完成的 targets,並以結束碼 1 結束。Sync 預覽會在 `failed` 中回報衝突並以結束碼 0 結束;無效的輸入仍然會失敗。如果 add/edit 儲存成功但 sync 失敗,註冊會維持已儲存的狀態;修正 target 後再用 `project sync` 重試。找不到的 project 資料夾仍可以 edit,但無法 sync。
@@ -98,7 +98,7 @@ skillshare ui start --clear-cache
| **MCP** | 每個 server 一列,列上的計數按鈕會顯示它同步到的 Agents 的 logo,並開啟它們的切換開關。**新增伺服器** 接受 URL、指令、貼上的片段或檔案;**從目標匯入** 讀取已安裝 Agent 目前的設定。每個 server 的選單都有 **檢視各 Agent 會寫入的設定**,會列出來源與每個 Agent 的檔案,並顯示你選取的那一個(含尚未儲存的編輯內容)。衝突時提供 **從該 Agent 匯入** 或 **以來源覆寫**。server 對話框的 **工具** 區塊用來設定[工具政策](./mcp.md#tool-policy):**載入工具**,它會用對話框目前的設定(不論是否已儲存)啟動 server 一次並列出工具供勾選;用於 `*` 萬用字元的 **排除規則** 列;區塊會列出每個不套用部分政策的已選 Agent,設定政策後該列也會顯示標籤。對於 Pi server,對話框另有 [Pi 內建 MCP](./mcp.md#pi) 的設定:工具曝光模式與其他 Pi 設定,後者以 JSON 填入 [`piOptions`](./mcp.md#pi-options),說明則放在資訊提示中。**預設值** 用來編輯 `mcp.targets`。Sync 框中的 **Sync MCP** 會列出待寫入的變更,只寫入 MCP 設定檔,並為每個檔案保留備份;它下方的 [**檢查**](./mcp.md#check-servers-before-an-agent-starts-them) 會檢查 servers,**備份與還原** 則可預覽並還原這些備份。 |
| **Plugins** | 每個 plugin 一列,並以其 Agents 作為切換開關。展開一列還會列出來源支援的其他 Agents;勾選其中之一即可預覽安裝內容。列選單可以同步、更新、移除,或開啟 **View files**,也就是唯讀瀏覽 Skillshare 已檢視過的本機副本。**Share** 會複製一行指令,從 HTTPS 來源加入勾選的 plugin,並讓 Pi 安裝勾選的 npm Pi 套件。 參見 [跨工具管理 plugins](/docs/how-to/daily-tasks/sharing-plugins) |
| **Targets** | 附帶狀態的 target 列表。**新增目標** 也接受 **另一個帳號**:你已在使用的某個 Agent 的第二個 config 資料夾,並會預覽它寫入的位置。每個 target 的頁面可編輯 include/exclude 篩選條件,並將僅存於本機的 skills 收集回 source。篩選預覽上方的搜尋框可依名稱縮小列表,並標出符合的文字;它只改變顯示的列,不會改變篩選條件。專案頁面與 Extras 的 **Edit target** 對話框也使用同一個預覽與搜尋。**同步內容** 欄以連結列出每個 target 拿到的東西:**Skills**、**Agents**、**MCP**、**Hooks** 與數量、Pi 的 **Extensions**,以及接上共用 `AGENTS.md` 的 target 指示檔;點哪個就開 target 頁的那個分頁。有 MCP 設定檔的 target 會多一個 **MCP** 分頁,每個 server 一列;點一下就會儲存,**Sync all targets** 會寫入所有 target 的 MCP 設定檔。每個 target 還有一個以它所讀檔案命名的分頁(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md**……),會顯示讀取順序、編輯該檔案,並能將它轉換成 `AGENTS.md` |
| **Projects** | 僅限 global mode。global config 會同步進去的 project 資料夾,來自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只儲存在本機的專案(標示為 **此機器**)與 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同樣的專案也可以在終端機中透過 [`skillshare project`](./project.md) 管理。**新增專案** 會要求填入資料夾、它的 targets 與要同步的內容,除非在對話框底部的 **儲存到** 選擇 **只存在這台機器**,否則會儲存到 `config.yaml`(當 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 為 `machine-local` 時預設選擇只存在這台機器)。編輯會儲存在專案所在的位置。要移動已儲存的專案,請使用 `skillshare project localize` 或 `share`。移除一個被本機覆寫的專案時,會詢問是只移除本機的副本,還是連 `config.yaml` 中的一併移除。移除專案後,它在 `mcp.projects` 和 `hooks.projects` 的設定會保留,所以資料夾仍會列出;再移除一次就會刪掉這些設定。每個 project 都有 **Skills** 與 **Agents** 分頁,附帶篩選條件、預覽畫面與會被寫入的資料夾,還有一個 **MCP** 分頁可在該資料夾中關閉 global servers 或給它專屬的 servers,並有 **檢查** 可檢查這些 servers。**Sync project** 會先預覽,再只同步該 project 的 skills、agents 與 MCP。已經指向某個 project 資料夾的 target 可以被轉換 |
| **Projects** | 僅限 global mode。global config 會同步進去的 project 資料夾,來自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只儲存在本機的專案(標示為 **此機器**)與 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同樣的專案也可以在終端機中透過 [`skillshare project`](./project.md) 管理。**新增專案** 會要求填入資料夾、它的 targets 與要同步的內容,除非在對話框底部的 **儲存到** 選擇 **只存在這台機器**,否則會儲存到 `config.yaml`(當 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 為 `machine-local` 時預設選擇只存在這台機器)。**一併加入這個資料夾裡的每個 checkout** 的效果和 [`project add --scan`](./project.md#scan) 相同:在**搜尋位置**列出 `.worktrees` 這類資料夾,按**檢查**後會先列出每個資料夾是 Added、Kept 還是 Skipped 以及原因,確認後才寫入。有勾選 MCP 與 Hooks 時,會為每個新增的專案設定。編輯會儲存在專案所在的位置。要移動已儲存的專案,請使用 `skillshare project localize` 或 `share`。移除一個被本機覆寫的專案時,會詢問是只移除本機的副本,還是連 `config.yaml` 中的一併移除。移除專案後,它在 `mcp.projects` 和 `hooks.projects` 的設定會保留,所以資料夾仍會列出;再移除一次就會刪掉這些設定。每個 project 都有 **Skills** 與 **Agents** 分頁,附帶篩選條件、預覽畫面與會被寫入的資料夾,還有一個 **MCP** 分頁可在該資料夾中關閉 global servers 或給它專屬的 servers,並有 **檢查** 可檢查這些 servers。**Sync project** 會先預覽,再只同步該 project 的 skills、agents 與 MCP。已經指向某個 project 資料夾的 target 可以被轉換 |
| **Audit** | 對 skills 與 agents 進行安全掃描,依嚴重程度列出發現項目。[跟進的 source 連結](/docs/reference/targets/configuration#follow_source_links)無法讀取時,Skills / Agents 分頁旁會標出 **掃描不完整**,以免把部分掃描誤認為完整掃描;此時掃描完成後會顯示警告而不是一切正常,dashboard 的 **Needs attention** 中也會列出。**Rules** 分頁可依分類瀏覽每一項規則:關閉某項、變更其嚴重程度、對整個分類套用嚴重程度、選擇掃描設定檔(`default`、`strict`、`permissive`),或開啟編輯器自訂 `audit-rules.yaml` |
| **Settings** | 分頁式:**General**(source 路徑、同步模式、外觀)、**Backup**(target 資料夾快照、`AGENTS.md` 這類檔案的較早版本,以及 MCP 設定備份;參見 [`backup`](./backup.md#dashboard))、**Log**(操作歷史)、**Health**(與 [`doctor`](/docs/reference/commands/doctor) 相同的檢查)、**Extensions**(同步時的檔案轉換)、**Files**(直接編輯 `config.yaml`、`.skillignore` 與 `.agentignore`;有 `.skillignore.local` 或 `.agentignore.local` 時,因為它在該檔案之後套用、可以覆蓋它,編輯器會在上方顯示它的規則) |