mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-18 18:04:17 +00:00
feat(mcp): add Hermes Agent sync and import target (#826)
Share portable MCP definitions with Hermes through its native YAML configuration while preserving unrelated settings and managed-entry safeguards. Support explicit Hermes homes and native OAuth options without copying credential state, and expose the target consistently in the dashboard, schemas, completions and documentation. Refs #825
This commit is contained in:
@@ -0,0 +1,124 @@
|
||||
# CLI E2E Runbook: Hermes MCP
|
||||
|
||||
## Scope
|
||||
|
||||
Verify Hermes YAML destinations, OAuth options, portable environment references,
|
||||
SSE refusal, preview, conflict protection, backups and managed removal. No server
|
||||
is launched and no real credentials or OAuth login are used.
|
||||
|
||||
## Environment
|
||||
|
||||
Run inside the devcontainer with mdproof's per-runbook HOME isolation. Each step
|
||||
creates its own temporary config and Hermes home. Use the freshly built `ss`.
|
||||
|
||||
## Steps
|
||||
|
||||
### Step 1: Sync native OAuth settings without touching Hermes credentials
|
||||
|
||||
```bash
|
||||
set -eu
|
||||
MCP_CASE=$(mktemp -d "$HOME/hermes-oauth.XXXXXX")
|
||||
export SKILLSHARE_CONFIG="$MCP_CASE/config.yaml"
|
||||
export HERMES_HOME="$MCP_CASE/hermes"
|
||||
export CLAUDE_CONFIG_DIR="$MCP_CASE/claude"
|
||||
export CODEX_HOME="$MCP_CASE/codex"
|
||||
mkdir -p "$HERMES_HOME/mcp-tokens"
|
||||
printf 'API_KEY=hermes-only-test-value\n' > "$HERMES_HOME/.env"
|
||||
printf '{"access_token":"hermes-only-test-token"}\n' > "$HERMES_HOME/mcp-tokens/linear.json"
|
||||
cp "$HERMES_HOME/.env" "$MCP_CASE/env.before"
|
||||
cp "$HERMES_HOME/mcp-tokens/linear.json" "$MCP_CASE/token.before"
|
||||
cat > "$SKILLSHARE_CONFIG" <<'YAML'
|
||||
targets: {}
|
||||
mcp:
|
||||
servers:
|
||||
linear:
|
||||
url: https://mcp.linear.app/mcp
|
||||
targets: [claude, codex, hermes]
|
||||
options:
|
||||
hermes:
|
||||
auth: oauth
|
||||
YAML
|
||||
ss sync mcp --dry-run --json -g | jq -e '.blocked == false and (.changes | length) == 3' >/dev/null
|
||||
test ! -f "$HERMES_HOME/config.yaml"
|
||||
ss sync mcp -g >/dev/null
|
||||
grep -q 'auth: oauth' "$HERMES_HOME/config.yaml"
|
||||
grep -q 'https://mcp.linear.app/mcp' "$CLAUDE_CONFIG_DIR/.claude.json"
|
||||
grep -q 'https://mcp.linear.app/mcp' "$CODEX_HOME/config.toml"
|
||||
cmp "$HERMES_HOME/.env" "$MCP_CASE/env.before"
|
||||
cmp "$HERMES_HOME/mcp-tokens/linear.json" "$MCP_CASE/token.before"
|
||||
! grep -q 'hermes-only-test' "$SKILLSHARE_CONFIG"
|
||||
ss mcp list --json -g
|
||||
```
|
||||
|
||||
Expected:
|
||||
- exit_code: 0
|
||||
- jq: .blocked == false
|
||||
- jq: [.changes[].action] | all(. == "unchanged")
|
||||
|
||||
### Step 2: Import environment references and reject SSE
|
||||
|
||||
```bash
|
||||
set -eu
|
||||
MCP_CASE=$(mktemp -d "$HOME/hermes-import.XXXXXX")
|
||||
export SKILLSHARE_CONFIG="$MCP_CASE/config.yaml"
|
||||
export HERMES_HOME="$MCP_CASE/hermes"
|
||||
mkdir -p "$HERMES_HOME"
|
||||
printf 'targets: {}\n' > "$SKILLSHARE_CONFIG"
|
||||
cat > "$HERMES_HOME/config.yaml" <<'YAML'
|
||||
mcp_servers:
|
||||
local:
|
||||
command: example-mcp
|
||||
env:
|
||||
API_KEY: '${env:EXAMPLE_KEY}'
|
||||
legacy:
|
||||
url: https://example.com/sse
|
||||
transport: sse
|
||||
YAML
|
||||
ss mcp import local --from hermes --target hermes -g >/dev/null
|
||||
grep -q 'fromEnv: EXAMPLE_KEY' "$SKILLSHARE_CONFIG"
|
||||
ss mcp import --from hermes --json -g
|
||||
```
|
||||
|
||||
Expected:
|
||||
- exit_code: 1
|
||||
- jq: .[] | select(.name == "local") | .problems == [] and .server.env.API_KEY.fromEnv == "EXAMPLE_KEY"
|
||||
- jq: .[] | select(.name == "legacy") | (.problems | length) > 0
|
||||
|
||||
### Step 3: Preserve unmanaged settings through conflict, backup and removal
|
||||
|
||||
```bash
|
||||
set -eu
|
||||
MCP_CASE=$(mktemp -d "$HOME/hermes-lifecycle.XXXXXX")
|
||||
export SKILLSHARE_CONFIG="$MCP_CASE/config.yaml"
|
||||
export HERMES_HOME="$MCP_CASE/hermes"
|
||||
mkdir -p "$HERMES_HOME"
|
||||
printf 'targets: {}\n' > "$SKILLSHARE_CONFIG"
|
||||
printf '# personal settings\nmodel: example\nmcp_servers:\n personal:\n command: mine\n' > "$HERMES_HOME/config.yaml"
|
||||
ss mcp add docs --url https://example.com/mcp --target hermes -g >/dev/null
|
||||
ss sync mcp --json -g > "$MCP_CASE/applied.json"
|
||||
cp "$HERMES_HOME/config.yaml" "$MCP_CASE/synced"
|
||||
ss sync mcp -g >/dev/null
|
||||
cmp "$HERMES_HOME/config.yaml" "$MCP_CASE/synced"
|
||||
sed -i 's,https://example.com/mcp,https://changed.example/mcp,' "$HERMES_HOME/config.yaml"
|
||||
if ss sync mcp -g > "$MCP_CASE/conflict" 2>&1; then exit 1; fi
|
||||
grep -q 'https://changed.example/mcp' "$HERMES_HOME/config.yaml"
|
||||
cp "$MCP_CASE/synced" "$HERMES_HOME/config.yaml"
|
||||
BACKUP_ID=$(jq -er '.backupIds[0]' "$MCP_CASE/applied.json")
|
||||
ss mcp restore "$BACKUP_ID" --dry-run --json -g | jq -e '.blocked == false' >/dev/null
|
||||
ss mcp remove docs --sync -g >/dev/null
|
||||
grep -q '# personal settings' "$HERMES_HOME/config.yaml"
|
||||
grep -q 'model: example' "$HERMES_HOME/config.yaml"
|
||||
grep -q 'command: mine' "$HERMES_HOME/config.yaml"
|
||||
! grep -q 'https://example.com/mcp' "$HERMES_HOME/config.yaml"
|
||||
ss mcp list --json -g
|
||||
```
|
||||
|
||||
Expected:
|
||||
- exit_code: 0
|
||||
- jq: .blocked == false and .changes == []
|
||||
|
||||
## Pass Criteria
|
||||
|
||||
- All three steps pass.
|
||||
- Only named managed entries change; unrelated YAML and Hermes credential files survive.
|
||||
- OAuth settings remain Hermes-specific, references remain references, and SSE cannot import as HTTP.
|
||||
@@ -107,7 +107,7 @@ _skillshare() {
|
||||
# End project command
|
||||
|
||||
if [[ "${cmd}" == mcp && ( "${prev}" == --target || "${prev}" == --from ) ]]; then
|
||||
COMPREPLY=($(compgen -W "claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp" -- "${cur}"))
|
||||
COMPREPLY=($(compgen -W "claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp" -- "${cur}"))
|
||||
return
|
||||
fi
|
||||
if [[ "${cmd}" == target && "${prev}" == --agent ]]; then
|
||||
|
||||
@@ -87,8 +87,8 @@ complete -c skillshare -n '__fish_skillshare_using_command mcp' -l tls-key -r -F
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l http-allow-insecure -d 'serve --http: allow plain HTTP on a trusted private network'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l check -d 'serve: list skipped skills without serving'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l url -r -d 'MCP endpoint'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l target -r -a 'claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp' -d 'Receiving client'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l from -r -a 'claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp' -d 'Import client'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l target -r -a 'claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp' -d 'Receiving client'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l from -r -a 'claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp' -d 'Import client'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l file -r -F -d 'Import file'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l sync -d 'Sync after saving'
|
||||
complete -c skillshare -n '__fish_skillshare_using_command mcp' -l replace -d 'Replace an existing entry'
|
||||
|
||||
@@ -88,7 +88,7 @@ def "nu-complete skillshare mcp" [] {
|
||||
}
|
||||
|
||||
def "nu-complete skillshare mcp-target" [] {
|
||||
[claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp]
|
||||
[claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp]
|
||||
}
|
||||
|
||||
def "nu-complete skillshare account-agent" [] {
|
||||
|
||||
@@ -231,7 +231,7 @@ $_skillshareCompleter = {
|
||||
$previousIndex = $elements.Count - 1
|
||||
if ($wordToComplete -ne '') { $previousIndex-- }
|
||||
if ($cmd -eq 'mcp' -and $previousIndex -ge 0 -and $elements[$previousIndex] -in @('--target', '--from')) {
|
||||
@('claude', 'codex', 'cursor', 'vscode', 'opencode', 'kilocode', 'grok', 'antigravity', 'amp', 'claude-desktop', 'cline', 'copilot', 'factory', 'gemini', 'goose', 'junie', 'kiro', 'lmstudio', 'warp', 'windsurf', 'pi', 'omp') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
@('claude', 'codex', 'cursor', 'vscode', 'opencode', 'kilocode', 'grok', 'antigravity', 'amp', 'claude-desktop', 'cline', 'copilot', 'factory', 'gemini', 'goose', 'hermes', 'junie', 'kiro', 'lmstudio', 'warp', 'windsurf', 'pi', 'omp') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
|
||||
}
|
||||
return
|
||||
|
||||
@@ -102,8 +102,8 @@ _skillshare() {
|
||||
'--tools-allow[Only these tools, comma-separated, * matches any characters; empty clears]:tools:' \
|
||||
'--tools-deny[Never these tools, comma-separated, * matches any characters; empty clears]:tools:' \
|
||||
'--pi-options[Other Pi built-in per-server fields as JSON]:json:' \
|
||||
'--target[Receiving client]:target:(claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp)' \
|
||||
'--from[Import client]:target:(claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose junie kiro lmstudio warp windsurf pi omp)' \
|
||||
'--target[Receiving client]:target:(claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp)' \
|
||||
'--from[Import client]:target:(claude codex cursor vscode opencode kilocode grok antigravity amp claude-desktop cline copilot factory gemini goose hermes junie kiro lmstudio warp windsurf pi omp)' \
|
||||
'--url[MCP endpoint]:url:' \
|
||||
'--file[Import file]:file:_files' \
|
||||
'--sync[Sync after saving]' \
|
||||
|
||||
@@ -32,6 +32,7 @@ var clientFormats = map[string]clientFormat{
|
||||
"factory": {key: "mcpServers", localType: "stdio", remoteType: "http", urlKey: "url", refPrefix: "${", globalPath: ".factory/mcp.json", projectPath: ".factory/mcp.json"},
|
||||
"gemini": {key: "mcpServers", urlKey: "httpUrl", refPrefix: "${", globalPath: ".gemini/settings.json", projectPath: ".gemini/settings.json"},
|
||||
"goose": {key: "extensions", localType: "stdio", remoteType: "streamable_http", urlKey: "uri", globalPath: ".config/goose/config.yaml"},
|
||||
"hermes": {key: "mcp_servers", urlKey: "url", refPrefix: "${", globalPath: ".hermes/config.yaml"},
|
||||
"junie": {key: "mcpServers", urlKey: "url", globalPath: ".junie/mcp/mcp.json", projectPath: ".junie/mcp/mcp.json"},
|
||||
"kiro": {key: "mcpServers", urlKey: "url", refPrefix: "${", globalPath: ".kiro/settings/mcp.json", projectPath: ".kiro/settings/mcp.json"},
|
||||
"lmstudio": {key: "mcpServers", urlKey: "url", globalPath: ".lmstudio/mcp.json"},
|
||||
@@ -76,6 +77,20 @@ func (s *Service) additionalClientPath(target string, format clientFormat) (stri
|
||||
appdata = filepath.Join(home, "AppData", "Roaming")
|
||||
}
|
||||
switch target {
|
||||
case "hermes":
|
||||
if dir := s.ConfigDirs["hermes"]; dir != "" {
|
||||
if !filepath.IsAbs(dir) {
|
||||
return "", fmt.Errorf("HERMES_HOME must be absolute")
|
||||
}
|
||||
return filepath.Join(dir, "config.yaml"), nil
|
||||
}
|
||||
if platform == "windows" {
|
||||
base := s.ConfigDirs["localappdata"]
|
||||
if base == "" {
|
||||
base = filepath.Join(home, "AppData", "Local")
|
||||
}
|
||||
return filepath.Join(base, "hermes", "config.yaml"), nil
|
||||
}
|
||||
case "claude-desktop":
|
||||
switch platform {
|
||||
case "darwin":
|
||||
@@ -228,6 +243,9 @@ func renderAdditionalClient(target string, format clientFormat, s Server) (map[s
|
||||
}
|
||||
|
||||
func additionalManagedFields(target string) []string {
|
||||
if target == "hermes" {
|
||||
return []string{"type", "transport", "command", "args", "env", "url", "headers", "enabled", "disabled"}
|
||||
}
|
||||
if target == "pi" {
|
||||
return []string{"type", "command", "args", "env", "url", "headers", "transport", "disabled", "enabled"}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,153 @@
|
||||
package mcp
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
)
|
||||
|
||||
func TestHermesRoundTrip(t *testing.T) {
|
||||
for _, server := range []Server{
|
||||
{Command: "npx", Args: []string{"-y", "example-mcp"}, Env: map[string]Value{"API_KEY": {FromEnv: "API_KEY"}}},
|
||||
{URL: "https://example.com/mcp", BearerToken: &Value{FromEnv: "API_KEY"}},
|
||||
{URL: "https://mcp.linear.app/mcp", Options: map[string]map[string]any{"hermes": {"auth": "oauth", "oauth": map[string]any{"client_id": "public-client", "redirect_port": 27890}}}},
|
||||
} {
|
||||
entry, err := Render("hermes", server)
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if entry["type"] != nil || entry["transport"] != nil {
|
||||
t.Fatalf("Hermes infers transport from command/url: %v", entry)
|
||||
}
|
||||
n, err := ParseNative("hermes", []byte("# personal settings\nmodel: example\nmcp_servers:\n personal:\n command: mine\n"))
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
data, err := n.Edit(map[string]map[string]any{"docs": entry})
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if !strings.Contains(string(data), "# personal settings") || !strings.Contains(string(data), "command: mine") {
|
||||
t.Fatalf("lost unrelated settings: %s", data)
|
||||
}
|
||||
if DetectImportFormat(data) != "hermes" {
|
||||
t.Fatal("Hermes YAML not detected")
|
||||
}
|
||||
items, err := Import("hermes", data, "")
|
||||
if err != nil || len(items) != 2 || len(items[0].Problems) != 0 {
|
||||
t.Fatalf("import: %+v, %v", items, err)
|
||||
}
|
||||
again, err := Render("hermes", items[0].Server)
|
||||
if err != nil || piFieldHash(entry) != piFieldHash(again) {
|
||||
t.Fatalf("round trip: %v -> %v, %v", entry, again, err)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestHermesImportBoundaries(t *testing.T) {
|
||||
for _, tc := range []struct {
|
||||
entry string
|
||||
bad bool
|
||||
}{
|
||||
{"url: https://example.com/mcp\n auth: oauth", false},
|
||||
{"command: tool\n env: {API_KEY: '${env:KEY}'}", false},
|
||||
{"url: https://example.com/sse\n transport: sse", true},
|
||||
{"url: https://example.com/mcp\n transport: unknown", true},
|
||||
{"url: https://example.com/mcp\n enabled: false", true},
|
||||
{"url: https://example.com/mcp\n oauth: {client_secret: private-value}", true},
|
||||
} {
|
||||
items, err := Import("hermes", []byte("mcp_servers:\n docs:\n "+tc.entry+"\n"), "")
|
||||
if err != nil || len(items) != 1 || (len(items[0].Problems) > 0) != tc.bad {
|
||||
t.Fatalf("%s: %+v, %v", tc.entry, items, err)
|
||||
}
|
||||
}
|
||||
for _, data := range []string{"mcp_servers: {docs: &server {command: tool}, other: *server}", "mcp_servers: {}\nmcp_servers: {}", "mcp_servers: []", "mcp_servers: {}\n---\nmodel: other"} {
|
||||
if _, err := ParseNative("hermes", []byte(data)); err == nil {
|
||||
t.Fatalf("unsafe YAML accepted: %s", data)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestHermesPaths(t *testing.T) {
|
||||
s := testService(t)
|
||||
path, err := s.nativePath("hermes")
|
||||
if err != nil || path != filepath.Join(s.Home, ".hermes", "config.yaml") {
|
||||
t.Fatalf("default: %s, %v", path, err)
|
||||
}
|
||||
t.Setenv("HERMES_HOME", filepath.Join(s.Home, "profile"))
|
||||
s.ConfigDirs = ConfigDirsFromEnv()
|
||||
path, err = s.nativePath("hermes")
|
||||
if err != nil || path != filepath.Join(s.Home, "profile", "config.yaml") {
|
||||
t.Fatalf("override: %s, %v", path, err)
|
||||
}
|
||||
s.ConfigDirs["hermes"] = "relative"
|
||||
if _, err := s.nativePath("hermes"); err == nil {
|
||||
t.Fatal("relative override accepted")
|
||||
}
|
||||
s.ConfigDirs = map[string]string{"localappdata": filepath.Join(s.Home, "local")}
|
||||
s.Platform = "windows"
|
||||
path, err = s.nativePath("hermes")
|
||||
if err != nil || path != filepath.Join(s.Home, "local", "hermes", "config.yaml") {
|
||||
t.Fatalf("Windows default: %s, %v", path, err)
|
||||
}
|
||||
s.ProjectRoot = t.TempDir()
|
||||
if _, err := s.nativePath("hermes"); err == nil {
|
||||
t.Fatal("project scope accepted")
|
||||
}
|
||||
}
|
||||
|
||||
func TestHermesSyncLifecycle(t *testing.T) {
|
||||
s := testService(t)
|
||||
if err := os.WriteFile(s.ConfigPath, []byte("mcp:\n targets: [hermes]\n servers:\n docs:\n url: https://example.com/mcp\n options:\n hermes: {auth: oauth}\n"), 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
path := filepath.Join(s.Home, ".hermes", "config.yaml")
|
||||
os.MkdirAll(filepath.Dir(path), 0755)
|
||||
before := "# keep me\nmodel: example\nmcp_servers:\n personal:\n command: mine\n"
|
||||
if err := os.WriteFile(path, []byte(before), 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
plan, err := s.Preview()
|
||||
if err != nil || plan.Blocked {
|
||||
t.Fatalf("preview: %+v, %v", plan, err)
|
||||
}
|
||||
if data, _ := os.ReadFile(path); string(data) != before {
|
||||
t.Fatal("preview wrote native config")
|
||||
}
|
||||
if _, err := s.Apply(plan.Revision); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
data, _ := os.ReadFile(path)
|
||||
if !strings.Contains(string(data), "auth: oauth") || !strings.Contains(string(data), "command: mine") || !strings.Contains(string(data), "# keep me") {
|
||||
t.Fatalf("sync lost config: %s", data)
|
||||
}
|
||||
plan, err = s.Preview()
|
||||
if err != nil || len(plan.Changes) != 1 || plan.Changes[0].Action != "unchanged" {
|
||||
t.Fatalf("idempotence: %+v, %v", plan, err)
|
||||
}
|
||||
backups, err := s.Backups()
|
||||
if err != nil || len(backups) == 0 {
|
||||
t.Fatalf("backups: %+v, %v", backups, err)
|
||||
}
|
||||
if err := os.WriteFile(path, []byte(strings.ReplaceAll(string(data), "example.com/mcp", "changed.example/mcp")), 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
plan, err = s.Preview()
|
||||
if err != nil || !plan.Blocked {
|
||||
t.Fatalf("native drift not blocked: %+v, %v", plan, err)
|
||||
}
|
||||
if _, err := s.Apply(plan.Revision); err == nil {
|
||||
t.Fatal("drifted config overwritten")
|
||||
}
|
||||
if err := os.WriteFile(path, data, 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if _, err := s.Mutate(Mutation{Name: "docs", Remove: true}, "", true); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
data, _ = os.ReadFile(path)
|
||||
if strings.Contains(string(data), "example.com/mcp") || !strings.Contains(string(data), "command: mine") {
|
||||
t.Fatalf("removal touched unmanaged config: %s", data)
|
||||
}
|
||||
}
|
||||
+19
-4
@@ -59,8 +59,12 @@ func detectJSONFormat(data []byte) string {
|
||||
v, err := hujson.Parse(data)
|
||||
if err != nil {
|
||||
var doc yaml.Node
|
||||
if parseYAML(data, &doc) == nil && field(&doc, "extensions") != nil {
|
||||
return "goose"
|
||||
if parseYAML(data, &doc) == nil {
|
||||
for _, target := range []string{"goose", "hermes"} {
|
||||
if field(&doc, nativeKey(target)) != nil {
|
||||
return target
|
||||
}
|
||||
}
|
||||
}
|
||||
return "claude" // ParseNative reports the syntax error.
|
||||
}
|
||||
@@ -116,7 +120,7 @@ func detectJSONFormat(data []byte) string {
|
||||
if kind == "local" && document["command"] != nil {
|
||||
return "copilot"
|
||||
}
|
||||
for _, target := range []string{"goose", "amp", "claude", "vscode", "opencode"} {
|
||||
for _, target := range []string{"goose", "hermes", "amp", "claude", "vscode", "opencode"} {
|
||||
if _, ok := document[nativeKey(target)]; ok {
|
||||
return target
|
||||
}
|
||||
@@ -162,7 +166,7 @@ func importNative(target string, data []byte, singleName string, adapter, piProj
|
||||
native.Entries[name] = entry.(map[string]any)
|
||||
}
|
||||
}
|
||||
if len(native.Entries) == 0 && singleName != "" && !isTOMLTarget(target) && target != "goose" {
|
||||
if len(native.Entries) == 0 && singleName != "" && !isTOMLTarget(target) && !isYAMLTarget(target) {
|
||||
v := native.json.Clone()
|
||||
v.Standardize()
|
||||
var entry PiOptions
|
||||
@@ -251,6 +255,17 @@ func importNative(target string, data []byte, singleName string, adapter, piProj
|
||||
}
|
||||
}
|
||||
allowed := map[string]bool{"type": true, "command": true, "args": true, "url": true, "env": true, "headers": true}
|
||||
if target == "hermes" {
|
||||
for _, key := range []string{"auth", "oauth"} {
|
||||
if value, set := entry[key]; set {
|
||||
allowed[key] = true
|
||||
if c.Server.Options == nil {
|
||||
c.Server.Options = map[string]map[string]any{"hermes": {}}
|
||||
}
|
||||
c.Server.Options["hermes"][key] = value
|
||||
}
|
||||
}
|
||||
}
|
||||
if target == "codex" {
|
||||
allowed = map[string]bool{"command": true, "args": true, "url": true, "env": true, "env_vars": true, "http_headers": true, "env_http_headers": true, "bearer_token_env_var": true}
|
||||
}
|
||||
|
||||
@@ -17,6 +17,14 @@ func normalizeClientImport(target string, entry map[string]any, c *Candidate) {
|
||||
if !ok {
|
||||
return
|
||||
}
|
||||
if target == "hermes" {
|
||||
if transport, set := entry["transport"]; set {
|
||||
if transport != "http" && transport != "streamable-http" {
|
||||
c.Problems = append(c.Problems, "Hermes transport is not supported; only stdio and Streamable HTTP can be imported")
|
||||
}
|
||||
delete(entry, "transport")
|
||||
}
|
||||
}
|
||||
if target == "gemini" && entry["url"] != nil {
|
||||
c.Problems = append(c.Problems, "Gemini url uses SSE; only httpUrl (Streamable HTTP) is supported")
|
||||
}
|
||||
|
||||
@@ -291,7 +291,7 @@ var envName = regexp.MustCompile(`^[A-Za-z_][A-Za-z0-9_]*$`)
|
||||
var serverName = regexp.MustCompile(`^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$`)
|
||||
|
||||
// Targets are MCP clients, independently of installed skill targets.
|
||||
var Targets = []string{"claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "junie", "kiro", "lmstudio", "warp", "windsurf", "pi", "omp"}
|
||||
var Targets = []string{"claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "hermes", "junie", "kiro", "lmstudio", "warp", "windsurf", "pi", "omp"}
|
||||
|
||||
func hasInterpolation(value string) bool {
|
||||
return strings.Contains(value, "${") || strings.Contains(value, "{env:") || strings.Contains(value, "{file:")
|
||||
|
||||
@@ -42,6 +42,8 @@ func claudeProject(root string) string { return "/projects/" + pointerKey(root)
|
||||
|
||||
func isTOMLTarget(target string) bool { return target == "codex" || target == "grok" }
|
||||
|
||||
func isYAMLTarget(target string) bool { return target == "goose" || target == "hermes" }
|
||||
|
||||
func nativeKey(target string) string {
|
||||
if format, ok := clientFormats[target]; ok {
|
||||
return format.key
|
||||
@@ -98,7 +100,7 @@ func ParseNative(target string, data []byte) (*Native, error) {
|
||||
}
|
||||
n := &Native{Target: target, data: data, Entries: map[string]map[string]any{}}
|
||||
var document map[string]any
|
||||
if target == "goose" {
|
||||
if isYAMLTarget(target) {
|
||||
if len(data) == 0 {
|
||||
data = []byte("{}\n")
|
||||
n.data = data
|
||||
@@ -110,7 +112,7 @@ func ParseNative(target string, data []byte) (*Native, error) {
|
||||
return nil, err
|
||||
}
|
||||
if err := n.yaml.Decode(&document); err != nil {
|
||||
return nil, fmt.Errorf("invalid Goose YAML configuration")
|
||||
return nil, fmt.Errorf("invalid %s YAML configuration", target)
|
||||
}
|
||||
} else if isTOMLTarget(target) {
|
||||
if err := toml.Unmarshal(data, &document); err != nil {
|
||||
@@ -191,7 +193,7 @@ func (n *Native) Edit(changes map[string]map[string]any) ([]byte, error) {
|
||||
if isTOMLTarget(n.Target) {
|
||||
return n.editTOML(changes)
|
||||
}
|
||||
if n.Target == "goose" {
|
||||
if isYAMLTarget(n.Target) {
|
||||
return n.editYAML(changes)
|
||||
}
|
||||
v := n.json.Clone()
|
||||
@@ -286,7 +288,7 @@ func (n *Native) editOffList(v hujson.Value, root string, changes map[string]map
|
||||
// entries out, or a minifier's work. An entry someone formatted by hand has line breaks
|
||||
// and is left alone.
|
||||
func (n *Native) cramped(name string) bool {
|
||||
if isTOMLTarget(n.Target) || n.Target == "goose" || n.json.Value == nil || strings.HasPrefix(n.Target, claudeOffPrefix) {
|
||||
if isTOMLTarget(n.Target) || isYAMLTarget(n.Target) || n.json.Value == nil || strings.HasPrefix(n.Target, claudeOffPrefix) {
|
||||
return false
|
||||
}
|
||||
v := n.json.Find("/" + nativeKey(n.Target) + "/" + pointerKey(name))
|
||||
|
||||
@@ -11,7 +11,7 @@ import (
|
||||
// instead of flattening those relationships when editing an owned extension.
|
||||
func plainYAML(node *yaml.Node) error {
|
||||
if node.Kind == yaml.AliasNode || node.Tag == "!!merge" {
|
||||
return fmt.Errorf("Goose MCP configuration must not use YAML aliases or merges")
|
||||
return fmt.Errorf("MCP YAML configuration must not use aliases or merges")
|
||||
}
|
||||
for _, child := range node.Content {
|
||||
if err := plainYAML(child); err != nil {
|
||||
@@ -27,12 +27,13 @@ func (n *Native) editYAML(changes map[string]map[string]any) ([]byte, error) {
|
||||
if err := parseYAML(n.data, &doc); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if field(&doc, "extensions") == nil {
|
||||
if err := put(&doc, "extensions", map[string]any{}); err != nil {
|
||||
key := nativeKey(n.Target)
|
||||
if field(&doc, key) == nil {
|
||||
if err := put(&doc, key, map[string]any{}); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
}
|
||||
extensions := field(&doc, "extensions")
|
||||
extensions := field(&doc, key)
|
||||
for _, name := range sortedKeys(changes) {
|
||||
entry := changes[name]
|
||||
if entry != nil {
|
||||
|
||||
@@ -289,10 +289,10 @@ func DetectedAccounts(accounts map[string]Account) []string {
|
||||
// ConfigDirsFromEnv reads the Agent directory overrides Agents themselves honor.
|
||||
func ConfigDirsFromEnv() map[string]string {
|
||||
dirs := map[string]string{}
|
||||
for key, env := range map[string]string{"pi": "PI_CODING_AGENT_DIR", "omp": "PI_CODING_AGENT_DIR", "codex": "CODEX_HOME", "claude": "CLAUDE_CONFIG_DIR", "opencode": "OPENCODE_CONFIG_DIR", "grok": "GROK_HOME", "copilot": "COPILOT_HOME", "cline": "CLINE_DIR", "cline-data": "CLINE_DATA_DIR", "cline-mcp": "CLINE_MCP_SETTINGS_PATH", "xdg": "XDG_CONFIG_HOME", "appdata": "APPDATA"} {
|
||||
for key, env := range map[string]string{"pi": "PI_CODING_AGENT_DIR", "omp": "PI_CODING_AGENT_DIR", "codex": "CODEX_HOME", "claude": "CLAUDE_CONFIG_DIR", "opencode": "OPENCODE_CONFIG_DIR", "grok": "GROK_HOME", "copilot": "COPILOT_HOME", "hermes": "HERMES_HOME", "localappdata": "LOCALAPPDATA", "cline": "CLINE_DIR", "cline-data": "CLINE_DATA_DIR", "cline-mcp": "CLINE_MCP_SETTINGS_PATH", "xdg": "XDG_CONFIG_HOME", "appdata": "APPDATA"} {
|
||||
value := strings.TrimSpace(os.Getenv(env))
|
||||
// The XDG spec says a relative XDG_CONFIG_HOME is invalid and must be ignored.
|
||||
if value == "" || (key == "xdg" || key == "appdata") && !filepath.IsAbs(value) {
|
||||
if value == "" || (key == "xdg" || key == "appdata" || key == "localappdata") && !filepath.IsAbs(value) {
|
||||
continue
|
||||
}
|
||||
dirs[key] = value
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
"$defs": {
|
||||
"optionScalar": {"type": ["string", "number", "boolean"]},
|
||||
"optionValue": {"description": "What every native format writes back unchanged: no null, and a list holds only scalars.", "anyOf": [{"$ref": "#/$defs/optionScalar"}, {"type": "array", "items": {"$ref": "#/$defs/optionScalar"}}, {"type": "object", "additionalProperties": {"$ref": "#/$defs/optionValue"}}]},
|
||||
"targets": {"type": "array", "uniqueItems": true, "items": {"anyOf": [{"enum": ["claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "junie", "kiro", "lmstudio", "warp", "windsurf", "pi", "omp"]}, {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "description": "A target that is another account of an Agent, declared under targets with agent and config_dir. Global config only."}]}},
|
||||
"targets": {"type": "array", "uniqueItems": true, "items": {"anyOf": [{"enum": ["claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "hermes", "junie", "kiro", "lmstudio", "warp", "windsurf", "pi", "omp"]}, {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "description": "A target that is another account of an Agent, declared under targets with agent and config_dir. Global config only."}]}},
|
||||
"directTools": {
|
||||
"deprecated": true,
|
||||
"description": "Converted since 0.23.0: pi-mcp-adapter's setting becomes Pi's exposure (true: direct, \"search\": deferred) in piOptions, or piOptions.toolExposure for a list of tool names; a default under mcp or a project applies to each server that reaches Pi. Saving the config drops it.",
|
||||
@@ -95,7 +95,7 @@
|
||||
"directTools": {"$ref": "#/$defs/directTools"},
|
||||
"tools": {"$ref": "#/$defs/tools"},
|
||||
"piOptions": {"type": "object", "description": "Pi built-in per-server options. Known built-in fields are validated; unknown fields are preserved. pi-mcp-adapter-only fields are refused: set tool lists in tools; exposure and toolExposure cannot be combined with tools."},
|
||||
"options": {"type": "object", "propertyNames": {"enum": ["claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "junie", "kiro", "lmstudio", "warp", "windsurf", "omp"]}, "additionalProperties": {"type": "object", "additionalProperties": {"$ref": "#/$defs/optionValue"}}, "description": "Native per-server fields of other Agents, keyed by Agent, written into that Agent's entry as given, such as codex: {default_tools_approval_mode: approve} or claude: {timeout: 600000}. Fields Skillshare writes from the server's own settings are refused; values are strings, numbers, booleans, lists of those, or mappings of them. Credentials must be a whole-value environment reference in the Agent's own syntax, such as ${VAR} or {env:VAR}, never plain text; options of Codex, Antigravity, Claude Desktop, Goose, Junie, LM Studio and Warp, which read no references there, cannot hold one. Set Pi's fields in piOptions. Sync removes an option it wrote once the source drops it."},
|
||||
"options": {"type": "object", "propertyNames": {"enum": ["claude", "codex", "cursor", "vscode", "opencode", "kilocode", "grok", "antigravity", "amp", "claude-desktop", "cline", "copilot", "factory", "gemini", "goose", "hermes", "junie", "kiro", "lmstudio", "warp", "windsurf", "omp"]}, "additionalProperties": {"type": "object", "additionalProperties": {"$ref": "#/$defs/optionValue"}}, "description": "Native per-server fields of other Agents, keyed by Agent, written into that Agent's entry as given, such as codex: {default_tools_approval_mode: approve} or claude: {timeout: 600000}. Fields Skillshare writes from the server's own settings are refused; values are strings, numbers, booleans, lists of those, or mappings of them. Credentials must be a whole-value environment reference in the Agent's own syntax, such as ${VAR} or {env:VAR}, never plain text; options of Codex, Antigravity, Claude Desktop, Goose, Junie, LM Studio and Warp, which read no references there, cannot hold one. Set Pi's fields in piOptions. Sync removes an option it wrote once the source drops it."},
|
||||
"piOptionsPrune": {"type": "boolean", "deprecated": true, "description": "Ignored since 0.23.0: sync always removes Pi options Skillshare wrote that are unchanged. Saving the config drops it."},
|
||||
"disabled": {"const": true, "description": "Project mode only: turn off a server that the Agent's global config defines. Supported by claude, opencode and kilocode."}
|
||||
},
|
||||
|
||||
@@ -128,7 +128,7 @@ mcp:
|
||||
| `disabled` | `true` only, no connection fields, and a project must be in scope: project mode, or a root under `mcp.projects`. See [Turn off a global server in one project](#turn-off-a-global-server-in-one-project) |
|
||||
|
||||
Client IDs: `claude`, `codex`, `cursor`, `vscode`, `opencode`, `kilocode`, `grok`,
|
||||
`antigravity`, `amp`, `claude-desktop`, `cline`, `copilot`, `factory`, `gemini`, `goose`,
|
||||
`antigravity`, `amp`, `claude-desktop`, `cline`, `copilot`, `factory`, `gemini`, `goose`, `hermes`,
|
||||
`junie`, `kiro`, `lmstudio`, `warp`, `windsurf`, `pi`, `omp`. `--target` and `--from` also take `agy` and
|
||||
`antigravity-cli` as `antigravity`. Scope and transport support vary by
|
||||
client; the website's MCP command reference lists every native destination and limit.
|
||||
@@ -261,6 +261,26 @@ setups usually go wrong.
|
||||
so a server using `fromEnv` or `bearerToken` is refused for Kilo in project mode.
|
||||
Define it in global mode.
|
||||
|
||||
### Hermes Agent
|
||||
|
||||
- MCP target/import ID: `hermes`; global only. Writes named `mcp_servers` entries
|
||||
in `~/.hermes/config.yaml` (`%LOCALAPPDATA%/hermes/config.yaml` on Windows).
|
||||
- An absolute `HERMES_HOME` selects another home/profile. Without it, use the
|
||||
default profile; active-profile files, `--profile` and `HERMES_DATA_DIR_SUFFIX`
|
||||
are not followed. No project MCP destination.
|
||||
- Stdio and Streamable HTTP use native `command`/`args`/`env` and `url`/`headers`.
|
||||
`fromEnv` writes `${VAR}`; env/header import also accepts `${env:VAR}`.
|
||||
SSE imports are blocked. Other unmapped native fields produce import warnings.
|
||||
- Set `options.hermes: {auth: oauth}` for OAuth. Import preserves `auth` and
|
||||
`oauth` in `options.hermes`, rejecting literal credentials there; use
|
||||
whole-value `${VAR}` references. Hermes owns login, `.env`, tokens and refresh:
|
||||
complete `hermes mcp login NAME` in the same profile. Sync never copies these
|
||||
files. Portable tool-policy gaps are reported; native filters can use options.
|
||||
- YAML edits keep unrelated settings, comments and unmanaged servers, but may
|
||||
reformat the document. Aliases, merges, duplicate keys and multiple documents
|
||||
block editing, as with Goose. Preview, ownership, backups and removal use the
|
||||
shared MCP workflow.
|
||||
|
||||
### Pi
|
||||
|
||||
Pi >= 0.99.0 has built-in MCP, and it is the only Pi format Skillshare writes. The
|
||||
|
||||
@@ -119,6 +119,12 @@ func TestCompletion_MCPCheck_AllShells(t *testing.T) {
|
||||
result.AssertOutputContains(t, "no-dns")
|
||||
result.AssertOutputContains(t, "live")
|
||||
result.AssertOutputContains(t, "accept-tools")
|
||||
// Match the MCP client list, rather than Hermes's independent skill/plugin target lists.
|
||||
if shell == "powershell" {
|
||||
result.AssertOutputContains(t, "'goose', 'hermes', 'junie'")
|
||||
} else {
|
||||
result.AssertOutputContains(t, "goose hermes junie")
|
||||
}
|
||||
result.AssertOutputContains(t, "timeout")
|
||||
for _, flag := range []string{"tools-allow", "tools-deny", "http-allow-insecure"} {
|
||||
result.AssertOutputContains(t, flag)
|
||||
|
||||
@@ -0,0 +1,70 @@
|
||||
//go:build !online
|
||||
|
||||
package integration
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"skillshare/internal/testutil"
|
||||
)
|
||||
|
||||
func TestMCPHermesOAuthImportAndSync(t *testing.T) {
|
||||
sb := testutil.NewSandbox(t)
|
||||
defer sb.Cleanup()
|
||||
sb.WriteConfig("targets: {}\n")
|
||||
profile := filepath.Join(sb.Home, "hermes-profile")
|
||||
if err := os.MkdirAll(profile, 0755); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
path := filepath.Join(profile, "config.yaml")
|
||||
before := "# personal settings\nmodel: example\nmcp_servers:\n linear:\n url: https://mcp.linear.app/mcp\n auth: oauth\n personal:\n command: mine\n"
|
||||
if err := os.WriteFile(path, []byte(before), 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if err := os.MkdirAll(filepath.Join(profile, "mcp-tokens"), 0755); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
privateFiles := map[string]string{
|
||||
filepath.Join(profile, ".env"): "API_KEY=hermes-only-test-value\n",
|
||||
filepath.Join(profile, "mcp-tokens", "linear.json"): `{"access_token":"hermes-only-test-token"}`,
|
||||
}
|
||||
for file, content := range privateFiles {
|
||||
if err := os.WriteFile(file, []byte(content), 0600); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
}
|
||||
env := map[string]string{"HERMES_HOME": profile}
|
||||
sb.RunCLIEnv(env, "mcp", "import", "--from", "hermes", "linear", "--target", "claude", "--target", "codex", "--target", "hermes", "-g").AssertSuccess(t)
|
||||
sb.RunCLIEnv(env, "sync", "mcp", "--dry-run", "-g").AssertSuccess(t)
|
||||
if sb.ReadFile(path) != before {
|
||||
t.Fatal("preview rewrote native config")
|
||||
}
|
||||
sb.RunCLIEnv(env, "sync", "mcp", "-g").AssertSuccess(t)
|
||||
for _, file := range []string{filepath.Join(sb.Home, ".claude.json"), filepath.Join(sb.Home, ".codex", "config.toml"), path} {
|
||||
if !strings.Contains(sb.ReadFile(file), "https://mcp.linear.app/mcp") {
|
||||
t.Fatalf("missing server in %s", file)
|
||||
}
|
||||
}
|
||||
if !strings.Contains(sb.ReadFile(path), "auth: oauth") {
|
||||
t.Fatal("Hermes OAuth setting lost")
|
||||
}
|
||||
sb.RunCLIEnv(env, "mcp", "remove", "linear", "--sync", "-g").AssertSuccess(t)
|
||||
after := sb.ReadFile(path)
|
||||
if strings.Contains(after, "mcp.linear.app") || !strings.Contains(after, "command: mine") || !strings.Contains(after, "# personal settings") {
|
||||
t.Fatalf("removal did not preserve unmanaged config: %s", after)
|
||||
}
|
||||
if _, err := os.Stat(filepath.Join(sb.Home, ".hermes", "config.yaml")); !os.IsNotExist(err) {
|
||||
t.Fatal("HERMES_HOME wrote the default profile")
|
||||
}
|
||||
for file, content := range privateFiles {
|
||||
if sb.ReadFile(file) != content {
|
||||
t.Fatalf("Hermes credentials changed: %s", file)
|
||||
}
|
||||
}
|
||||
if strings.Contains(sb.ReadFile(sb.ConfigPath), "hermes-only-test") {
|
||||
t.Fatal("Hermes credentials copied into source")
|
||||
}
|
||||
}
|
||||
@@ -73,7 +73,7 @@ func TestMCPInlineLifecycle(t *testing.T) {
|
||||
}
|
||||
|
||||
func TestMCPAdditionalClients(t *testing.T) {
|
||||
for _, target := range []string{"opencode", "grok", "antigravity", "amp", "cline", "copilot", "factory", "gemini", "goose", "junie", "kiro", "lmstudio", "warp", "windsurf", "omp"} {
|
||||
for _, target := range []string{"opencode", "grok", "antigravity", "amp", "cline", "copilot", "factory", "gemini", "goose", "hermes", "junie", "kiro", "lmstudio", "warp", "windsurf", "omp"} {
|
||||
t.Run(target, func(t *testing.T) {
|
||||
sb := testutil.NewSandbox(t)
|
||||
defer sb.Cleanup()
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
import { apiFetch } from './client';
|
||||
|
||||
export const mcpTargets = ['claude', 'codex', 'cursor', 'vscode', 'opencode', 'kilocode', 'grok', 'antigravity', 'amp', 'claude-desktop', 'cline', 'copilot', 'factory', 'gemini', 'goose', 'junie', 'kiro', 'lmstudio', 'warp', 'windsurf', 'pi', 'omp'] as const;
|
||||
export const mcpTargets = ['claude', 'codex', 'cursor', 'vscode', 'opencode', 'kilocode', 'grok', 'antigravity', 'amp', 'claude-desktop', 'cline', 'copilot', 'factory', 'gemini', 'goose', 'hermes', 'junie', 'kiro', 'lmstudio', 'warp', 'windsurf', 'pi', 'omp'] as const;
|
||||
export type MCPValue = string | { fromEnv: string };
|
||||
/** A scope's defaults. A save replaces them, so a value left out is cleared. */
|
||||
export interface MCPSettings { targets?: string[] }
|
||||
|
||||
@@ -29,7 +29,7 @@ const SNIPPET_PLACEHOLDER = `{
|
||||
}
|
||||
}`;
|
||||
const TOML = /^\s*\[mcp_servers[.\]]/m;
|
||||
const GOOSE_YAML = /^extensions\s*:/m;
|
||||
const MCP_YAML = /^(?:extensions|mcp_servers)\s*:/m;
|
||||
|
||||
/** Pretty-printed JSON, or null when the text isn't plain JSON (comments and trailing commas still import fine). */
|
||||
function formatJSON(text: string) {
|
||||
@@ -137,7 +137,7 @@ function ImportSourceEditor({ content, pasted, tomlFrom, query, saving, onConten
|
||||
const t = useT();
|
||||
const { toast } = useToast();
|
||||
const tomlInput = TOML.test(content);
|
||||
const yamlInput = GOOSE_YAML.test(content);
|
||||
const yamlInput = MCP_YAML.test(content);
|
||||
const formatted = tomlInput || !content.trim() ? null : formatJSON(content);
|
||||
return (
|
||||
<>
|
||||
@@ -193,7 +193,7 @@ function SnippetStatus({ pasted, tomlFrom, query, onTomlFrom }: { pasted: string
|
||||
{query.error ? (
|
||||
<span className="ss-st bad wrap min-w-0">{describeError(t, query.error.message)}</span>
|
||||
) : query.data ? (
|
||||
<span className="ss-st ok">{t(plural('mcp.detected', candidates.length), { format: toml ? 'TOML' : GOOSE_YAML.test(pasted) ? 'YAML' : 'JSON', count: candidates.length })}</span>
|
||||
<span className="ss-st ok">{t(plural('mcp.detected', candidates.length), { format: toml ? 'TOML' : MCP_YAML.test(pasted) ? 'YAML' : 'JSON', count: candidates.length })}</span>
|
||||
) : (
|
||||
<span className="text-ink-3">{t('mcp.reading')}</span>
|
||||
)}
|
||||
@@ -249,7 +249,7 @@ function ImportCandidateList({ tab, candidates, selection, query, saving, onPick
|
||||
<span className="flex min-w-0 flex-1 flex-col gap-px">
|
||||
<span className="font-mono text-[13px] font-semibold">{c.name}</span>
|
||||
<span className="truncate font-mono text-xs text-ink-3" title={describeEndpoint(c.server)}>{describeEndpoint(c.server)}</span>
|
||||
{[...new Set(c.problems)].map((p) => <span key={p} className="text-xs text-bad">{p}</span>)}
|
||||
{[...new Set(c.problems)].map((p) => <span key={p} className="text-xs text-bad">{describeError(t, p)}</span>)}
|
||||
{[...new Set(c.warnings)].map((w) => <span key={w} className="text-xs text-warn">{w}</span>)}
|
||||
</span>
|
||||
{exists(c) ? (
|
||||
|
||||
@@ -26,6 +26,10 @@ describe('MCP view helpers', () => {
|
||||
expect(mcpTargets).toContain('antigravity');
|
||||
expect(targetLabel('antigravity')).toBe('Antigravity');
|
||||
});
|
||||
|
||||
it('offers Hermes as a receiving and import target for its native YAML file', () => {
|
||||
expect(mcpTargets).toContain('hermes');
|
||||
});
|
||||
it('keeps source servers and adds rows for entries only the plan removes', () => {
|
||||
const plan: MCPPlan = { revision: 'r', sourcePath: '/c.yaml', blocked: false, changes: [change('docs', 'claude', 'unchanged'), change('old', 'codex', 'remove')] };
|
||||
const rows = buildMatrix({ docs: { url: 'https://docs.example/mcp' } }, plan);
|
||||
@@ -79,6 +83,10 @@ describe('MCP view helpers', () => {
|
||||
const t = (key: string) => `[${key}]`;
|
||||
expect(describeError(t, 'invalid JSON/JSONC; target was not changed')).toBe('[mcp.importError.json]');
|
||||
expect(describeError(t, 'invalid TOML; target was not changed')).toBe('[mcp.importError.toml]');
|
||||
expect(describeError(t, 'invalid hermes YAML configuration')).toBe('[mcp.importError.yaml]');
|
||||
expect(describeError(t, 'MCP YAML configuration must not use aliases or merges')).toBe('[mcp.importError.yamlAliases]');
|
||||
expect(describeError(t, 'HERMES_HOME must be absolute')).toBe('[mcp.hermesHomeAbsolute]');
|
||||
expect(describeError(t, 'Hermes transport is not supported; only stdio and Streamable HTTP can be imported')).toBe('[mcp.hermesTransportUnsupported]');
|
||||
expect(describeError(t, 'no MCP entries found; select the matching client format')).toBe('[mcp.importError.noEntries]');
|
||||
expect(describeError(t, 'something else')).toBe('something else');
|
||||
});
|
||||
|
||||
@@ -115,6 +115,10 @@ export const describeMessage = (t: (key: string) => string, message = '') => {
|
||||
// What the server says about a snippet or file it cannot read. It words them for a sync,
|
||||
// where "target was not changed" matters; a paste has no target to change.
|
||||
const importErrorKeys: Record<string, string> = {
|
||||
'invalid hermes YAML configuration': 'mcp.importError.yaml',
|
||||
'MCP YAML configuration must not use aliases or merges': 'mcp.importError.yamlAliases',
|
||||
'HERMES_HOME must be absolute': 'mcp.hermesHomeAbsolute',
|
||||
'Hermes transport is not supported; only stdio and Streamable HTTP can be imported': 'mcp.hermesTransportUnsupported',
|
||||
'invalid JSON/JSONC; target was not changed': 'mcp.importError.json',
|
||||
'invalid server JSON': 'mcp.importError.json',
|
||||
'invalid TOML; target was not changed': 'mcp.importError.toml',
|
||||
@@ -357,7 +361,7 @@ export const reachOf = (server: MCPServer, defaults: string[]) =>
|
||||
|
||||
/** Display names for the MCP clients, as in their own docs. */
|
||||
export const targetLabel = (target: string) =>
|
||||
({ pi: 'Pi', omp: 'Oh My Pi', claude: 'Claude', codex: 'Codex', cursor: 'Cursor', vscode: 'VS Code', opencode: 'OpenCode', kilocode: 'Kilo Code', grok: 'Grok', antigravity: 'Antigravity', amp: 'Amp', 'claude-desktop': 'Claude Desktop', cline: 'Cline', commandcode: 'Command Code', copilot: 'Copilot CLI', droid: 'Droid', factory: 'Factory', gemini: 'Gemini CLI', goose: 'Goose', junie: 'Junie', kiro: 'Kiro', lmstudio: 'LM Studio', warp: 'Warp', windsurf: 'Windsurf', zed: 'Zed' })[target] ?? target;
|
||||
({ pi: 'Pi', omp: 'Oh My Pi', claude: 'Claude', codex: 'Codex', cursor: 'Cursor', vscode: 'VS Code', opencode: 'OpenCode', kilocode: 'Kilo Code', grok: 'Grok', antigravity: 'Antigravity', amp: 'Amp', 'claude-desktop': 'Claude Desktop', cline: 'Cline', commandcode: 'Command Code', copilot: 'Copilot CLI', droid: 'Droid', factory: 'Factory', gemini: 'Gemini CLI', goose: 'Goose', hermes: 'Hermes Agent', junie: 'Junie', kiro: 'Kiro', lmstudio: 'LM Studio', warp: 'Warp', windsurf: 'Windsurf', zed: 'Zed' })[target] ?? target;
|
||||
|
||||
/** Splits a command line into words, honouring single and double quotes. */
|
||||
// ponytail: no backslash escapes; a word holding both quote kinds needs the YAML config.
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Entfernen",
|
||||
"mcp.saveSync": "Speichern und synchronisieren",
|
||||
"mcp.name": "Name",
|
||||
"mcp.pasteHint": "JSON/JSONC, Codex- oder Grok-TOML oder Goose-YAML einfügen. Das Format wird automatisch erkannt.",
|
||||
"mcp.pasteHint": "JSON/JSONC, Codex- oder Grok-TOML oder Goose/Hermes-YAML einfügen. Das Format wird automatisch erkannt.",
|
||||
"mcp.importError.yaml": "Gültiges Hermes-YAML eingeben.",
|
||||
"mcp.importError.yamlAliases": "MCP-YAML darf keine Aliasse oder Zusammenführungen verwenden.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME muss ein absoluter Pfad sein.",
|
||||
"mcp.hermesTransportUnsupported": "Der Hermes-Import unterstützt nur stdio und Streamable HTTP, kein SSE.",
|
||||
"mcp.targets": "Targets",
|
||||
"mcp.source": "Quelle",
|
||||
"mcp.empty": "Noch keine MCP-Server",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Remove",
|
||||
"mcp.saveSync": "Save and sync",
|
||||
"mcp.name": "Name",
|
||||
"mcp.pasteHint": "Paste native JSON/JSONC, Codex or Grok TOML, or Goose YAML. The format is detected automatically.",
|
||||
"mcp.pasteHint": "Paste native JSON/JSONC, Codex or Grok TOML, or Goose/Hermes YAML. The format is detected automatically.",
|
||||
"mcp.importError.yaml": "Enter valid Hermes YAML.",
|
||||
"mcp.importError.yamlAliases": "MCP YAML cannot use aliases or merges.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME must be an absolute path.",
|
||||
"mcp.hermesTransportUnsupported": "Hermes import supports only stdio and Streamable HTTP; SSE is not supported.",
|
||||
"mcp.targets": "Targets",
|
||||
"mcp.source": "Source",
|
||||
"mcp.empty": "No MCP servers yet",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Eliminar",
|
||||
"mcp.saveSync": "Guardar y sincronizar",
|
||||
"mcp.name": "Nombre",
|
||||
"mcp.pasteHint": "Pega JSON/JSONC, TOML de Codex o Grok, o YAML de Goose. El formato se detecta automáticamente.",
|
||||
"mcp.pasteHint": "Pega JSON/JSONC, TOML de Codex o Grok, o YAML de Goose/Hermes. El formato se detecta automáticamente.",
|
||||
"mcp.importError.yaml": "Introduce YAML válido de Hermes.",
|
||||
"mcp.importError.yamlAliases": "El YAML de MCP no admite alias ni fusiones.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME debe ser una ruta absoluta.",
|
||||
"mcp.hermesTransportUnsupported": "La importación de Hermes solo admite stdio y Streamable HTTP; SSE no está disponible.",
|
||||
"mcp.targets": "Targets",
|
||||
"mcp.source": "Origen",
|
||||
"mcp.empty": "Aún no hay servidores MCP",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "حذف",
|
||||
"mcp.saveSync": "ذخیره و همگامسازی",
|
||||
"mcp.name": "نام",
|
||||
"mcp.pasteHint": "JSON/JSONC، TOML مربوط به Codex یا Grok، یا YAML مربوط به Goose را بچسبانید. قالب خودکار شناسایی میشود.",
|
||||
"mcp.pasteHint": "JSON/JSONC، TOML مربوط به Codex یا Grok، یا YAML مربوط به Goose/Hermes را بچسبانید. قالب خودکار شناسایی میشود.",
|
||||
"mcp.importError.yaml": "YAML معتبر Hermes را وارد کنید.",
|
||||
"mcp.importError.yamlAliases": "YAML مربوط به MCP نباید از نام مستعار یا ادغام استفاده کند.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME باید یک مسیر مطلق باشد.",
|
||||
"mcp.hermesTransportUnsupported": "درونریزی Hermes فقط از stdio و Streamable HTTP پشتیبانی میکند؛ SSE پشتیبانی نمیشود.",
|
||||
"mcp.targets": "Targetها",
|
||||
"mcp.source": "مبدأ",
|
||||
"mcp.empty": "هنوز سرور MCP وجود ندارد",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Supprimer",
|
||||
"mcp.saveSync": "Enregistrer et synchroniser",
|
||||
"mcp.name": "Nom",
|
||||
"mcp.pasteHint": "Collez du JSON/JSONC, du TOML Codex ou Grok, ou du YAML Goose. Le format est détecté automatiquement.",
|
||||
"mcp.pasteHint": "Collez du JSON/JSONC, du TOML Codex ou Grok, ou du YAML Goose/Hermes. Le format est détecté automatiquement.",
|
||||
"mcp.importError.yaml": "Saisissez du YAML Hermes valide.",
|
||||
"mcp.importError.yamlAliases": "Le YAML MCP ne peut pas utiliser d’alias ni de fusions.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME doit être un chemin absolu.",
|
||||
"mcp.hermesTransportUnsupported": "L’import Hermes prend uniquement en charge stdio et Streamable HTTP, pas SSE.",
|
||||
"mcp.targets": "Targets",
|
||||
"mcp.source": "Source",
|
||||
"mcp.empty": "Aucun serveur MCP",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Hapus",
|
||||
"mcp.saveSync": "Simpan dan sinkronkan",
|
||||
"mcp.name": "Nama",
|
||||
"mcp.pasteHint": "Tempel JSON/JSONC, TOML Codex atau Grok, atau YAML Goose. Format dideteksi secara otomatis.",
|
||||
"mcp.pasteHint": "Tempel JSON/JSONC, TOML Codex atau Grok, atau YAML Goose/Hermes. Format dideteksi secara otomatis.",
|
||||
"mcp.importError.yaml": "Masukkan YAML Hermes yang valid.",
|
||||
"mcp.importError.yamlAliases": "YAML MCP tidak boleh menggunakan alias atau penggabungan.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME harus berupa jalur absolut.",
|
||||
"mcp.hermesTransportUnsupported": "Impor Hermes hanya mendukung stdio dan Streamable HTTP; SSE tidak didukung.",
|
||||
"mcp.targets": "Target",
|
||||
"mcp.source": "Sumber",
|
||||
"mcp.empty": "Belum ada server MCP",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "削除",
|
||||
"mcp.saveSync": "保存して同期",
|
||||
"mcp.name": "名前",
|
||||
"mcp.pasteHint": "JSON/JSONC、Codex・Grok の TOML、または Goose YAML を貼り付けてください。形式は自動で判別されます。",
|
||||
"mcp.pasteHint": "JSON/JSONC、Codex・Grok の TOML、または Goose/Hermes YAML を貼り付けてください。形式は自動で判別されます。",
|
||||
"mcp.importError.yaml": "有効な Hermes YAML を入力してください。",
|
||||
"mcp.importError.yamlAliases": "MCP YAML ではエイリアスやマージは使えません。",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME には絶対パスを指定してください。",
|
||||
"mcp.hermesTransportUnsupported": "Hermes のインポートは stdio と Streamable HTTP のみ対応しています。SSE は非対応です。",
|
||||
"mcp.targets": "Target",
|
||||
"mcp.source": "ソース",
|
||||
"mcp.empty": "MCP は未設定です",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "제거",
|
||||
"mcp.saveSync": "저장 및 동기화",
|
||||
"mcp.name": "이름",
|
||||
"mcp.pasteHint": "JSON/JSONC, Codex 또는 Grok TOML, Goose YAML을 붙여넣으세요. 형식은 자동으로 감지됩니다.",
|
||||
"mcp.pasteHint": "JSON/JSONC, Codex 또는 Grok TOML, Goose/Hermes YAML을 붙여넣으세요. 형식은 자동으로 감지됩니다.",
|
||||
"mcp.importError.yaml": "올바른 Hermes YAML을 입력하세요.",
|
||||
"mcp.importError.yamlAliases": "MCP YAML에서는 별칭이나 병합을 사용할 수 없습니다.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME은 절대 경로여야 합니다.",
|
||||
"mcp.hermesTransportUnsupported": "Hermes 가져오기는 stdio와 Streamable HTTP만 지원하며 SSE는 지원하지 않습니다.",
|
||||
"mcp.targets": "Target",
|
||||
"mcp.source": "원본",
|
||||
"mcp.empty": "아직 MCP가 없습니다",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "Remover",
|
||||
"mcp.saveSync": "Salvar e sincronizar",
|
||||
"mcp.name": "Nome",
|
||||
"mcp.pasteHint": "Cole JSON/JSONC, TOML do Codex ou Grok, ou YAML do Goose. O formato é detectado automaticamente.",
|
||||
"mcp.pasteHint": "Cole JSON/JSONC, TOML do Codex ou Grok, ou YAML do Goose/Hermes. O formato é detectado automaticamente.",
|
||||
"mcp.importError.yaml": "Insira um YAML válido do Hermes.",
|
||||
"mcp.importError.yamlAliases": "O YAML do MCP não permite aliases nem mesclagens.",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME deve ser um caminho absoluto.",
|
||||
"mcp.hermesTransportUnsupported": "A importação do Hermes aceita apenas stdio e Streamable HTTP; SSE não é compatível.",
|
||||
"mcp.targets": "Targets",
|
||||
"mcp.source": "Origem",
|
||||
"mcp.empty": "Nenhum servidor MCP",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "移除",
|
||||
"mcp.saveSync": "保存并同步",
|
||||
"mcp.name": "名称",
|
||||
"mcp.pasteHint": "粘贴原生 JSON/JSONC、Codex 或 Grok 的 TOML,或 Goose YAML。会自动识别格式。",
|
||||
"mcp.pasteHint": "粘贴原生 JSON/JSONC、Codex 或 Grok 的 TOML,或 Goose/Hermes YAML。会自动识别格式。",
|
||||
"mcp.importError.yaml": "请输入有效的 Hermes YAML。",
|
||||
"mcp.importError.yamlAliases": "MCP YAML 不支持别名或合并。",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME 必须是绝对路径。",
|
||||
"mcp.hermesTransportUnsupported": "Hermes 导入仅支持 stdio 和 Streamable HTTP,不支持 SSE。",
|
||||
"mcp.targets": "目标",
|
||||
"mcp.source": "来源",
|
||||
"mcp.empty": "尚未设置 MCP",
|
||||
|
||||
@@ -29,7 +29,11 @@
|
||||
"mcp.remove": "移除",
|
||||
"mcp.saveSync": "儲存並同步",
|
||||
"mcp.name": "名稱",
|
||||
"mcp.pasteHint": "貼上原生 JSON/JSONC、Codex 或 Grok 的 TOML,或 Goose YAML。會自動辨識格式。",
|
||||
"mcp.pasteHint": "貼上原生 JSON/JSONC、Codex 或 Grok 的 TOML,或 Goose/Hermes YAML。會自動辨識格式。",
|
||||
"mcp.importError.yaml": "請輸入有效的 Hermes YAML。",
|
||||
"mcp.importError.yamlAliases": "MCP YAML 不支援別名或合併。",
|
||||
"mcp.hermesHomeAbsolute": "HERMES_HOME 必須是絕對路徑。",
|
||||
"mcp.hermesTransportUnsupported": "Hermes 匯入僅支援 stdio 與 Streamable HTTP,不支援 SSE。",
|
||||
"mcp.targets": "目標",
|
||||
"mcp.source": "來源",
|
||||
"mcp.empty": "尚未設定 MCP",
|
||||
|
||||
@@ -44,7 +44,7 @@ skillshare sync --all
|
||||
| `--tools-deny TOOLS` | Never these tools, separated by commas; beats allow; `""` clears. See [Tool policy](#tool-policy) |
|
||||
| `--pi-options JSON` | Other per-server fields of Pi's built-in MCP, as a JSON object. See [Pi](#pi-options) |
|
||||
| `--from CLIENT` | Existing client to import, or the format of `--file` |
|
||||
| `--file PATH` | Native JSON/JSONC, TOML or Goose YAML; `.toml` defaults to Codex, other formats are detected from their MCP section; use `--from` for an explicit dialect |
|
||||
| `--file PATH` | Native JSON/JSONC, TOML or Goose/Hermes YAML; `.toml` defaults to Codex, other formats are detected from their MCP section; use `--from` for an explicit dialect |
|
||||
| `--sync` | Save and synchronize; noninteractive add/import/remove otherwise save only |
|
||||
| `--keep-files` | With `remove`: stop managing the server and leave its Agent entries as they are. Not with `--sync`. See [below](#stop-managing-a-server) |
|
||||
| `--replace` | Explicitly replace an existing source definition during add/import; on import, also rewrite the imported client's entry when it differs |
|
||||
@@ -134,7 +134,7 @@ Skillshare config. The schema is `schemas/mcp.schema.json` in the repository.
|
||||
|
||||
Client IDs are `claude`, `codex`, `cursor`, `vscode`, `opencode`, `kilocode`,
|
||||
`grok`, `antigravity`, `amp`, `claude-desktop`, `cline`, `copilot`, `factory`, `gemini`,
|
||||
`goose`, `junie`, `kiro`, `lmstudio`, `warp`, `windsurf`, `pi`, and `omp`.
|
||||
`goose`, `hermes`, `junie`, `kiro`, `lmstudio`, `warp`, `windsurf`, `pi`, and `omp`.
|
||||
`--target` and `--from` also take `agy` and `antigravity-cli`, the names other
|
||||
commands use for the Antigravity CLI, as `antigravity`; the source stores `antigravity`.
|
||||
`grok` means the official xAI Grok CLI. Server names use letters,
|
||||
@@ -231,6 +231,7 @@ Names such as `company-docs` work across all supported clients.
|
||||
| [Factory Droid](https://docs.factory.ai/harness/mcp) | `~/.factory/mcp.json` | `.factory/mcp.json` | `mcpServers` |
|
||||
| [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/) | `~/.gemini/settings.json` | `.gemini/settings.json` | `mcpServers` |
|
||||
| [Goose](https://block.github.io/goose/docs/guides/config-files/) | `~/.config/goose/config.yaml` | Global only | `extensions` (YAML) |
|
||||
| [Hermes Agent](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) | `~/.hermes/config.yaml` | Global only | `mcp_servers` (YAML) |
|
||||
| [Junie](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html) | `~/.junie/mcp/mcp.json` | `.junie/mcp/mcp.json` | `mcpServers` |
|
||||
| [Kiro](https://kiro.dev/docs/mcp/configuration/) | `~/.kiro/settings/mcp.json` | `.kiro/settings/mcp.json` | `mcpServers` |
|
||||
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | `~/.lmstudio/mcp.json` | Global only | `mcpServers` |
|
||||
@@ -299,6 +300,31 @@ Additional client details:
|
||||
formatting. Aliases, merges, duplicate keys and multiple documents block edits.
|
||||
Built-in extensions and keychain `env_keys` cannot be imported as portable MCP
|
||||
connections.
|
||||
- Hermes supports stdio and Streamable HTTP; SSE imports are rejected. It uses
|
||||
`${VAR}` references for `fromEnv`; import also accepts `${env:VAR}` in env and
|
||||
headers. YAML preservation and restrictions are the same as Goose above.
|
||||
Global sync/import honors an absolute `HERMES_HOME`; otherwise it uses the
|
||||
default profile (`~/.hermes`, or `%LOCALAPPDATA%/hermes` on Windows).
|
||||
Skillshare does not follow Hermes's active-profile file, `--profile`, or
|
||||
`HERMES_DATA_DIR_SUFFIX`; set `HERMES_HOME` explicitly for another profile.
|
||||
Hermes has no project MCP destination in Skillshare.
|
||||
Set `options.hermes.auth: oauth` for native OAuth. Import keeps `auth` and
|
||||
`oauth` under `options.hermes`; literal credentials there block import, so
|
||||
replace them with whole-value `${VAR}` references first. Other native fields
|
||||
are reported as not imported. Login, tokens, `.env` and refresh state stay
|
||||
managed by Hermes; complete `hermes mcp login NAME` in the same Hermes profile.
|
||||
|
||||
```yaml
|
||||
mcp:
|
||||
servers:
|
||||
linear:
|
||||
url: https://mcp.linear.app/mcp
|
||||
targets: [claude, codex, hermes]
|
||||
options:
|
||||
hermes:
|
||||
auth: oauth
|
||||
```
|
||||
|
||||
- Claude Code skips a server named `workspace`, `claude-in-chrome` or `computer-use`,
|
||||
which it reserves for built-in servers. It also never sends its own credentials to a
|
||||
remote server: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `AWS_BEARER_TOKEN_BEDROCK`,
|
||||
|
||||
@@ -44,7 +44,7 @@ skillshare sync --all
|
||||
| `--tools-deny TOOLS` | これらのツールを常に除外する。カンマ区切り。allow より優先。`""` でクリア。[ツールポリシー](#tool-policy)を参照 |
|
||||
| `--pi-options JSON` | Pi の内蔵 MCP のその他のサーバー別フィールドを JSON オブジェクトで指定する。[Pi](#pi-options)を参照 |
|
||||
| `--from CLIENT` | インポート元の既存クライアント、または `--file` のフォーマット |
|
||||
| `--file PATH` | ネイティブの JSON/JSONC、TOML、または Goose の YAML。`.toml` はデフォルトで Codex とみなされ、他のフォーマットはその MCP セクションから検出される。明示的な方言を指定するには `--from` を使う |
|
||||
| `--file PATH` | ネイティブの JSON/JSONC、TOML、または Goose/Hermes の YAML。`.toml` はデフォルトで Codex とみなされ、他のフォーマットはその MCP セクションから検出される。明示的な方言を指定するには `--from` を使う |
|
||||
| `--sync` | 保存して同期する。非インタラクティブな add/import/remove ではそうしない限り保存のみ |
|
||||
| `--keep-files` | `remove` と併用: サーバーの管理をやめ、Agent のエントリはそのまま残す。`--sync` とは併用できない。[下記](#stop-managing-a-server)を参照 |
|
||||
| `--replace` | add/import 中に既存の source 定義を明示的に置き換える。import では、インポート元クライアントのエントリが異なる場合にそれも書き換える |
|
||||
@@ -103,7 +103,7 @@ Add、edit、remove、import では、**Save and sync** または **Save only**
|
||||
|
||||
クライアント ID は `claude`、`codex`、`cursor`、`vscode`、`opencode`、`kilocode`、
|
||||
`grok`、`antigravity`、`amp`、`claude-desktop`、`cline`、`copilot`、`factory`、`gemini`、
|
||||
`goose`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi`、`omp` です。
|
||||
`goose`、`hermes`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi`、`omp` です。
|
||||
`--target` と `--from` は、他のコマンドが Antigravity CLI に使う名前 `agy` と `antigravity-cli` も
|
||||
`antigravity` として受け付けます。source には `antigravity` が保存されます。
|
||||
`grok` は公式の xAI Grok CLI を意味します。サーバー名には文字、
|
||||
@@ -195,6 +195,7 @@ Grok の場合、名前は文字またはアンダースコアで始まり、文
|
||||
| [Factory Droid](https://docs.factory.ai/harness/mcp) | `~/.factory/mcp.json` | `.factory/mcp.json` | `mcpServers` |
|
||||
| [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/) | `~/.gemini/settings.json` | `.gemini/settings.json` | `mcpServers` |
|
||||
| [Goose](https://block.github.io/goose/docs/guides/config-files/) | `~/.config/goose/config.yaml` | Global のみ | `extensions`(YAML) |
|
||||
| [Hermes Agent](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) | `~/.hermes/config.yaml` | Global のみ | `mcp_servers` (YAML) |
|
||||
| [Junie](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html) | `~/.junie/mcp/mcp.json` | `.junie/mcp/mcp.json` | `mcpServers` |
|
||||
| [Kiro](https://kiro.dev/docs/mcp/configuration/) | `~/.kiro/settings/mcp.json` | `.kiro/settings/mcp.json` | `mcpServers` |
|
||||
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | `~/.lmstudio/mcp.json` | Global のみ | `mcpServers` |
|
||||
@@ -202,6 +203,8 @@ Grok の場合、名前は文字またはアンダースコアで始まり、文
|
||||
| [Windsurf (Cascade)](https://docs.devin.ai/desktop/cascade/mcp) | `~/.codeium/windsurf/mcp_config.json` | Global のみ | `mcpServers` |
|
||||
| [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi/blob/v18.6.1/docs/mcp-config.md) | `~/.omp/agent/mcp.json` | `.omp/mcp.json` | `mcpServers` |
|
||||
|
||||
Hermes は Global MCP のみ対応し、`mcp_servers`(YAML)を使用します。stdio と Streamable HTTP に対応し、SSE のインポートは拒否します。絶対パスの `HERMES_HOME` で別の home/profile を選択できます。未指定時は default profile(Windows は `%LOCALAPPDATA%/hermes`)を使い、active profile、`--profile`、`HERMES_DATA_DIR_SUFFIX` は追跡しません。`fromEnv` は `${VAR}` を出力し、env/header のインポートは `${env:VAR}` も受け付けます。OAuth は `options.hermes: {auth: oauth}` で指定します。インポートでは `auth`/`oauth` を保持しますが、平文の認証情報は拒否するため、値全体を `${VAR}` 参照に置き換えてください。その他の未対応フィールドは警告されます。ログイン、`.env`、token、refresh state は Hermes が管理します。同じ profile で `hermes mcp login NAME` を実行してください。YAML の保持と制限は Goose と同じです。
|
||||
|
||||
ダッシュボードのサーバーフォームは、HTTP ヘッダーを環境変数と同じ方法で編集し、`fromEnv` 参照にも対応します。サーバーのメニューとフォーム内のファイル数の横にある **View what each Agent gets** は、選択したクライアントに対して Sync が書き込む予定のネイティブテキストを読み取り専用で表示します。フォーム内では、まだ保存されていない編集内容が反映されます。secret は参照のままです。
|
||||
|
||||
JSON エントリは、そのファイル自体のインデントに合わせて 1 行に 1 フィールドで書き込まれます。Skillshare が所有しているにもかかわらず 1 行にまとまっているエントリは `update` として報告され、改めてレイアウトされて書き込まれます。Skillshare が所有していないエントリや、手動でフォーマットされたエントリは、そのレイアウトを保持します。
|
||||
|
||||
@@ -44,7 +44,7 @@ skillshare sync --all
|
||||
| `--tools-deny TOOLS` | 이 도구는 항상 제외, 쉼표로 구분; allow보다 우선; `""`는 값을 지웁니다. [도구 정책](#tool-policy) 참고 |
|
||||
| `--pi-options JSON` | Pi 내장 MCP의 그 밖의 서버별 필드를 JSON 객체로 지정. [Pi](#pi-options) 참고 |
|
||||
| `--from CLIENT` | import할 기존 client, 또는 `--file`의 형식 |
|
||||
| `--file PATH` | 네이티브 JSON/JSONC, TOML 또는 Goose YAML; `.toml`은 기본적으로 Codex로 처리되며, 다른 형식은 MCP 섹션에서 감지됨; 명시적인 방언을 지정하려면 `--from` 사용 |
|
||||
| `--file PATH` | 네이티브 JSON/JSONC, TOML 또는 Goose/Hermes YAML; `.toml`은 기본적으로 Codex로 처리되며, 다른 형식은 MCP 섹션에서 감지됨; 명시적인 방언을 지정하려면 `--from` 사용 |
|
||||
| `--sync` | 저장 후 동기화; noninteractive add/import/remove는 그렇지 않으면 저장만 함 |
|
||||
| `--keep-files` | `remove`와 함께 사용: 서버 관리를 멈추고 Agent 항목은 그대로 둡니다. `--sync`와 함께 쓸 수 없습니다. [아래](#stop-managing-a-server) 참고 |
|
||||
| `--replace` | add/import 중 기존 source 정의를 명시적으로 교체; import 시 가져온 client의 항목이 다르면 이것도 다시 작성 |
|
||||
@@ -130,7 +130,7 @@ source가 한 번 저장되기 전에 검증되며, 이후의 네이티브 파
|
||||
|
||||
Client ID는 `claude`, `codex`, `cursor`, `vscode`, `opencode`, `kilocode`,
|
||||
`grok`, `antigravity`, `amp`, `claude-desktop`, `cline`, `copilot`, `factory`, `gemini`,
|
||||
`goose`, `junie`, `kiro`, `lmstudio`, `warp`, `windsurf`, `pi`, `omp`입니다.
|
||||
`goose`, `hermes`, `junie`, `kiro`, `lmstudio`, `warp`, `windsurf`, `pi`, `omp`입니다.
|
||||
`--target`과 `--from`은 다른 명령이 Antigravity CLI를 부르는 이름인 `agy`와 `antigravity-cli`도
|
||||
`antigravity`로 받으며, source에는 `antigravity`가 저장됩니다.
|
||||
`grok`은 공식 xAI Grok CLI를 의미합니다. 서버 이름은 문자, 숫자, 점, 밑줄, 하이픈을
|
||||
@@ -222,6 +222,7 @@ client에서 동작합니다.
|
||||
| [Factory Droid](https://docs.factory.ai/harness/mcp) | `~/.factory/mcp.json` | `.factory/mcp.json` | `mcpServers` |
|
||||
| [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/) | `~/.gemini/settings.json` | `.gemini/settings.json` | `mcpServers` |
|
||||
| [Goose](https://block.github.io/goose/docs/guides/config-files/) | `~/.config/goose/config.yaml` | Global only | `extensions` (YAML) |
|
||||
| [Hermes Agent](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) | `~/.hermes/config.yaml` | Global only | `mcp_servers` (YAML) |
|
||||
| [Junie](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html) | `~/.junie/mcp/mcp.json` | `.junie/mcp/mcp.json` | `mcpServers` |
|
||||
| [Kiro](https://kiro.dev/docs/mcp/configuration/) | `~/.kiro/settings/mcp.json` | `.kiro/settings/mcp.json` | `mcpServers` |
|
||||
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | `~/.lmstudio/mcp.json` | Global only | `mcpServers` |
|
||||
@@ -229,6 +230,8 @@ client에서 동작합니다.
|
||||
| [Windsurf (Cascade)](https://docs.devin.ai/desktop/cascade/mcp) | `~/.codeium/windsurf/mcp_config.json` | Global only | `mcpServers` |
|
||||
| [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi/blob/v18.6.1/docs/mcp-config.md) | `~/.omp/agent/mcp.json` | `.omp/mcp.json` | `mcpServers` |
|
||||
|
||||
Hermes는 Global MCP만 지원하며 `mcp_servers`(YAML)를 사용합니다. stdio와 Streamable HTTP를 지원하고 SSE 가져오기는 거부합니다. 절대 경로 `HERMES_HOME`으로 다른 home/profile을 선택할 수 있습니다. 지정하지 않으면 default profile(Windows: `%LOCALAPPDATA%/hermes`)을 사용하며 active profile, `--profile`, `HERMES_DATA_DIR_SUFFIX`는 추적하지 않습니다. `fromEnv`는 `${VAR}`를 출력하고 env/header 가져오기는 `${env:VAR}`도 허용합니다. OAuth는 `options.hermes: {auth: oauth}`로 설정합니다. 가져오기는 `auth`/`oauth`를 유지하지만 일반 텍스트 자격 증명은 거부하므로 전체 값을 `${VAR}` 참조로 바꾸세요. 다른 매핑되지 않은 필드는 경고합니다. 로그인, `.env`, token 및 refresh state는 Hermes가 관리합니다. 같은 profile에서 `hermes mcp login NAME`을 실행하세요. YAML 보존 규칙과 제한은 Goose와 같습니다.
|
||||
|
||||
대시보드의 서버 폼은 `fromEnv` 참조를 포함해 HTTP 헤더를 환경 변수와 동일한 방식으로
|
||||
편집합니다. 서버 메뉴와 폼의 파일 개수 옆에 있는 **View what each Agent gets**는,
|
||||
선택한 client에 대해 Sync가 작성할 네이티브 텍스트를 읽기 전용으로 보여줍니다. 폼에서는
|
||||
|
||||
+5
-2
@@ -44,7 +44,7 @@ skillshare sync --all
|
||||
| `--tools-deny TOOLS` | 始终排除这些工具,用逗号分隔;优先于 allow;`""` 表示清除。参见[工具策略](#tool-policy) |
|
||||
| `--pi-options JSON` | Pi 内置 MCP 的其他单个 server 字段,以 JSON 对象表示。参见 [Pi](#pi-options) |
|
||||
| `--from CLIENT` | 要导入的现有 client,或 `--file` 的格式 |
|
||||
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose YAML;`.toml` 默认对应 Codex,其他格式会根据其 MCP 区块自动检测;如需明确指定方言请使用 `--from` |
|
||||
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose/Hermes YAML;`.toml` 默认对应 Codex,其他格式会根据其 MCP 区块自动检测;如需明确指定方言请使用 `--from` |
|
||||
| `--sync` | 保存并同步;非交互式的 add/import/remove 默认仅保存 |
|
||||
| `--keep-files` | 配合 `remove` 使用:停止管理该 server,并让它的 Agent 条目保持原样。不能与 `--sync` 同时使用。参见[下文](#stop-managing-a-server) |
|
||||
| `--replace` | 在 add/import 期间显式替换已存在的 source 定义;在 import 时,若导入的 client 条目不同,也会重写它 |
|
||||
@@ -132,7 +132,7 @@ Skillshare 配置中。schema 是仓库中的 `schemas/mcp.schema.json`。
|
||||
|
||||
Client ID 有 `claude`、`codex`、`cursor`、`vscode`、`opencode`、`kilocode`、
|
||||
`grok`、`antigravity`、`amp`、`claude-desktop`、`cline`、`copilot`、`factory`、`gemini`、
|
||||
`goose`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi` 和 `omp`。
|
||||
`goose`、`hermes`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi` 和 `omp`。
|
||||
`--target` 和 `--from` 也接受 `agy` 和 `antigravity-cli`(其他命令对 Antigravity CLI 的称呼),
|
||||
并将它们视为 `antigravity`;source 中保存的是 `antigravity`。
|
||||
`grok` 指的是官方的 xAI Grok CLI。Server 名称使用字母、
|
||||
@@ -224,6 +224,7 @@ skillshare mcp edit docs --target claude # 把它加回来
|
||||
| [Factory Droid](https://docs.factory.ai/harness/mcp) | `~/.factory/mcp.json` | `.factory/mcp.json` | `mcpServers` |
|
||||
| [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/) | `~/.gemini/settings.json` | `.gemini/settings.json` | `mcpServers` |
|
||||
| [Goose](https://block.github.io/goose/docs/guides/config-files/) | `~/.config/goose/config.yaml` | 仅限 Global | `extensions`(YAML) |
|
||||
| [Hermes Agent](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) | `~/.hermes/config.yaml` | 仅限 Global | `mcp_servers` (YAML) |
|
||||
| [Junie](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html) | `~/.junie/mcp/mcp.json` | `.junie/mcp/mcp.json` | `mcpServers` |
|
||||
| [Kiro](https://kiro.dev/docs/mcp/configuration/) | `~/.kiro/settings/mcp.json` | `.kiro/settings/mcp.json` | `mcpServers` |
|
||||
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | `~/.lmstudio/mcp.json` | 仅限 Global | `mcpServers` |
|
||||
@@ -231,6 +232,8 @@ skillshare mcp edit docs --target claude # 把它加回来
|
||||
| [Windsurf (Cascade)](https://docs.devin.ai/desktop/cascade/mcp) | `~/.codeium/windsurf/mcp_config.json` | 仅限 Global | `mcpServers` |
|
||||
| [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi/blob/v18.6.1/docs/mcp-config.md) | `~/.omp/agent/mcp.json` | `.omp/mcp.json` | `mcpServers` |
|
||||
|
||||
Hermes 仅支持 Global MCP,使用 `mcp_servers`(YAML);支持 stdio 和 Streamable HTTP,拒绝导入 SSE。绝对路径 `HERMES_HOME` 可选择其他 home/profile;未指定时使用 default profile,Windows 默认为 `%LOCALAPPDATA%/hermes`。不自动跟踪 active profile、`--profile` 或 `HERMES_DATA_DIR_SUFFIX`。`fromEnv` 写为 `${VAR}`,env/header 导入也接受 `${env:VAR}`。使用 `options.hermes: {auth: oauth}` 启用原生 OAuth;导入会保留 `auth`/`oauth`,其中的明文凭据会阻止导入,请先改为完整的 `${VAR}` 引用。其他未映射字段会产生警告。登录、`.env`、token 和 refresh state 由 Hermes 管理,在相同 profile 执行 `hermes mcp login NAME`。YAML 保留规则与限制同 Goose。
|
||||
|
||||
仪表盘的 server 表单编辑 HTTP header 的方式与编辑环境变量相同,
|
||||
包括 `fromEnv` 引用。**View what each Agent gets** 位于某个 server 的菜单中,
|
||||
以及其表单中文件计数旁边,只读地显示 Sync 会为所选
|
||||
|
||||
+5
-2
@@ -44,7 +44,7 @@ skillshare sync --all
|
||||
| `--tools-deny TOOLS` | 永遠排除這些工具,以逗號分隔;優先於 allow;`""` 會清除。參見[工具政策](#tool-policy) |
|
||||
| `--pi-options JSON` | Pi 內建 MCP 的其他單一 server 欄位,以 JSON 物件表示。參見 [Pi](#pi-options) |
|
||||
| `--from CLIENT` | 要匯入的既有 client,或 `--file` 的格式 |
|
||||
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose YAML;`.toml` 預設為 Codex,其他格式會從其 MCP 區段偵測;使用 `--from` 可明確指定格式 |
|
||||
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose/Hermes YAML;`.toml` 預設為 Codex,其他格式會從其 MCP 區段偵測;使用 `--from` 可明確指定格式 |
|
||||
| `--sync` | 儲存並同步;非互動式的 add/import/remove 預設只會儲存 |
|
||||
| `--keep-files` | 搭配 `remove`:停止管理該 server,並讓它在各 Agent 中的項目維持原樣。不可與 `--sync` 併用。參見[下方說明](#stop-managing-a-server) |
|
||||
| `--replace` | 在 add/import 期間明確取代既有的 source 定義;在 import 時,若匯入的 client 項目不同也會一併改寫 |
|
||||
@@ -102,7 +102,7 @@ Add、edit、remove 與 import 在 **Save and sync** 或 **Save only** 之前會
|
||||
|
||||
Client ID 有 `claude`、`codex`、`cursor`、`vscode`、`opencode`、`kilocode`、
|
||||
`grok`、`antigravity`、`amp`、`claude-desktop`、`cline`、`copilot`、`factory`、`gemini`、
|
||||
`goose`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi` 與 `omp`。
|
||||
`goose`、`hermes`、`junie`、`kiro`、`lmstudio`、`warp`、`windsurf`、`pi` 與 `omp`。
|
||||
`--target` 與 `--from` 也接受 `agy` 與 `antigravity-cli`(其他指令對 Antigravity CLI 的稱呼),
|
||||
並視為 `antigravity`;source 中儲存的是 `antigravity`。
|
||||
`grok` 指的是官方的 xAI Grok CLI。Server 名稱使用字母、
|
||||
@@ -193,6 +193,7 @@ skillshare mcp edit docs --target claude # 恢復同步
|
||||
| [Factory Droid](https://docs.factory.ai/harness/mcp) | `~/.factory/mcp.json` | `.factory/mcp.json` | `mcpServers` |
|
||||
| [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/) | `~/.gemini/settings.json` | `.gemini/settings.json` | `mcpServers` |
|
||||
| [Goose](https://block.github.io/goose/docs/guides/config-files/) | `~/.config/goose/config.yaml` | 僅限 Global | `extensions`(YAML) |
|
||||
| [Hermes Agent](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) | `~/.hermes/config.yaml` | 僅限 Global | `mcp_servers` (YAML) |
|
||||
| [Junie](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html) | `~/.junie/mcp/mcp.json` | `.junie/mcp/mcp.json` | `mcpServers` |
|
||||
| [Kiro](https://kiro.dev/docs/mcp/configuration/) | `~/.kiro/settings/mcp.json` | `.kiro/settings/mcp.json` | `mcpServers` |
|
||||
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | `~/.lmstudio/mcp.json` | 僅限 Global | `mcpServers` |
|
||||
@@ -200,6 +201,8 @@ skillshare mcp edit docs --target claude # 恢復同步
|
||||
| [Windsurf (Cascade)](https://docs.devin.ai/desktop/cascade/mcp) | `~/.codeium/windsurf/mcp_config.json` | 僅限 Global | `mcpServers` |
|
||||
| [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi/blob/v18.6.1/docs/mcp-config.md) | `~/.omp/agent/mcp.json` | `.omp/mcp.json` | `mcpServers` |
|
||||
|
||||
Hermes 僅支援 Global MCP,使用 `mcp_servers`(YAML);支援 stdio 與 Streamable HTTP,拒絕匯入 SSE。絕對路徑 `HERMES_HOME` 可選擇其他 home/profile;未指定時使用 default profile,Windows 預設為 `%LOCALAPPDATA%/hermes`。不自動追蹤 active profile、`--profile` 或 `HERMES_DATA_DIR_SUFFIX`。`fromEnv` 寫為 `${VAR}`,env/header 匯入也接受 `${env:VAR}`。使用 `options.hermes: {auth: oauth}` 啟用原生 OAuth;匯入會保留 `auth`/`oauth`,其中的明文憑證會阻擋匯入,請先改為完整的 `${VAR}` 參照。其他未映射欄位會產生警告。登入、`.env`、token 與 refresh state 由 Hermes 管理,在相同 profile 執行 `hermes mcp login NAME`。YAML 保留規則與限制同 Goose。
|
||||
|
||||
Dashboard 的 server 表單編輯 HTTP headers 的方式與環境變數相同,
|
||||
包括 `fromEnv` 參照。Server 選單中的 **View what each Agent gets**,以及其表單中檔案數量旁的同名選項,
|
||||
會以唯讀方式顯示 Sync 對所選 client 會寫入的原生文字內容;在表單中,它會反映尚未儲存的編輯內容。機密資料仍以參照形式呈現。
|
||||
|
||||
Reference in New Issue
Block a user