Scripts API

Scripts API는 재사용 가능한 스크립트를 위한 영구 저장소를 제공합니다. 스크립트는 마인드 내에서 이름이 지정되고 버전 관리되며, 일반 텍스트로 가져올 수 있습니다 — curl | bash 패턴에 적합합니다.

엔드포인트

POST /script

스크립트를 저장하거나 업데이트합니다.

curl -X POST https://synapse.schaefer.zone/script \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-synapse",
    "content": "#!/bin/bash\nset -euo pipefail\ngit pull\nnpm ci\nnpm run build\ndocker compose up -d",
    "description": "Deploy Synapse to production",
    "language": "bash"
  }'

GET /script/:name

스크립트 내용을 text/plain으로 가져옵니다. bash로 파이프하기에 적합합니다.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

내용 없이 스크립트 메타데이터를 가져옵니다.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse/info

응답:

{
  "name": "deploy-synapse",
  "description": "Deploy Synapse to production",
  "language": "bash",
  "size_bytes": 142,
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}

GET /scripts

현재 마인드의 모든 스크립트를 나열합니다.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/scripts

DELETE /script/:name

스크립트를 삭제합니다.

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse

일반적인 사용 사례

배포 스크립트

LLM이 매번 단계를 다시 도출하지 않고도 실행할 수 있도록 표준 배포 절차를 저장합니다:

# LLM stores this once
curl -X POST .../script -d '{
  "name": "deploy-vps1",
  "content": "#!/bin/bash\nssh vps1 \"cd /opt/synapse && git pull && docker compose up -d --build\"",
  "language": "bash"
}'

# Later sessions just run it
curl -H "Authorization: ..." .../script/deploy-vps1 | bash

문제 해결 스니펫

일반적인 문제에 대한 진단 명령을 저장합니다:

curl -X POST .../script -d '{
  "name": "check-docker",
  "content": "#!/bin/bash\ndocker ps\ndocker stats --no-stream\ndocker system df",
  "description": "Quick Docker health check",
  "language": "bash"
}'

구성 생성기

구성을 생성하는 스크립트를 저장합니다:

curl -X POST .../script -d '{
  "name": "gen-nginx-conf",
  "content": "#!/usr/bin/env python3\nimport sys\n# ... generate nginx config from template ...",
  "language": "python"
}'

다음 단계

• Variables API
• Cron 및 Scheduler