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
This commit is contained in:
Willie
2026-10-04 15:16:14 +08:00
committed by GitHub
parent 8c60f51b9f
commit 70cb287672
46 changed files with 522 additions and 18 deletions
+96
View File
@@ -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
}
+152
View File
@@ -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)
}
}
+6 -2
View File
@@ -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 }
+18 -2
View File
@@ -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) {
+1 -1
View File
@@ -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 {
+6
View File
@@ -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\<version>`). 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
+1 -1
View File
@@ -15,7 +15,7 @@ export interface PluginInventory {
packages: Record<string, PluginPackage>;
/** `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<string, string>; note?: string; noteKey?: string; installed: NativePlugin[]; managedMarketplaces?: string[] }[];
}
/**
* What Sync would do to one binding, '' when nothing. Without `host` (the Agents have not
+6 -4
View File
@@ -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<string, string>) => (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) => (
<RailRow key={h.target} target={h.target} label={label(h.target)} dim sub={message(h.errorKey, h.error)}
detail={<><span>{message(h.errorKey, h.error)}</span><PluginDocsLink target={h.target} label={label(h.target)} /></>} />
<RailRow key={h.target} target={h.target} label={label(h.target)} dim sub={message(h.errorKey, h.error, h.errorArgs)}
detail={<><span>{message(h.errorKey, h.error, h.errorArgs)}</span><PluginDocsLink target={h.target} label={label(h.target)} /></>} />
));
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 && (
<RailGroup label={t('plugins.hostMissing')} count={byStatus('missing').length} foot={t('plugins.hostMissingHelp')}>
{byStatus('missing').map((h) => <RailRow key={h.target} target={h.target} label={label(h.target)} dim right={<PluginDocsLink target={h.target} label={label(h.target)} />} />)}
{byStatus('missing').map((h) => h.errorArgs
? reasoned([h])[0]
: <RailRow key={h.target} target={h.target} label={label(h.target)} dim right={<PluginDocsLink target={h.target} label={label(h.target)} />} />)}
</RailGroup>
)}
</>
+1
View File
@@ -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.",
+1
View File
@@ -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.",
+1
View File
@@ -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.",
+1
View File
@@ -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": "منبع افزونه پیدا نشد. نشانی مخزن و شاخه را بررسی کنید و ببینید آیا مخزن خصوصی است.",
+1
View File
@@ -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é.",
+1
View File
@@ -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.",
+1
View File
@@ -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": "プラグインのソースが見つかりません。リポジトリのアドレスとブランチ、リポジトリが非公開でないかを確認してください。",
+1
View File
@@ -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": "플러그인 소스를 찾을 수 없습니다. 저장소 주소와 브랜치, 그리고 저장소가 비공개인지 확인하세요.",
+1
View File
@@ -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.",
+1
View File
@@ -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 来源。请确认仓库地址和分支,以及仓库是否为私有。",
+1
View File
@@ -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 來源。請確認儲存庫網址和分支,以及儲存庫是否為私人。",
+10
View File
@@ -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');
});
});
+2 -2
View File
@@ -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<string, string>) => (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 (
<div key={h.target}>
<div className="ss-gh"><span className="ss-at"><AgentIcon target={h.target} size={17} /></span><span className="font-semibold">{(pluginTargets[h.target]?.label ?? h.target)}</span><span className="ss-cnt">{h.installed.length}</span></div>
{h.installed.length === 0 && <div className="ss-r !min-h-11"><span className="text-[13px] text-ink-3">{message(h.errorKey, h.error) || t('plugins.absent')}</span></div>}
{h.installed.length === 0 && <div className="ss-r !min-h-11"><span className="text-[13px] text-ink-3">{message(h.errorKey, h.error, h.errorArgs) || t('plugins.absent')}</span></div>}
{h.installed.map((i) => (
<div key={i.id} className="ss-r !min-h-11">
<span className="min-w-0 flex-1 truncate font-mono text-[13px] font-semibold" title={i.id}>{i.id}</span>
@@ -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.
@@ -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.
@@ -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\<version>\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` |
@@ -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
@@ -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.
@@ -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 を実行してください。
@@ -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 サーバーが参照する環境変数の値。
@@ -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\<version>\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` |
@@ -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 で処理されます。
@@ -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 台目のマシンでよく起こります。インポートは最初のマシンでしか記録されていないためです。
@@ -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를 실행하세요.
@@ -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 서버가 참조하는 환경 변수의 값.
@@ -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\<version>\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` |
@@ -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에서 처리됩니다.
@@ -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는 첫 번째 머신에만 기록되기 때문입니다.
@@ -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 与这些原生客户端运行在同一台机器上。
@@ -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 引用的环境变量的值。
@@ -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\<version>\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` |
@@ -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。
@@ -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。这在第二台机器上很常见:导入只记录在第一台机器上。
@@ -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 並行執行。
@@ -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 參照的環境變數的值。
@@ -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\<version>\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` |
@@ -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。
@@ -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。這在第二台機器上很常見:匯入只記錄在第一台機器上。