From 70cb2876723a07898b63201f5aa423dbc5863d4f Mon Sep 17 00:00:00 2001 From: Willie Date: Sun, 4 Oct 2026 15:16:14 +0800 Subject: [PATCH] fix(plugin): find the Codex CLI the desktop app ships (#383) * fix(plugin): find the Codex CLI the desktop app ships Plugin commands ran the bare name `codex` from PATH, so a machine with only the Codex desktop app, or a scheduled job started with a minimal PATH, reported the CLI as missing. The account-only `cli` override did not help: the default codex target cannot set it, and an absolute path in a config shared between macOS and Windows is wrong on one of them. When `codex` is not on PATH, look in Homebrew's folders and the CLI the app installs (Codex.app on macOS, %LOCALAPPDATA%\OpenAI\Codex\bin on Windows). SKILLSHARE_CODEX_CLI overrides the search on one machine without touching the synced config. The missing-CLI error now lists every place searched, in the CLI and the dashboard. Refs #338 * docs(plugin): note where Skillshare finds the Codex CLI The plugin reference and the sharing guide still said every native CLI must be on PATH, and the built-in skill told agents a missing CLI has no fallback. Codex now has one, plus a machine-local override that agents should prefer over a path in a shared config. Refs #338 * fix(plugin): look for the Codex CLI inside ChatGPT.app Since the Codex desktop app merged with ChatGPT, macOS installs it as ChatGPT.app, so an app-only Mac with a minimal PATH still reported Codex as missing. Try ChatGPT.app before Codex.app in /Applications and ~/Applications, the order Codex's own desktop-app finder uses. Refs #338 * fix(plugin): run the packaged CLI entrypoint of the ChatGPT app ChatGPT Desktop 26.924 removed Contents/Resources/codex and ships the CLI at the entrypoint its package manifest declares, codex-cli/bin/codex, so a current app-only Mac still reported Codex as missing. Try that entrypoint first in each app bundle and keep the old path for earlier builds. Refs #338 * fix(plugin): find the Codex CLI from the Windows installer The official PowerShell installer puts codex.exe in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin and adds it to the user PATH. A job started without that PATH missed it, the same gap Homebrew's folders cover on macOS. Try it before the desktop app's copy. Refs #338 * fix(plugin): keep an account's cli even when it is codex The Codex search ran whenever the executable was the bare name codex, so an account that set cli: codex could get SKILLSHARE_CODEX_CLI or the app's CLI instead, against the documented rule that an account's own cli is kept. Search only when no account cli is set. Refs #338 --- internal/plugin/codex_cli.go | 96 +++++++++++ internal/plugin/codex_cli_test.go | 152 ++++++++++++++++++ internal/plugin/model.go | 8 +- internal/plugin/native.go | 20 ++- internal/plugin/service.go | 2 +- skills/skillshare/references/plugins.md | 6 + ui/src/api/plugins.ts | 2 +- ui/src/components/plugins/PluginAgents.tsx | 10 +- ui/src/i18n/locales/de.json | 1 + ui/src/i18n/locales/en.json | 1 + ui/src/i18n/locales/es.json | 1 + ui/src/i18n/locales/fa.json | 1 + ui/src/i18n/locales/fr.json | 1 + ui/src/i18n/locales/id.json | 1 + ui/src/i18n/locales/ja.json | 1 + ui/src/i18n/locales/ko.json | 1 + ui/src/i18n/locales/pt-BR.json | 1 + ui/src/i18n/locales/zh-CN.json | 1 + ui/src/i18n/locales/zh-TW.json | 1 + ui/src/pages/PluginsPage.test.tsx | 10 ++ ui/src/pages/PluginsPage.tsx | 4 +- .../how-to/daily-tasks/sharing-plugins.md | 1 + .../docs/how-to/sharing/cross-machine-sync.md | 2 +- .../appendix/environment-variables.md | 27 ++++ website/docs/reference/commands/plugin.md | 5 + website/docs/troubleshooting/common-errors.md | 9 ++ .../how-to/daily-tasks/sharing-plugins.md | 4 +- .../how-to/sharing/cross-machine-sync.md | 2 +- .../appendix/environment-variables.md | 27 ++++ .../current/reference/commands/plugin.md | 4 + .../current/troubleshooting/common-errors.md | 9 ++ .../how-to/daily-tasks/sharing-plugins.md | 1 + .../how-to/sharing/cross-machine-sync.md | 2 +- .../appendix/environment-variables.md | 27 ++++ .../current/reference/commands/plugin.md | 4 + .../current/troubleshooting/common-errors.md | 9 ++ .../how-to/daily-tasks/sharing-plugins.md | 1 + .../how-to/sharing/cross-machine-sync.md | 2 +- .../appendix/environment-variables.md | 27 ++++ .../current/reference/commands/plugin.md | 4 + .../current/troubleshooting/common-errors.md | 9 ++ .../how-to/daily-tasks/sharing-plugins.md | 1 + .../how-to/sharing/cross-machine-sync.md | 2 +- .../appendix/environment-variables.md | 27 ++++ .../current/reference/commands/plugin.md | 4 + .../current/troubleshooting/common-errors.md | 9 ++ 46 files changed, 522 insertions(+), 18 deletions(-) create mode 100644 internal/plugin/codex_cli.go create mode 100644 internal/plugin/codex_cli_test.go diff --git a/internal/plugin/codex_cli.go b/internal/plugin/codex_cli.go new file mode 100644 index 000000000..fe6c9c298 --- /dev/null +++ b/internal/plugin/codex_cli.go @@ -0,0 +1,96 @@ +package plugin + +import ( + "os" + "os/exec" + "path/filepath" + "runtime" + "strings" +) + +// codexCLIEnv points plugin commands at a Codex CLI on this machine only, for when the +// config is shared with another OS or a background job starts with a minimal PATH. +const codexCLIEnv = "SKILLSHARE_CODEX_CLI" + +// codexFinder looks for the Codex CLI. Its fields are the machine, so tests can stand in. +type codexFinder struct { + goos string + home string + localAppData string + getenv func(string) string + lookPath func(string) (string, error) +} + +func newCodexFinder() codexFinder { + home, _ := os.UserHomeDir() + return codexFinder{goos: runtime.GOOS, home: home, localAppData: os.Getenv("LOCALAPPDATA"), getenv: os.Getenv, lookPath: exec.LookPath} +} + +// candidates are the places a Codex CLI is installed outside PATH: Homebrew or the +// Windows installer, which a background job's PATH may lack, and the copy the Codex +// desktop app ships. A pattern may +// hold one *, for the Windows app's per-version folder. +func (f codexFinder) candidates() []string { + switch f.goos { + case "darwin": + paths := []string{"/opt/homebrew/bin/codex", "/usr/local/bin/codex"} + dirs := []string{"/Applications"} + if f.home != "" { + dirs = append(dirs, filepath.Join(f.home, "Applications")) + } + // The app is ChatGPT.app since it merged with ChatGPT, Codex.app before. Since 26.924 + // its CLI is the packaged entrypoint codex-cli/bin/codex; older builds have codex. + for _, dir := range dirs { + for _, app := range []string{"ChatGPT.app", "Codex.app"} { + resources := filepath.Join(dir, app, "Contents", "Resources") + paths = append(paths, filepath.Join(resources, "codex-cli", "bin", "codex"), filepath.Join(resources, "codex")) + } + } + return paths + case "windows": + // The official PowerShell installer's default, then the copy the app keeps. + if f.localAppData != "" { + return []string{ + filepath.Join(f.localAppData, "Programs", "OpenAI", "Codex", "bin", "codex.exe"), + filepath.Join(f.localAppData, "OpenAI", "Codex", "bin", "*", "codex.exe"), + } + } + } + return nil +} + +// find returns the Codex CLI to run and the places it looked. It returns "codex" when +// nothing is found, so the run still fails as missing, and looked then names the places. +func (f codexFinder) find() (string, []string) { + if cli := strings.TrimSpace(f.getenv(codexCLIEnv)); cli != "" { + return cli, []string{codexCLIEnv + "=" + cli} + } + looked := []string{"PATH"} + if _, err := f.lookPath("codex"); err == nil { + return "codex", looked + } + for _, pattern := range f.candidates() { + looked = append(looked, pattern) + if path := newest(pattern); path != "" { + return path, looked + } + } + return "codex", looked +} + +// newest is the most recently modified file matching pattern: the Codex app leaves one +// folder per version it has installed. +func newest(pattern string) string { + matches, _ := filepath.Glob(pattern) + best, bestTime := "", int64(0) + for _, path := range matches { + info, err := os.Stat(path) + if err != nil || info.IsDir() { + continue + } + if t := info.ModTime().UnixNano(); best == "" || t > bestTime { + best, bestTime = path, t + } + } + return best +} diff --git a/internal/plugin/codex_cli_test.go b/internal/plugin/codex_cli_test.go new file mode 100644 index 000000000..3be4f817f --- /dev/null +++ b/internal/plugin/codex_cli_test.go @@ -0,0 +1,152 @@ +package plugin + +import ( + "context" + "errors" + "os" + "os/exec" + "path/filepath" + "slices" + "strings" + "testing" + "time" +) + +func notOnPath(string) (string, error) { return "", exec.ErrNotFound } + +func noEnv(string) string { return "" } + +func writeExe(t *testing.T, path string, mtime time.Time) { + t.Helper() + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + t.Fatal(err) + } + if err := os.WriteFile(path, nil, 0o755); err != nil { + t.Fatal(err) + } + if err := os.Chtimes(path, mtime, mtime); err != nil { + t.Fatal(err) + } +} + +// SKILLSHARE_CODEX_CLI is set on one machine only, so it wins over everything found. +func TestCodexFinderPrefersEnvironment(t *testing.T) { + f := codexFinder{goos: "darwin", getenv: func(string) string { return "/opt/codex" }, lookPath: func(string) (string, error) { return "/usr/bin/codex", nil }} + if bin, _ := f.find(); bin != "/opt/codex" { + t.Fatalf("bin = %q", bin) + } +} + +// A codex on PATH runs by name, as before. +func TestCodexFinderUsesPath(t *testing.T) { + home := t.TempDir() + writeExe(t, filepath.Join(home, "Applications", "Codex.app", "Contents", "Resources", "codex"), time.Now()) + f := codexFinder{goos: "darwin", home: home, getenv: noEnv, lookPath: func(string) (string, error) { return "/usr/bin/codex", nil }} + if bin, _ := f.find(); bin != "codex" { + t.Fatalf("bin = %q", bin) + } +} + +// With only the macOS app installed, its bundled CLI runs. +func TestCodexFinderFindsMacApp(t *testing.T) { + home := t.TempDir() + want := filepath.Join(home, "Applications", "Codex.app", "Contents", "Resources", "codex") + writeExe(t, want, time.Now()) + f := codexFinder{goos: "darwin", home: home, getenv: noEnv, lookPath: notOnPath} + if bin, _ := f.find(); bin != want { + t.Fatalf("bin = %q, want %q", bin, want) + } +} + +// Since the ChatGPT app merger the bundle is ChatGPT.app; it is tried before Codex.app. +func TestCodexFinderFindsChatGPTApp(t *testing.T) { + home := t.TempDir() + want := filepath.Join(home, "Applications", "ChatGPT.app", "Contents", "Resources", "codex") + writeExe(t, want, time.Now()) + writeExe(t, filepath.Join(home, "Applications", "Codex.app", "Contents", "Resources", "codex"), time.Now()) + f := codexFinder{goos: "darwin", home: home, getenv: noEnv, lookPath: notOnPath} + if bin, _ := f.find(); bin != want { + t.Fatalf("bin = %q, want %q", bin, want) + } +} + +// ChatGPT 26.924 moved the CLI to the packaged entrypoint codex-cli/bin/codex. +func TestCodexFinderFindsPackagedEntrypoint(t *testing.T) { + home := t.TempDir() + want := filepath.Join(home, "Applications", "ChatGPT.app", "Contents", "Resources", "codex-cli", "bin", "codex") + writeExe(t, want, time.Now()) + f := codexFinder{goos: "darwin", home: home, getenv: noEnv, lookPath: notOnPath} + if bin, _ := f.find(); bin != want { + t.Fatalf("bin = %q, want %q", bin, want) + } +} + +// The Windows app keeps one folder per version it installed; the newest one runs. +func TestCodexFinderFindsNewestWindowsApp(t *testing.T) { + local := t.TempDir() + old := filepath.Join(local, "OpenAI", "Codex", "bin", "aaa", "codex.exe") + want := filepath.Join(local, "OpenAI", "Codex", "bin", "bbb", "codex.exe") + writeExe(t, want, time.Now()) + writeExe(t, old, time.Now().Add(-time.Hour)) + f := codexFinder{goos: "windows", localAppData: local, getenv: noEnv, lookPath: notOnPath} + if bin, _ := f.find(); bin != want { + t.Fatalf("bin = %q, want %q", bin, want) + } +} + +// The official PowerShell installer's CLI comes before the app's copy, like Homebrew on macOS. +func TestCodexFinderPrefersWindowsInstaller(t *testing.T) { + local := t.TempDir() + want := filepath.Join(local, "Programs", "OpenAI", "Codex", "bin", "codex.exe") + writeExe(t, want, time.Now()) + writeExe(t, filepath.Join(local, "OpenAI", "Codex", "bin", "aaa", "codex.exe"), time.Now()) + f := codexFinder{goos: "windows", localAppData: local, getenv: noEnv, lookPath: notOnPath} + if bin, _ := f.find(); bin != want { + t.Fatalf("bin = %q, want %q", bin, want) + } +} + +// Found nowhere, codex still runs by name so it fails as missing, and every place is named. +func TestCodexFinderListsWhereItLooked(t *testing.T) { + local := t.TempDir() + f := codexFinder{goos: "windows", localAppData: local, getenv: noEnv, lookPath: notOnPath} + bin, looked := f.find() + want := []string{"PATH", filepath.Join(local, "Programs", "OpenAI", "Codex", "bin", "codex.exe"), filepath.Join(local, "OpenAI", "Codex", "bin", "*", "codex.exe")} + if bin != "codex" || !slices.Equal(looked, want) { + t.Fatalf("bin = %q, looked = %v", bin, looked) + } +} + +// A missing Codex CLI is still a missing CLI, and its error names where Skillshare looked. +func TestMissingCodexNamesWhereItLooked(t *testing.T) { + s := &Service{ + findCodex: func() (string, []string) { + return "codex", []string{"PATH", "/Applications/Codex.app/Contents/Resources/codex"} + }, + Run: func(context.Context, string, []string, string, ...string) ([]byte, error) { + return nil, agentError{cause: ErrCLIMissing, key: "plugins.error.cliMissing", message: "codex CLI is not installed"} + }, + } + s.ProjectRoot = t.TempDir() + _, err := s.run(context.Background(), "codex", "--version") + key, args := ErrorKey(err) + if !errors.Is(err, ErrCLIMissing) || key != "plugins.error.codexMissing" || !strings.Contains(err.Error(), "/Applications/Codex.app") || args["looked"] != "PATH, /Applications/Codex.app/Contents/Resources/codex" { + t.Fatalf("err = %v, key = %q, args = %v", err, key, args) + } +} + +// An account's own cli is what it asked for, even the bare name codex; the search does not replace it. +func TestCodexAccountCLIIsNotSearched(t *testing.T) { + var ran string + s := &Service{ + Accounts: map[string]Account{"codex-work": {Agent: "codex", Dir: t.TempDir(), CLI: "codex"}}, + findCodex: func() (string, []string) { t.Fatal("searched for codex"); return "", nil }, + Run: func(_ context.Context, _ string, _ []string, bin string, _ ...string) ([]byte, error) { + ran = bin + return nil, nil + }, + } + if _, err := s.run(context.Background(), "codex-work", "--version"); err != nil || ran != "codex" { + t.Fatalf("ran %q, err = %v", ran, err) + } +} diff --git a/internal/plugin/model.go b/internal/plugin/model.go index 535813030..027eb8221 100644 --- a/internal/plugin/model.go +++ b/internal/plugin/model.go @@ -174,6 +174,8 @@ type Host struct { Error string `json:"error,omitempty"` ErrorKey string `json:"errorKey,omitempty"` Installed []Installed `json:"installed"` + // ErrorArgs fill the {placeholders} of ErrorKey's sentence. + ErrorArgs map[string]string `json:"errorArgs,omitempty"` // Marketplaces maps each Claude/Codex marketplace name to its root; nil when unknown. Marketplaces map[string]string `json:"marketplaces,omitempty"` // ManagedMarketplaces names the ones Skillshare registered from its own state directory. @@ -187,11 +189,11 @@ func (h *Host) fail(err error) { h.Installed = []Installed{} } h.Error = err.Error() - h.ErrorKey = "" + h.ErrorKey, h.ErrorArgs = "", nil h.Status = HostBlocked var keyed agentError if errors.As(err, &keyed) { - h.ErrorKey = keyed.key + h.ErrorKey, h.ErrorArgs = keyed.key, keyed.args } if errors.Is(err, ErrCLIMissing) { h.Status = HostMissing @@ -268,6 +270,8 @@ type Service struct { // extra links into Pi's folder is shown as that extra's file. ExtrasSources map[string]string Run Runner + // findCodex stands in for the Codex CLI search in tests; nil searches this machine. + findCodex func() (string, []string) } func (b Binding) Selected() bool { return b.Sync == nil || *b.Sync } diff --git a/internal/plugin/native.go b/internal/plugin/native.go index a3c83109b..317548a8d 100644 --- a/internal/plugin/native.go +++ b/internal/plugin/native.go @@ -132,13 +132,29 @@ func (s *Service) run(ctx context.Context, target string, args ...string) ([]byt if bin == "antigravity-cli" { bin = "agy" } + explicit := false if account, ok := s.account(target); ok { env = account.env() if account.CLI != "" { - bin = account.CLI + bin, explicit = account.CLI, true } } - return run(ctx, dir, env, bin, args...) + // Only the default codex is searched for; an account's cli, even "codex", is kept. + if bin != "codex" || explicit { + return run(ctx, dir, env, bin, args...) + } + find := s.findCodex + if find == nil { + find = newCodexFinder().find + } + bin, looked := find() + out, err := run(ctx, dir, env, bin, args...) + if errors.Is(err, ErrCLIMissing) { + where := strings.Join(looked, ", ") + return nil, agentError{cause: ErrCLIMissing, key: "plugins.error.codexMissing", args: map[string]string{"looked": where}, + message: fmt.Sprintf("Codex CLI not found on the machine running Skillshare (looked in: %s); install it there, or set %s to its path", where, codexCLIEnv)} + } + return out, err } func parseInventory(target string, data []byte, project string) ([]Installed, error) { diff --git a/internal/plugin/service.go b/internal/plugin/service.go index c20ae593d..f3b272dec 100644 --- a/internal/plugin/service.go +++ b/internal/plugin/service.go @@ -122,7 +122,7 @@ func (s *Service) Preview(ctx context.Context, r Request) (*Plan, error) { // A change already blocked keeps its own reason; the key always matches the message. if h.Error != "" && c.Action != "blocked" { c.Action = "blocked" - c.Message, c.MessageKey, c.MessageArgs = h.Error, h.ErrorKey, nil + c.Message, c.MessageKey, c.MessageArgs = h.Error, h.ErrorKey, h.ErrorArgs } if c.Action != "blocked" && c.Action != "noop" && c.Action != "skip" && c.Action != "import" && c.Action != "update-available" && c.Action != "native-check" { if err := s.verifyCommand(ctx, c.Target, c.Action, c.ID); err != nil { diff --git a/skills/skillshare/references/plugins.md b/skills/skillshare/references/plugins.md index 4bde27930..67a3d3f84 100644 --- a/skills/skillshare/references/plugins.md +++ b/skills/skillshare/references/plugins.md @@ -128,6 +128,12 @@ cannot reach, says why, and still updates the other targets. `PI_CODING_AGENT_DIR`, and the account keeps its own bindings. Global scope only. With `cli:` it runs that compatible CLI instead (such as `omo` for Pi); a Pi account also sets `SENPI_CODING_AGENT_DIR` and `OMO_CODING_AGENT_DIR`. A missing CLI fails, with no fallback. +- Codex without `cli:`: `codex` on PATH, then Homebrew (`/opt/homebrew/bin`, `/usr/local/bin`) or the + Windows installer (`%LOCALAPPDATA%\Programs\OpenAI\Codex\bin`) + and the CLI shipped in the Codex desktop app (macOS `ChatGPT.app`, or `Codex.app` before the merger, Windows + `%LOCALAPPDATA%\OpenAI\Codex\bin\`). The machine-local env var + `SKILLSHARE_CODEX_CLI` overrides the search; prefer it over a path in a shared config. + The missing-CLI error lists every place searched. - Local directory plugins cannot import unowned folders or marketplace installs. Pi 0.99.2 or later can import supported filtered entries without changing native settings. Preview shows retained keys; raw entries stay in private state diff --git a/ui/src/api/plugins.ts b/ui/src/api/plugins.ts index a6c855824..80b0e5826 100644 --- a/ui/src/api/plugins.ts +++ b/ui/src/api/plugins.ts @@ -15,7 +15,7 @@ export interface PluginInventory { packages: Record; /** `status`: 'ready' | 'missing' (its CLI is not on PATH here) | 'blocked' (deal with it in the Agent). */ /** `managedMarketplaces`: the Claude/Codex marketplaces Skillshare registered from its own state directory. */ - hosts: { target: PluginTarget; version: string; status: string; error?: string; errorKey?: string; note?: string; noteKey?: string; installed: NativePlugin[]; managedMarketplaces?: string[] }[]; + hosts: { target: PluginTarget; version: string; status: string; error?: string; errorKey?: string; errorArgs?: Record; note?: string; noteKey?: string; installed: NativePlugin[]; managedMarketplaces?: string[] }[]; } /** * What Sync would do to one binding, '' when nothing. Without `host` (the Agents have not diff --git a/ui/src/components/plugins/PluginAgents.tsx b/ui/src/components/plugins/PluginAgents.tsx index 2e4866d3c..6f07dfb5c 100644 --- a/ui/src/components/plugins/PluginAgents.tsx +++ b/ui/src/components/plugins/PluginAgents.tsx @@ -28,14 +28,14 @@ export default function PluginAgents({ inventory, ready, refreshing, disabled, o const label = (target: string) => labels[target]?.label ?? target; // The backend keys its fixed sentences; a message it assembled at runtime has no key // and is shown as it came, which is also what the CLI prints. - const message = (key: string | undefined, text: string | undefined) => (key ? t(key, undefined, text) : text ?? ''); + const message = (key: string | undefined, text: string | undefined, args?: Record) => (key ? t(key, args, text) : text ?? ''); // Native registrations need not be managed by Skillshare; extension selection stays on each Pi target. const piTargets = new Set((useSyncedTargetsQuery().data?.targets ?? []).filter(isPiTarget).map((x) => x.name)); const manual = inventory.hosts.filter((h) => labels[h.target]?.operations.length === 0); const byStatus = (status: string) => inventory.hosts.filter((h) => h.status === status && !manual.includes(h)); const reasoned = (hosts: PluginInventory['hosts']) => hosts.map((h) => ( - {message(h.errorKey, h.error)}} /> + {message(h.errorKey, h.error, h.errorArgs)}} /> )); return ( @@ -66,7 +66,9 @@ export default function PluginAgents({ inventory, ready, refreshing, disabled, o {/* One cause shared by every Agent here, so it is stated once instead of per row. */} {byStatus('missing').length > 0 && ( - {byStatus('missing').map((h) => } />)} + {byStatus('missing').map((h) => h.errorArgs + ? reasoned([h])[0] + : } />)} )} diff --git a/ui/src/i18n/locales/de.json b/ui/src/i18n/locales/de.json index fa359ff9a..19acfc37b 100644 --- a/ui/src/i18n/locales/de.json +++ b/ui/src/i18n/locales/de.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "Updates müssen in der Antigravity CLI geprüft werden, damit der native Aktivierungsstatus erhalten bleibt.", "plugins.reason.grok": "Installiere oder aktualisiere in Grok, um die native Vertrauensfreigabe abzuschließen, und importiere danach.", "plugins.error.cliMissing": "Diese CLI ist nicht installiert oder nicht im PATH der Maschine, auf der Skillshare läuft; installiere sie dort, bevor du Plugins synchronisierst.", + "plugins.error.codexMissing": "Skillshare findet die Codex CLI nicht (gesucht in: {looked}). Installiere sie auf der Maschine, auf der Skillshare läuft, oder setze SKILLSHARE_CODEX_CLI auf ihren Pfad.", "plugins.error.timeout": "Der Befehl hat das Zeitlimit überschritten oder wurde abgebrochen; prüfe den Agent, bevor du es erneut versuchst.", "plugins.error.network": "Die Plugin-Quelle ist nicht erreichbar. Prüfe deine Netzwerkverbindung und versuche es erneut.", "plugins.error.sourceNotFound": "Die Plugin-Quelle wurde nicht gefunden. Prüfe Repository-Adresse und Branch und ob das Repository privat ist.", diff --git a/ui/src/i18n/locales/en.json b/ui/src/i18n/locales/en.json index da71327e3..854f4d3b5 100644 --- a/ui/src/i18n/locales/en.json +++ b/ui/src/i18n/locales/en.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "To update, use Antigravity CLI itself. Skillshare does not reinstall the plugin for updates because that could change whether it is enabled in Antigravity.", "plugins.reason.grok": "Install the plugin in Grok and approve its permissions first. Then choose Import installed here. Skillshare can track and remove it; installation and updates stay in Grok.", "plugins.error.cliMissing": "This CLI is not installed or not on PATH on the machine running Skillshare; install it there before syncing plugins.", + "plugins.error.codexMissing": "Skillshare cannot find the Codex CLI (looked in: {looked}). Install it on the machine running Skillshare, or set SKILLSHARE_CODEX_CLI to its path.", "plugins.error.timeout": "The command timed out or was cancelled; check the Agent before retrying.", "plugins.error.network": "Could not reach the plugin source. Check your network connection and try again.", "plugins.error.sourceNotFound": "The plugin source was not found. Check the repository address and branch, and whether the repository is private.", diff --git a/ui/src/i18n/locales/es.json b/ui/src/i18n/locales/es.json index 2b9c76aac..dc81f478b 100644 --- a/ui/src/i18n/locales/es.json +++ b/ui/src/i18n/locales/es.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "Las actualizaciones requieren revisión en Antigravity CLI para conservar el estado de activación nativo.", "plugins.reason.grok": "Instala o actualiza en Grok para completar la confianza nativa y luego importa.", "plugins.error.cliMissing": "Este CLI no está instalado o no está en el PATH de la máquina que ejecuta Skillshare; instálalo allí antes de sincronizar plugins.", + "plugins.error.codexMissing": "Skillshare no encuentra el CLI de Codex (buscado en: {looked}). Instálalo en la máquina que ejecuta Skillshare o define SKILLSHARE_CODEX_CLI con su ruta.", "plugins.error.timeout": "El comando agotó el tiempo o se canceló; revisa el Agent antes de reintentar.", "plugins.error.network": "No se pudo acceder al origen del plugin. Revisa tu conexión de red e inténtalo de nuevo.", "plugins.error.sourceNotFound": "No se encontró el origen del plugin. Revisa la dirección del repositorio y la rama, y si el repositorio es privado.", diff --git a/ui/src/i18n/locales/fa.json b/ui/src/i18n/locales/fa.json index c26467f9b..000ed8056 100644 --- a/ui/src/i18n/locales/fa.json +++ b/ui/src/i18n/locales/fa.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "برای حفظ وضعیت فعال‌سازی بومی، به‌روزرسانی‌ها باید در Antigravity CLI بررسی شوند.", "plugins.reason.grok": "در Grok نصب یا به‌روزرسانی کنید تا اعتماد بومی کامل شود، سپس وارد کنید.", "plugins.error.cliMissing": "این CLI نصب نشده یا در PATH ماشینی که Skillshare را اجرا می‌کند نیست؛ پیش از همگام‌سازی plugin آن را همان‌جا نصب کنید.", + "plugins.error.codexMissing": "Skillshare نمی‌تواند CLI مربوط به Codex را پیدا کند (جاهای بررسی‌شده: {looked}). آن را روی ماشینی که Skillshare را اجرا می‌کند نصب کنید، یا SKILLSHARE_CODEX_CLI را برابر مسیر آن قرار دهید.", "plugins.error.timeout": "زمان اجرای فرمان تمام شد یا لغو شد؛ پیش از تلاش دوباره وضعیت را در Agent بررسی کنید.", "plugins.error.network": "دسترسی به منبع افزونه ممکن نشد. اتصال شبکه را بررسی کنید و دوباره تلاش کنید.", "plugins.error.sourceNotFound": "منبع افزونه پیدا نشد. نشانی مخزن و شاخه را بررسی کنید و ببینید آیا مخزن خصوصی است.", diff --git a/ui/src/i18n/locales/fr.json b/ui/src/i18n/locales/fr.json index 40583219a..27696973f 100644 --- a/ui/src/i18n/locales/fr.json +++ b/ui/src/i18n/locales/fr.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "Les mises à jour doivent être vérifiées dans Antigravity CLI pour préserver l'état d'activation natif.", "plugins.reason.grok": "Installez ou mettez à jour dans Grok pour établir la confiance native, puis importez.", "plugins.error.cliMissing": "Ce CLI n'est pas installé ou absent du PATH de la machine qui exécute Skillshare ; installez-le là-bas avant de synchroniser des plugins.", + "plugins.error.codexMissing": "Skillshare ne trouve pas le CLI Codex (emplacements vérifiés : {looked}). Installez-le sur la machine qui exécute Skillshare, ou définissez SKILLSHARE_CODEX_CLI avec son chemin.", "plugins.error.timeout": "La commande a expiré ou a été annulée ; vérifiez l'Agent avant de réessayer.", "plugins.error.network": "Impossible de joindre la source du plugin. Vérifiez votre connexion réseau et réessayez.", "plugins.error.sourceNotFound": "Source du plugin introuvable. Vérifiez l'adresse du dépôt et la branche, et si le dépôt est privé.", diff --git a/ui/src/i18n/locales/id.json b/ui/src/i18n/locales/id.json index 63dd5a634..84fc1b374 100644 --- a/ui/src/i18n/locales/id.json +++ b/ui/src/i18n/locales/id.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "Pembaruan perlu ditinjau di Antigravity CLI agar status aktif native tetap terjaga.", "plugins.reason.grok": "Pasang atau perbarui di Grok untuk menyelesaikan kepercayaan native, lalu impor.", "plugins.error.cliMissing": "CLI ini belum terpasang atau tidak ada di PATH mesin yang menjalankan Skillshare; pasang di sana sebelum menyinkronkan plugin.", + "plugins.error.codexMissing": "Skillshare tidak menemukan CLI Codex (dicari di: {looked}). Pasang di mesin yang menjalankan Skillshare, atau atur SKILLSHARE_CODEX_CLI ke path-nya.", "plugins.error.timeout": "Perintah kehabisan waktu atau dibatalkan; periksa Agent sebelum mencoba lagi.", "plugins.error.network": "Tidak dapat menjangkau sumber plugin. Periksa koneksi jaringan Anda lalu coba lagi.", "plugins.error.sourceNotFound": "Sumber plugin tidak ditemukan. Periksa alamat repositori dan branch, serta apakah repositori itu privat.", diff --git a/ui/src/i18n/locales/ja.json b/ui/src/i18n/locales/ja.json index d7e847208..eb46f1d61 100644 --- a/ui/src/i18n/locales/ja.json +++ b/ui/src/i18n/locales/ja.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "更新はネイティブの有効状態を保つため、Antigravity CLI での確認が必要です。", "plugins.reason.grok": "Grok でインストールまたは更新してネイティブの信頼を完了してから、インポートしてください。", "plugins.error.cliMissing": "この CLI はインストールされていないか、Skillshare を実行しているマシンの PATH にありません。plugin を同期する前に、そのマシンにインストールしてください。", + "plugins.error.codexMissing": "Skillshare は Codex CLI を見つけられません(確認した場所: {looked})。Skillshare を実行しているマシンにインストールするか、SKILLSHARE_CODEX_CLI にそのパスを設定してください。", "plugins.error.timeout": "コマンドがタイムアウトまたはキャンセルされました。Agent の状態を確認してから再試行してください。", "plugins.error.network": "プラグインのソースに接続できませんでした。ネットワーク接続を確認して、もう一度お試しください。", "plugins.error.sourceNotFound": "プラグインのソースが見つかりません。リポジトリのアドレスとブランチ、リポジトリが非公開でないかを確認してください。", diff --git a/ui/src/i18n/locales/ko.json b/ui/src/i18n/locales/ko.json index 1bc3320b5..187a7d8a3 100644 --- a/ui/src/i18n/locales/ko.json +++ b/ui/src/i18n/locales/ko.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "네이티브 활성화 상태를 유지하려면 Antigravity CLI에서 업데이트를 검토해야 합니다.", "plugins.reason.grok": "Grok에서 설치하거나 업데이트해 네이티브 신뢰를 완료한 뒤 가져오세요.", "plugins.error.cliMissing": "이 CLI가 설치되어 있지 않거나 Skillshare를 실행하는 머신의 PATH에 없습니다. plugin을 동기화하기 전에 해당 머신에 설치하세요.", + "plugins.error.codexMissing": "Skillshare가 Codex CLI를 찾을 수 없습니다(확인한 위치: {looked}). Skillshare를 실행하는 머신에 설치하거나 SKILLSHARE_CODEX_CLI에 경로를 지정하세요.", "plugins.error.timeout": "명령이 시간 초과되었거나 취소되었습니다. Agent에서 상태를 확인한 뒤 다시 시도하세요.", "plugins.error.network": "플러그인 소스에 연결할 수 없습니다. 네트워크 연결을 확인한 뒤 다시 시도하세요.", "plugins.error.sourceNotFound": "플러그인 소스를 찾을 수 없습니다. 저장소 주소와 브랜치, 그리고 저장소가 비공개인지 확인하세요.", diff --git a/ui/src/i18n/locales/pt-BR.json b/ui/src/i18n/locales/pt-BR.json index d4c29be7f..bcf675031 100644 --- a/ui/src/i18n/locales/pt-BR.json +++ b/ui/src/i18n/locales/pt-BR.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "As atualizações exigem revisão no Antigravity CLI para preservar o estado de ativação nativo.", "plugins.reason.grok": "Instale ou atualize no Grok para concluir a confiança nativa e depois importe.", "plugins.error.cliMissing": "Este CLI não está instalado ou não está no PATH da máquina que executa o Skillshare; instale-o lá antes de sincronizar plugins.", + "plugins.error.codexMissing": "O Skillshare não encontra o CLI do Codex (procurado em: {looked}). Instale-o na máquina que executa o Skillshare ou defina SKILLSHARE_CODEX_CLI com o caminho dele.", "plugins.error.timeout": "O comando expirou ou foi cancelado; verifique o Agent antes de tentar de novo.", "plugins.error.network": "Não foi possível acessar a origem do plugin. Verifique sua conexão de rede e tente de novo.", "plugins.error.sourceNotFound": "A origem do plugin não foi encontrada. Verifique o endereço do repositório e a branch, e se o repositório é privado.", diff --git a/ui/src/i18n/locales/zh-CN.json b/ui/src/i18n/locales/zh-CN.json index ed78eb1a0..6427577fb 100644 --- a/ui/src/i18n/locales/zh-CN.json +++ b/ui/src/i18n/locales/zh-CN.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "需要更新时,请直接在 Antigravity CLI 内操作。Skillshare 暂不以重新安装的方式更新,以免改变你在 Antigravity 里的启用设置。", "plugins.reason.grok": "请先在 Grok 安装 plugin 并确认允许使用,再到这里选择“导入已安装”。Skillshare 可以记录与移除它;安装和更新仍需在 Grok 内操作。", "plugins.error.cliMissing": "这个 CLI 没有安装,或不在运行 Skillshare 这台机器的 PATH 上;要先在那里安装才能同步 plugin。", + "plugins.error.codexMissing": "Skillshare 找不到 Codex CLI(找过:{looked})。请在运行 Skillshare 的这台机器上安装,或把 SKILLSHARE_CODEX_CLI 设为它的路径。", "plugins.error.timeout": "命令超时或被取消;请先在 Agent 内确认状态再重试。", "plugins.error.network": "无法连接 plugin 来源。请检查网络连接后重试。", "plugins.error.sourceNotFound": "找不到 plugin 来源。请确认仓库地址和分支,以及仓库是否为私有。", diff --git a/ui/src/i18n/locales/zh-TW.json b/ui/src/i18n/locales/zh-TW.json index c68968f09..407fae128 100644 --- a/ui/src/i18n/locales/zh-TW.json +++ b/ui/src/i18n/locales/zh-TW.json @@ -2278,6 +2278,7 @@ "plugins.reason.antigravity-cli": "需要更新時,請直接在 Antigravity CLI 內操作。Skillshare 暫不以重新安裝的方式更新,以免改變你在 Antigravity 裡的啟用設定。", "plugins.reason.grok": "請先在 Grok 安裝 plugin 並確認允許使用,再到這裡選「匯入已安裝」。Skillshare 可以記錄與移除它;安裝和更新仍需在 Grok 內操作。", "plugins.error.cliMissing": "這個 CLI 沒有安裝,或不在執行 Skillshare 這台機器的 PATH 上;要先在那裡安裝才能同步 plugin。", + "plugins.error.codexMissing": "Skillshare 找不到 Codex CLI(找過:{looked})。請在執行 Skillshare 的這台機器上安裝,或把 SKILLSHARE_CODEX_CLI 設成它的路徑。", "plugins.error.timeout": "指令逾時或被取消;請先在 Agent 內確認狀態再重試。", "plugins.error.network": "連不到 plugin 來源。請確認網路連線後再試一次。", "plugins.error.sourceNotFound": "找不到 plugin 來源。請確認儲存庫網址和分支,以及儲存庫是否為私人。", diff --git a/ui/src/pages/PluginsPage.test.tsx b/ui/src/pages/PluginsPage.test.tsx index 27abf788c..009936786 100644 --- a/ui/src/pages/PluginsPage.test.tsx +++ b/ui/src/pages/PluginsPage.test.tsx @@ -308,5 +308,15 @@ describe('PluginsPage', () => { expect(screen.getByRole('link', { name: 'Kimi Code · plugins.officialDocs' })).toHaveAttribute('href', 'https://www.kimi.com/code/docs/en/kimi-code-cli/customization/plugins'); expect(screen.getByRole('link', { name: 'Codex · plugins.officialDocs' })).toHaveAttribute('rel', 'noopener noreferrer'); }); + it('says where Skillshare looked for a missing Codex CLI', async () => { + vi.mocked(pluginsApi.list).mockResolvedValue({ + packages: {}, + targetDefinitions: [{ target: 'codex', label: 'Codex', project: false, operations: ['add'] }], + hosts: [{ target: 'codex', version: '', status: 'missing', installed: [], error: 'Codex CLI not found', errorKey: 'plugins.error.codexMissing', errorArgs: { looked: 'PATH, /Applications/Codex.app/Contents/Resources/codex' } }], + }); + mount(); + fireEvent.click(await screen.findByRole('button', { name: /Codex/ })); + expect(screen.getByText('plugins.hostMissing').parentElement!.parentElement!).toHaveTextContent('plugins.error.codexMissing'); + }); }); diff --git a/ui/src/pages/PluginsPage.tsx b/ui/src/pages/PluginsPage.tsx index b47b0d31c..c3df91fbf 100644 --- a/ui/src/pages/PluginsPage.tsx +++ b/ui/src/pages/PluginsPage.tsx @@ -64,7 +64,7 @@ export default function PluginsPage() { const agentLabel = (target: string) => pluginTargets[target]?.label ?? (target || t('plugins.skillshareOnly')); // The backend keys its fixed sentences; a message it assembled at runtime has no key // and is shown as it came, which is also what the CLI prints. - const message = (key: string | undefined, text: string | undefined) => (key ? t(key, undefined, text) : text ?? ''); + const message = (key: string | undefined, text: string | undefined, args?: Record) => (key ? t(key, args, text) : text ?? ''); const refresh = () => { void cache.invalidateQueries({ queryKey: queryKeys.plugins }); void cache.invalidateQueries({ queryKey: queryKeys.config }); @@ -236,7 +236,7 @@ export default function PluginsPage() { return (
{(pluginTargets[h.target]?.label ?? h.target)}{h.installed.length}
- {h.installed.length === 0 &&
{message(h.errorKey, h.error) || t('plugins.absent')}
} + {h.installed.length === 0 &&
{message(h.errorKey, h.error, h.errorArgs) || t('plugins.absent')}
} {h.installed.map((i) => (
{i.id} diff --git a/website/docs/how-to/daily-tasks/sharing-plugins.md b/website/docs/how-to/daily-tasks/sharing-plugins.md index c00c056ab..e97a8ce5f 100644 --- a/website/docs/how-to/daily-tasks/sharing-plugins.md +++ b/website/docs/how-to/daily-tasks/sharing-plugins.md @@ -32,6 +32,7 @@ skillshare plugin add ``` Claude Code, Codex, Copilot, Antigravity CLI, Grok, Pi, or OpenCode CLI must be installed **where the Skillshare backend runs**. +For Codex, the CLI inside the Codex desktop app counts; on a machine where Codex is elsewhere, set [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli). Cursor and Antigravity desktop instead receive complete files in their local plugin directories. A dashboard running inside a container cannot manage plugins installed only on the host machine. Use the local CLI, or run Skillshare beside the native clients. diff --git a/website/docs/how-to/sharing/cross-machine-sync.md b/website/docs/how-to/sharing/cross-machine-sync.md index 222144f54..965b72e5a 100644 --- a/website/docs/how-to/sharing/cross-machine-sync.md +++ b/website/docs/how-to/sharing/cross-machine-sync.md @@ -205,7 +205,7 @@ Hooks have no separate file. Copy the `hooks:` section of `config.yaml` to the o ### What stays on each machine {#per-machine} -- The native CLIs that install plugins (`claude`, `codex`, and so on) must be installed and on `PATH` where Skillshare runs. A scheduled job often has a shorter `PATH` than your terminal. +- The native CLIs that install plugins (`claude`, `codex`, and so on) must be installed and on `PATH` where Skillshare runs. A scheduled job often has a shorter `PATH` than your terminal. Codex is also found inside the Codex desktop app and in Homebrew's folders; set [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) on a machine where it is elsewhere. - Sign-ins, OAuth tokens, native trust prompts and enabled/disabled state stay in each Agent. - The values of environment variables that MCP servers reference. diff --git a/website/docs/reference/appendix/environment-variables.md b/website/docs/reference/appendix/environment-variables.md index 9ad16f7c1..4b8e18a96 100644 --- a/website/docs/reference/appendix/environment-variables.md +++ b/website/docs/reference/appendix/environment-variables.md @@ -356,6 +356,32 @@ $env:SKILLSHARE_GIT_TOKEN = "your_token" --- +## Plugins {#plugins} + +### SKILLSHARE_CODEX_CLI + +The Codex CLI that [plugin commands](/docs/reference/commands/plugin) run, on this machine only. Set it when Skillshare cannot find Codex by itself. It is read from the environment, so a `config.yaml` shared between macOS and Windows does not need a path that is wrong on the other one. + +Without it, Skillshare runs `codex` from `PATH`, then tries these places: + +| OS | Places | +|---|---| +| macOS | `/opt/homebrew/bin/codex`, `/usr/local/bin/codex`, and the CLI inside the Codex app (`ChatGPT.app` or `Codex.app` in `/Applications` or `~/Applications`) | +| Windows | `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe` from the official PowerShell installer, then the CLI the Codex app installs, `%LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe` (the newest one) | + +```bash +export SKILLSHARE_CODEX_CLI=/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex +``` + +**Windows:** +```powershell +$env:SKILLSHARE_CODEX_CLI = "C:\Tools\codex.exe" +``` + +An [account target](/docs/reference/commands/plugin#accounts) with its own `cli` keeps that `cli`. + +--- + ## Git SSL / TLS {#git-ssl--tls} These standard Git environment variables are passed through to all git operations. They are useful for self-hosted Git servers (GitLab, Gitea, etc.) with self-signed certificates or internal CAs. @@ -455,6 +481,7 @@ export GITHUB_TOKEN="ghp_your_token_here" | `GITEA_TOKEN` | Gitea git clone + Contents API auth | None | | `CNB_TOKEN` | CNB git clone + contents API auth | None | | `SKILLSHARE_GIT_TOKEN` | Generic git clone auth (fallback) | None | +| `SKILLSHARE_CODEX_CLI` | Codex CLI for plugin commands on this machine | `codex` on `PATH`, then known install places | | `GIT_SSL_CAINFO` | Custom CA certificate bundle path | System default | | `GIT_SSL_NO_VERIFY` | Disable SSL certificate verification | `false` | | `SKILLSHARE_TEST_BINARY` | Test binary path | `bin/skillshare` | diff --git a/website/docs/reference/commands/plugin.md b/website/docs/reference/commands/plugin.md index 96df97899..734298c40 100644 --- a/website/docs/reference/commands/plugin.md +++ b/website/docs/reference/commands/plugin.md @@ -336,6 +336,11 @@ never supplies native trust approval flags. cyclic, and `.git`-referencing links and special files are rejected; sources are limited to 20,000 files and 100 MiB. - Native installation is not proof of runtime activation. Restart/reload the Agent and complete authentication or hook trust in that Agent. +- Codex runs `codex` from `PATH`. When it is not there, Skillshare tries Homebrew's + `/opt/homebrew/bin` and `/usr/local/bin`, then the CLI inside the Codex desktop app + (`ChatGPT.app` or `Codex.app` on macOS, `%LOCALAPPDATA%\OpenAI\Codex\bin` on Windows). Set + [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) + on a machine where Codex is elsewhere. An account with its own `cli` is not searched. - Codex native project installation is not provided by this adapter. Sync selection still works for global Codex installations. - Codex has no update command, so an update adds the plugin again from the diff --git a/website/docs/troubleshooting/common-errors.md b/website/docs/troubleshooting/common-errors.md index cb3011dff..dbb8c6960 100644 --- a/website/docs/troubleshooting/common-errors.md +++ b/website/docs/troubleshooting/common-errors.md @@ -630,6 +630,15 @@ The same rule applies to `restore`: `restore is not supported in project mode (e 2. If it is installed, add its directory to the `PATH` of whatever starts Skillshare, such as the scheduled job's environment. 3. For an [account target](/docs/reference/commands/plugin#accounts), you can set `cli` to the executable's absolute path instead. +### `Codex CLI not found on the machine running Skillshare` {#plugin-codex-not-found} + +**Cause:** Skillshare looked for the Codex CLI on `PATH`, in the Homebrew folders, and inside the Codex desktop app, and found none. The message lists every place it looked. + +**Solutions:** + +1. Install the Codex app or the Codex CLI on that machine. +2. If Codex is somewhere else, set [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) to its path in the environment that starts Skillshare, such as the scheduled job. It stays on that machine, so a config shared with another OS is not affected. + ### `The native marketplace X is gone` {#plugin-marketplace-gone} **Cause:** The plugin was imported, so Skillshare reinstalls it from the native marketplace it came from, and that marketplace is not registered in the Agent. This is common on a second machine: the import was recorded on the first machine only. diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 84db8590c..0b6139fda 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -31,7 +31,9 @@ skillshare plugin add ``` Claude Code、Codex、Copilot、Antigravity CLI、Grok、Pi、または OpenCode CLI は、**skillshare の -バックエンドが動作している場所**にインストールされている必要があります。Cursor と Antigravity +バックエンドが動作している場所**にインストールされている必要があります。 +Codex の場合、Codex デスクトップ app に同梱の CLI も対象です。Codex が別の場所にあるマシンでは [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) を設定してください。 +Cursor と Antigravity デスクトップは代わりに、それぞれのローカルプラグインディレクトリに完全なファイルを受け取ります。 コンテナ内で動作しているダッシュボードは、ホストマシンにのみインストールされているプラグインを 管理できません。ローカルの CLI を使うか、ネイティブクライアントと並べて skillshare を実行してください。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md index 2b00ca1b5..713b14e82 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md @@ -205,7 +205,7 @@ Hooks には別ファイルがありません。`config.yaml` の `hooks:` セ ### 各マシンに残るもの {#per-machine} -- plugin をインストールする native CLI(`claude`、`codex` など)は、Skillshare を実行する環境にインストールされ、`PATH` 上にある必要があります。スケジュールされたジョブの `PATH` は、ターミナルより短いことがよくあります。 +- plugin をインストールする native CLI(`claude`、`codex` など)は、Skillshare を実行する環境にインストールされ、`PATH` 上にある必要があります。スケジュールされたジョブの `PATH` は、ターミナルより短いことがよくあります。Codex は Codex デスクトップ app と Homebrew のフォルダーからも探されます。別の場所にあるマシンでは [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) を設定してください。 - サインイン、OAuth トークン、native の信頼確認、有効/無効の状態は各 Agent に残ります。 - MCP サーバーが参照する環境変数の値。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md index 3b9b8ed67..b764e0cc9 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md @@ -384,6 +384,32 @@ $env:SKILLSHARE_GIT_TOKEN = "your_token" --- +## Plugin {#plugins} + +### SKILLSHARE_CODEX_CLI + +[plugin コマンド](/docs/reference/commands/plugin)が実行する Codex CLI を、このマシンだけで指定します。Skillshare が Codex を自分で見つけられないときに設定します。環境変数から読むため、macOS と Windows で同じ `config.yaml` を共有しても、もう一方で誤りになるパスを書く必要はありません。 + +設定しない場合、Skillshare はまず `PATH` の `codex` を実行し、次の場所を順に試します。 + +| OS | 場所 | +|---|---| +| macOS | `/opt/homebrew/bin/codex`、`/usr/local/bin/codex`、および Codex app に同梱の CLI(`/Applications` または `~/Applications` の `ChatGPT.app` または `Codex.app`) | +| Windows | 公式 PowerShell インストーラーの `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe`、次に Codex app がインストールする CLI:`%LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe`(最新のもの) | + +```bash +export SKILLSHARE_CODEX_CLI=/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex +``` + +**Windows:** +```powershell +$env:SKILLSHARE_CODEX_CLI = "C:\Tools\codex.exe" +``` + +独自の `cli` を設定した [account target](/docs/reference/commands/plugin#accounts) は、その `cli` を使い続けます。 + +--- + ## Git SSL / TLS {#git-ssl--tls} これらの標準的な Git 環境変数は、すべての git 操作にそのまま渡されます。自己署名証明書や内部 CA を @@ -487,6 +513,7 @@ export GITHUB_TOKEN="ghp_your_token_here" | `GITEA_TOKEN` | Gitea git clone + Contents API 認証 | なし | | `CNB_TOKEN` | CNB git clone + contents API 認証 | なし | | `SKILLSHARE_GIT_TOKEN` | 汎用 git clone 認証(フォールバック) | なし | +| `SKILLSHARE_CODEX_CLI` | このマシンで plugin コマンドが使う Codex CLI | `PATH` 上の `codex`、次に既知のインストール場所 | | `GIT_SSL_CAINFO` | カスタム CA 証明書バンドルのパス | システムデフォルト | | `GIT_SSL_NO_VERIFY` | SSL 証明書の検証を無効化する | `false` | | `SKILLSHARE_TEST_BINARY` | テストバイナリのパス | `bin/skillshare` | diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/plugin.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/plugin.md index 0f1e7c487..788074d45 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/plugin.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/plugin.md @@ -182,6 +182,10 @@ Copilot と Antigravity CLI のインストールは、reviewed されたロー - source にはローカル plugin エントリを含むマーケットプレイスが含まれる場合があります。外部カタログは plugin の name/path でマージされます。パスが衝突する場合は拒否され、外部エントリはそのリポジトリを直接追加するか、ネイティブにインストールしてインポートするよう指示とともに報告されます。コマンドベースの source は自動承認されません。 - 完全な source スナップショットは、plugin のスクリプト、アセット、および安全な相対 symlink(`AGENTS.md → CLAUDE.md` を含む)を保持します。絶対パス、脱出、dangling、循環、`.git` を参照する symlink や特殊ファイルは拒否されます。source は 20,000 ファイルおよび 100 MiB に制限されます。 - ネイティブインストールは、ランタイムでの有効化を証明するものではありません。Agent を再起動/再読み込みし、その Agent 内で認証または hook trust を完了してください。 +- Codex は `PATH` の `codex` を実行します。`PATH` にない場合、Skillshare は Homebrew の + `/opt/homebrew/bin` と `/usr/local/bin`、次に Codex デスクトップ app に同梱の CLI + (macOS の `ChatGPT.app` または `Codex.app`、Windows の `%LOCALAPPDATA%\OpenAI\Codex\bin`)を順に試します。Codex が別の場所にあるマシンでは + [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) を設定してください。独自の `cli` を持つ account は検索されません。 - Codex のネイティブな project インストールは、このアダプタでは提供されません。global の Codex インストールに対する sync 選択は引き続き機能します。 - Codex には update コマンドがないため、update は更新後のスナップショットからプラグインを再度 add します。add は常にプラグインを有効にするため、Codex で無効化されたプラグインはスキップされます。Import した Codex プラグインは `codex plugin marketplace upgrade NAME` で更新されます。これは Codex がその marketplace からインストールしたすべてのプラグインを再インストールするもので、Codex も起動時に同じことを行います。 - update は対応できない Target を理由を示してスキップし、そのプラグインのほかの Agent は通常どおり更新されます。スキップされた update は保留のまま残り、後の sync で処理されます。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md index 7269c4096..be03b6967 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md @@ -693,6 +693,15 @@ Agent はベース名(`.md` を除く)でマッチするため、`draft-*` 2. インストール済みなら、Skillshare を起動するもの(スケジュールされたジョブの環境など)の `PATH` にそのディレクトリを追加します。 3. [account target](/docs/reference/commands/plugin#accounts) の場合は、代わりに `cli` に実行ファイルの絶対パスを設定できます。 +### `Codex CLI not found on the machine running Skillshare` {#plugin-codex-not-found} + +**原因:** Skillshare は `PATH`、Homebrew のフォルダー、Codex デスクトップ app の中で Codex CLI を探しましたが、見つかりませんでした。メッセージには探したすべての場所が表示されます。 + +**解決策:** + +1. そのマシンに Codex app または Codex CLI をインストールします。 +2. Codex が別の場所にある場合は、Skillshare を起動する環境(スケジュールされたジョブなど)で [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) にそのパスを設定します。この設定はそのマシンだけに残るため、他の OS と共有する config には影響しません。 + ### `The native marketplace X is gone` {#plugin-marketplace-gone} **原因:** この plugin はインポートされたものなので、Skillshare は元のネイティブ marketplace から再インストールしますが、その marketplace が Agent に登録されていません。2 台目のマシンでよく起こります。インポートは最初のマシンでしか記録されていないためです。 diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 3dcdbe67d..dad67311b 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -33,6 +33,7 @@ skillshare plugin add Claude Code, Codex, Copilot, Antigravity CLI, Grok, Pi, 또는 OpenCode CLI는 **Skillshare 백엔드가 실행되는 곳**에 설치되어 있어야 합니다. +Codex는 Codex 데스크톱 app에 포함된 CLI도 인정됩니다. Codex가 다른 위치에 있는 머신에서는 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)를 설정하세요. Cursor와 Antigravity 데스크톱은 대신 로컬 플러그인 디렉터리에 완전한 파일을 받습니다. 컨테이너 안에서 실행되는 대시보드는 호스트 머신에만 설치된 플러그인을 관리할 수 없습니다. 로컬 CLI를 사용하거나, 네이티브 클라이언트 옆에서 Skillshare를 실행하세요. diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md index 28230fafd..90e1e46c2 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md @@ -205,7 +205,7 @@ Hooks에는 별도 파일이 없습니다. `config.yaml`의 `hooks:` 섹션을 ### 각 머신에 남는 것 {#per-machine} -- plugin을 설치하는 native CLI(`claude`, `codex` 등)는 Skillshare가 실행되는 곳에 설치되어 있고 `PATH`에 있어야 합니다. 예약 작업의 `PATH`는 터미널보다 짧은 경우가 많습니다. +- plugin을 설치하는 native CLI(`claude`, `codex` 등)는 Skillshare가 실행되는 곳에 설치되어 있고 `PATH`에 있어야 합니다. 예약 작업의 `PATH`는 터미널보다 짧은 경우가 많습니다. Codex는 Codex 데스크톱 app과 Homebrew 폴더에서도 찾습니다. 다른 위치에 있는 머신에서는 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)를 설정하세요. - 로그인, OAuth 토큰, native 신뢰 확인, 활성화/비활성화 상태는 각 Agent에 남습니다. - MCP 서버가 참조하는 환경 변수의 값. diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md index 693aa5c6f..0386675b2 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md @@ -356,6 +356,32 @@ $env:SKILLSHARE_GIT_TOKEN = "your_token" --- +## Plugin {#plugins} + +### SKILLSHARE_CODEX_CLI + +[plugin 명령](/docs/reference/commands/plugin)이 실행할 Codex CLI를 이 머신에서만 지정합니다. Skillshare가 Codex를 스스로 찾지 못할 때 설정하세요. 환경 변수에서 읽으므로 macOS와 Windows가 같은 `config.yaml`을 공유해도 다른 쪽에서 틀린 경로를 적을 필요가 없습니다. + +설정하지 않으면 Skillshare는 먼저 `PATH`의 `codex`를 실행하고, 그다음 아래 위치를 차례로 시도합니다. + +| OS | 위치 | +|---|---| +| macOS | `/opt/homebrew/bin/codex`, `/usr/local/bin/codex`, 그리고 Codex app에 포함된 CLI(`/Applications` 또는 `~/Applications`의 `ChatGPT.app` 또는 `Codex.app`) | +| Windows | 공식 PowerShell 설치 프로그램의 `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe`, 그다음 Codex app이 설치하는 CLI: `%LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe`(가장 최신 것) | + +```bash +export SKILLSHARE_CODEX_CLI=/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex +``` + +**Windows:** +```powershell +$env:SKILLSHARE_CODEX_CLI = "C:\Tools\codex.exe" +``` + +자체 `cli`를 설정한 [account target](/docs/reference/commands/plugin#accounts)은 그 `cli`를 계속 사용합니다. + +--- + ## Git SSL / TLS {#git-ssl--tls} 이 표준 Git 환경 변수들은 모든 git 작업에 전달됩니다. 자체 서명 인증서나 내부 CA를 사용하는 자체 호스팅 Git 서버(GitLab, Gitea 등)에서 유용합니다. @@ -455,6 +481,7 @@ export GITHUB_TOKEN="ghp_your_token_here" | `GITEA_TOKEN` | Gitea git clone + Contents API 인증 | 없음 | | `CNB_TOKEN` | CNB git clone + contents API 인증 | 없음 | | `SKILLSHARE_GIT_TOKEN` | 범용 git clone 인증 (대체 값) | 없음 | +| `SKILLSHARE_CODEX_CLI` | 이 머신에서 plugin 명령이 사용하는 Codex CLI | `PATH`의 `codex`, 그다음 알려진 설치 위치 | | `GIT_SSL_CAINFO` | 커스텀 CA 인증서 번들 경로 | 시스템 기본값 | | `GIT_SSL_NO_VERIFY` | SSL 인증서 검증 비활성화 | `false` | | `SKILLSHARE_TEST_BINARY` | 테스트 바이너리 경로 | `bin/skillshare` | diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/plugin.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/plugin.md index 9f91839a4..310534060 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/plugin.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/plugin.md @@ -181,6 +181,10 @@ Copilot과 Antigravity CLI 설치는 검토된 로컬 스냅샷을 사용합니 - Source에는 local plugin entry가 있는 marketplace가 포함될 수 있습니다. 외부 카탈로그는 plugin 이름/경로로 병합됩니다. 충돌하는 경로는 거부됩니다. 외부 entry는 저장소를 직접 추가하거나 네이티브로 설치한 후 import하라는 안내와 함께 보고됩니다. command 기반 source는 자동으로 승인되지 않습니다. - 완전한 source 스냅샷은 plugin 스크립트, asset, 그리고 안전한 상대 symlink(`AGENTS.md → CLAUDE.md` 포함)를 유지합니다. 절대 경로, 범위를 벗어나는(escaping), 끊어진(dangling), 순환(cyclic), `.git`을 참조하는 링크와 특수 파일은 거부됩니다. source는 20,000개 파일과 100MiB로 제한됩니다. - 네이티브 설치가 런타임 활성화의 증거는 아닙니다. Agent를 재시작/다시 로드하고 해당 Agent에서 인증 또는 hook trust를 완료하세요. +- Codex는 `PATH`의 `codex`를 실행합니다. `PATH`에 없으면 Skillshare는 Homebrew의 + `/opt/homebrew/bin`과 `/usr/local/bin`, 그다음 Codex 데스크톱 app에 포함된 CLI + (macOS의 `ChatGPT.app` 또는 `Codex.app`, Windows의 `%LOCALAPPDATA%\OpenAI\Codex\bin`)를 차례로 시도합니다. Codex가 다른 위치에 있는 머신에서는 + [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)를 설정하세요. 자체 `cli`를 가진 account는 검색하지 않습니다. - Codex의 네이티브 project 설치는 이 adapter에서 제공되지 않습니다. global Codex 설치에 대해서는 sync 선택이 여전히 동작합니다. - Codex에는 update 명령이 없으므로, 업데이트는 갱신된 스냅샷에서 플러그인을 다시 add합니다. add는 항상 플러그인을 활성화하므로 Codex에서 비활성화된 플러그인은 건너뜁니다. Import한 Codex 플러그인은 `codex plugin marketplace upgrade NAME`으로 업데이트되며, 이는 Codex가 해당 마켓플레이스에서 설치한 모든 플러그인을 다시 설치합니다. Codex도 시작할 때 같은 작업을 합니다. - 업데이트는 처리할 수 없는 Target을 이유와 함께 건너뛰며, 해당 플러그인의 다른 Agent는 그대로 업데이트됩니다. 건너뛴 업데이트는 대기 상태로 남아 이후 sync에서 처리됩니다. diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md index 27c7f5ba4..b547ffbc2 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md @@ -630,6 +630,15 @@ skillshare backup -p --all # 위와 동일 (agent로 좁혀짐) 2. 이미 설치되어 있다면, Skillshare를 시작하는 쪽(예: 예약 작업의 환경)의 `PATH`에 그 디렉터리를 추가하세요. 3. [account target](/docs/reference/commands/plugin#accounts)이라면 대신 `cli`에 실행 파일의 절대 경로를 설정할 수 있습니다. +### `Codex CLI not found on the machine running Skillshare` {#plugin-codex-not-found} + +**Cause:** Skillshare가 `PATH`, Homebrew 폴더, Codex 데스크톱 app 안에서 Codex CLI를 찾았지만 찾지 못했습니다. 메시지에 찾아본 모든 위치가 표시됩니다. + +**Solutions:** + +1. 해당 머신에 Codex app 또는 Codex CLI를 설치하세요. +2. Codex가 다른 곳에 있다면 Skillshare를 시작하는 환경(예: 예약 작업)에서 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)를 그 경로로 설정하세요. 이 설정은 해당 머신에만 남으므로 다른 OS와 공유하는 config에는 영향을 주지 않습니다. + ### `The native marketplace X is gone` {#plugin-marketplace-gone} **Cause:** 이 plugin은 import된 것이므로 Skillshare는 원래의 네이티브 marketplace에서 다시 설치하는데, 그 marketplace가 Agent에 등록되어 있지 않습니다. 두 번째 머신에서 흔히 발생합니다. import는 첫 번째 머신에만 기록되기 때문입니다. diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 89684823e..6b8c1f472 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -31,6 +31,7 @@ skillshare plugin add ``` Claude Code、Codex、Copilot、Antigravity CLI、Grok、Pi 或 OpenCode CLI 必须安装在**运行 Skillshare 后端的机器上**。 +Codex 的话,Codex 桌面 app 内置的 CLI 也算;Codex 装在其他位置的机器,请设置 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。 Cursor 与 Antigravity 桌面版则会在其本地 plugin 目录中直接接收完整的文件。 运行在容器内的控制台,无法管理只安装在主机上的 plugin。 请改用本地 CLI,或让 Skillshare 与这些原生客户端运行在同一台机器上。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md index 69ace2061..146a8bfef 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md @@ -205,7 +205,7 @@ Hooks 没有独立的文件。把 `config.yaml` 的 `hooks:` 部分复制到另 ### What Stays on Each Machine {#per-machine} -- 安装 plugin 用的 native CLI(`claude`、`codex` 等)必须安装在 Skillshare 运行的环境中,并且位于 `PATH` 上。计划任务的 `PATH` 通常比你的终端短。 +- 安装 plugin 用的 native CLI(`claude`、`codex` 等)必须安装在 Skillshare 运行的环境中,并且位于 `PATH` 上。计划任务的 `PATH` 通常比你的终端短。Codex 也会从 Codex 桌面 app 和 Homebrew 的文件夹里找;装在其他位置的机器,请设置 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。 - 登录状态、OAuth token、native 信任确认以及启用/禁用状态,都保留在各个 Agent 中。 - MCP server 引用的环境变量的值。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md index 5f76cc1a5..aa0d6b5bf 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md @@ -356,6 +356,32 @@ $env:SKILLSHARE_GIT_TOKEN = "your_token" --- +## Plugin {#plugins} + +### SKILLSHARE_CODEX_CLI + +[Plugin 命令](/docs/reference/commands/plugin)要运行的 Codex CLI,只对这台机器有效。Skillshare 自己找不到 Codex 时再设置。它从环境变量读取,所以 macOS 和 Windows 共用同一份 `config.yaml` 时,不需要写一个在另一台机器上错误的路径。 + +没有设置时,Skillshare 先从 `PATH` 运行 `codex`,再依次尝试这些位置: + +| 操作系统 | 位置 | +|---|---| +| macOS | `/opt/homebrew/bin/codex`、`/usr/local/bin/codex`,以及 Codex app 内置的 CLI(`/Applications` 或 `~/Applications` 里的 `ChatGPT.app` 或 `Codex.app`) | +| Windows | 官方 PowerShell 安装程序的 `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe`,再来是 Codex app 安装的 CLI:`%LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe`(取最新的一份) | + +```bash +export SKILLSHARE_CODEX_CLI=/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex +``` + +**Windows:** +```powershell +$env:SKILLSHARE_CODEX_CLI = "C:\Tools\codex.exe" +``` + +自己设置了 `cli` 的 [account target](/docs/reference/commands/plugin#accounts) 仍使用那个 `cli`。 + +--- + ## Git SSL / TLS {#git-ssl--tls} 这些标准 Git 环境变量会被传递给所有 git 操作。对于使用自签名证书或内部 CA 的自建 Git 服务器(GitLab、Gitea 等)非常有用。 @@ -455,6 +481,7 @@ export GITHUB_TOKEN="ghp_your_token_here" | `GITEA_TOKEN` | Gitea git clone + Contents API 认证 | 无 | | `CNB_TOKEN` | CNB git clone + contents API 认证 | 无 | | `SKILLSHARE_GIT_TOKEN` | 通用 git clone 认证(回退) | 无 | +| `SKILLSHARE_CODEX_CLI` | 这台机器上 plugin 命令使用的 Codex CLI | `PATH` 上的 `codex`,再找已知的安装位置 | | `GIT_SSL_CAINFO` | 自定义 CA 证书包路径 | 系统默认 | | `GIT_SSL_NO_VERIFY` | 禁用 SSL 证书验证 | `false` | | `SKILLSHARE_TEST_BINARY` | 测试二进制文件路径 | `bin/skillshare` | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/plugin.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/plugin.md index 5a5456e86..2be9fe6c3 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/plugin.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/plugin.md @@ -222,6 +222,10 @@ Skillshare 从不提供原生信任的批准 flags。 循环以及引用 `.git` 的链接和特殊文件会被拒绝;sources 限制为 20,000 个文件和 100 MiB。 - 原生安装并不能证明运行时已激活。请重启/重新加载 该 Agent,并在该 Agent 中完成认证或 hook trust。 +- Codex 会从 `PATH` 运行 `codex`。不在 `PATH` 上时,Skillshare 会依次尝试 Homebrew 的 + `/opt/homebrew/bin` 和 `/usr/local/bin`,再尝试 Codex 桌面 app 内置的 CLI + (macOS 的 `ChatGPT.app` 或 `Codex.app`、Windows 的 `%LOCALAPPDATA%\OpenAI\Codex\bin`)。Codex 装在其他位置的机器, + 请设置 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。自己设置了 `cli` 的账号不会进行搜索。 - Codex 原生 project 安装不由此适配器提供。同步选择 对全局 Codex 安装仍然有效。 - Codex 没有 update 命令,因此更新会用刷新后的快照再次 add 该 plugin。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md index 8ca900a10..1ef212aa6 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md @@ -630,6 +630,15 @@ skillshare backup -p --all # 效果相同(在 Project mode 下会收 2. 如果已经安装,把它所在的目录加入启动 Skillshare 的程序的 `PATH`,例如计划任务的环境变量。 3. 对于 [account target](/docs/reference/commands/plugin#accounts),也可以把 `cli` 设为可执行文件的绝对路径。 +### `Codex CLI not found on the machine running Skillshare` {#plugin-codex-not-found} + +**原因:** Skillshare 在 `PATH`、Homebrew 的文件夹和 Codex 桌面 app 里找 Codex CLI,都没有找到。消息会列出找过的每个位置。 + +**解决方式:** + +1. 在那台机器上安装 Codex app 或 Codex CLI。 +2. 如果 Codex 装在其他地方,在启动 Skillshare 的环境(例如计划任务)把 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) 设为它的路径。这个设置只留在那台机器,不会影响与其他操作系统共用的 config。 + ### `The native marketplace X is gone` {#plugin-marketplace-gone} **原因:** 该 plugin 是导入的,因此 Skillshare 会从它原来的原生 marketplace 重新安装,但 Agent 中没有注册该 marketplace。这在第二台机器上很常见:导入只记录在第一台机器上。 diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 54789f883..f2246ffd3 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -26,6 +26,7 @@ skillshare plugin add ``` Claude Code、Codex、Copilot、Antigravity CLI、Grok、Pi 或 OpenCode CLI 必須安裝在 **Skillshare 後端執行的所在位置**。 +Codex 的話,Codex 桌面 app 內附的 CLI 也算;Codex 裝在其他位置的機器,請設定 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。 Cursor 與 Antigravity desktop 則是直接在其本機 plugin 目錄中接收完整的檔案。 在容器中執行的 dashboard 無法管理僅安裝在主機上的 plugin。請改用本機 CLI,或將 Skillshare 與原生 client 並行執行。 diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md index 2c672bd2e..feee12796 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/sharing/cross-machine-sync.md @@ -205,7 +205,7 @@ Hooks 沒有獨立的檔案。把 `config.yaml` 的 `hooks:` 區段複製到另 ### 留在各台機器上的部分 {#per-machine} -- 安裝 plugin 用的 native CLI(`claude`、`codex` 等)必須安裝在 Skillshare 執行的環境中,並且在 `PATH` 上。排程工作的 `PATH` 通常比你的終端機短。 +- 安裝 plugin 用的 native CLI(`claude`、`codex` 等)必須安裝在 Skillshare 執行的環境中,並且在 `PATH` 上。排程工作的 `PATH` 通常比你的終端機短。Codex 也會從 Codex 桌面 app 和 Homebrew 的資料夾裡找;裝在其他位置的機器,請設定 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。 - 登入狀態、OAuth token、native 信任確認,以及啟用/停用狀態,都留在各個 Agent 裡。 - MCP server 參照的環境變數的值。 diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md index 6ed7bb089..3900f43d2 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md @@ -356,6 +356,32 @@ $env:SKILLSHARE_GIT_TOKEN = "your_token" --- +## Plugin {#plugins} + +### SKILLSHARE_CODEX_CLI + +[Plugin 指令](/docs/reference/commands/plugin)要執行的 Codex CLI,只對這台機器有效。Skillshare 自己找不到 Codex 時再設定。它從環境變數讀取,所以 macOS 和 Windows 共用同一份 `config.yaml` 時,不需要寫一個在另一台機器上錯誤的路徑。 + +沒有設定時,Skillshare 先從 `PATH` 執行 `codex`,再依序嘗試這些位置: + +| 作業系統 | 位置 | +|---|---| +| macOS | `/opt/homebrew/bin/codex`、`/usr/local/bin/codex`,以及 Codex app 內附的 CLI(`/Applications` 或 `~/Applications` 裡的 `ChatGPT.app` 或 `Codex.app`) | +| Windows | 官方 PowerShell 安裝程式的 `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe`,再來是 Codex app 安裝的 CLI:`%LOCALAPPDATA%\OpenAI\Codex\bin\\codex.exe`(取最新的一份) | + +```bash +export SKILLSHARE_CODEX_CLI=/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex +``` + +**Windows:** +```powershell +$env:SKILLSHARE_CODEX_CLI = "C:\Tools\codex.exe" +``` + +自己設了 `cli` 的 [account target](/docs/reference/commands/plugin#accounts) 仍使用那個 `cli`。 + +--- + ## Git SSL / TLS {#git-ssl--tls} 這些標準 Git 環境變數會被傳遞給所有 git 操作。對於使用自簽憑證或內部 CA 的自架 Git 伺服器(GitLab、Gitea 等)非常實用。 @@ -455,6 +481,7 @@ export GITHUB_TOKEN="ghp_your_token_here" | `GITEA_TOKEN` | Gitea git clone + Contents API 驗證 | 無 | | `CNB_TOKEN` | CNB git clone + contents API 驗證 | 無 | | `SKILLSHARE_GIT_TOKEN` | 通用 git clone 驗證(備援) | 無 | +| `SKILLSHARE_CODEX_CLI` | 這台機器上 plugin 指令使用的 Codex CLI | `PATH` 上的 `codex`,再找已知的安裝位置 | | `GIT_SSL_CAINFO` | 自訂 CA 憑證組合檔路徑 | 系統預設值 | | `GIT_SSL_NO_VERIFY` | 停用 SSL 憑證驗證 | `false` | | `SKILLSHARE_TEST_BINARY` | 測試執行檔路徑 | `bin/skillshare` | diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/plugin.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/plugin.md index bc1ff8e51..9db789e1d 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/plugin.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/plugin.md @@ -221,6 +221,10 @@ Copilot 與 Antigravity CLI 的安裝使用已檢視過的本機快照。匯入 都會被拒絕;source 上限為 20,000 個檔案與 100 MiB。 - 原生安裝不代表已在執行期啟用。請重新啟動/重新載入該 Agent,並在該 Agent 中完成驗證或 hook 信任。 +- Codex 會從 `PATH` 執行 `codex`。不在 `PATH` 上時,Skillshare 會依序嘗試 Homebrew 的 + `/opt/homebrew/bin` 和 `/usr/local/bin`,再來是 Codex 桌面 app 內附的 CLI + (macOS 的 `ChatGPT.app` 或 `Codex.app`、Windows 的 `%LOCALAPPDATA%\OpenAI\Codex\bin`)。Codex 裝在其他位置的機器, + 請設定 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli)。自己設了 `cli` 的帳號不會進行搜尋。 - 此 adapter 不提供 Codex 原生的專案安裝。全域 Codex 安裝的 sync 選擇仍然可用。 - Codex 沒有 update 指令,因此更新會以重新整理後的快照再次 add 該 plugin。add 一定會啟用它,所以在 Codex 中被停用的 plugin 會被略過。匯入的 Codex plugin 會以 `codex plugin marketplace upgrade NAME` 更新,這會重新安裝 Codex 從該 marketplace 安裝的所有 plugin,Codex 啟動時也會這麼做。 - 更新遇到無法處理的 target 時會略過並說明原因;該 plugin 的其他 Agent 仍會照常更新,被略過的更新會保留為待處理,留待之後的 sync。 diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md index b0218cdac..1340cadac 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/troubleshooting/common-errors.md @@ -630,6 +630,15 @@ skillshare backup -p --all # 效果相同(會縮小範圍到 Agent 2. 如果已經安裝,把它所在的目錄加到啟動 Skillshare 的程式的 `PATH`,例如排程工作的環境變數。 3. 若是 [account target](/docs/reference/commands/plugin#accounts),也可以把 `cli` 設成執行檔的絕對路徑。 +### `Codex CLI not found on the machine running Skillshare` {#plugin-codex-not-found} + +**原因:** Skillshare 在 `PATH`、Homebrew 的資料夾和 Codex 桌面 app 裡找 Codex CLI,都沒有找到。訊息會列出找過的每個位置。 + +**解決方法:** + +1. 在那台機器上安裝 Codex app 或 Codex CLI。 +2. 如果 Codex 裝在其他地方,在啟動 Skillshare 的環境(例如排程工作)把 [`SKILLSHARE_CODEX_CLI`](/docs/reference/appendix/environment-variables#skillshare_codex_cli) 設成它的路徑。這個設定只留在那台機器,不會影響和其他作業系統共用的 config。 + ### `The native marketplace X is gone` {#plugin-marketplace-gone} **原因:** 這個 plugin 是匯入的,所以 Skillshare 會從它原本的原生 marketplace 重新安裝,但 Agent 裡沒有註冊這個 marketplace。這在第二台機器上很常見:匯入只記錄在第一台機器上。