okfshare CLI 및 MCP 서버

클라이언트 측이자 오픈소스로 공개된 okfshare의 절반: AI 코딩 에이전트를 위한 공유·버전 관리 지식.

검증된 Markdown 번들을 한 번 게시하세요. 모든 승인된 에이전트는 감사할 수 있는 라인 단위 인용과 함께 동일한 불변 리비전을 기준으로 작업합니다. 호스팅 서비스는 리비전, 인용, 워크스페이스 인증을 보관하며, 이 저장소에는 에이전트가 실제로 실행하는 도구가 있습니다.

패키지

Related MCP server: JacBrain

빠른 시작

# 1. One-time onboarding (device pairing in your browser)
npx okfshare@latest setup

# 2. Validate and publish a folder of Markdown
npx okfshare@latest validate ./knowledge
npx okfshare@latest publish ./knowledge --visibility public --yes

# 3. Any teammate's agent retrieves cited context
npx okfshare@latest context SHARE_ID "how do we handle db migrations"

헤드리스/CI 환경: OKFSHARE_TOKEN 환경 변수로 사전 프로비저닝된 자격 증명을 제공하세요(존재 여부만 확인하고 절대 기록하지 마세요). 그런 다음 whoami와 doctor로 검증하세요.

MCP 설정

claude mcp add okfshare -- npx @okfshare/mcp@latest

또는 아무 MCP 클라이언트에서:

{
  "mcpServers": {
    "okfshare": {
      "command": "npx",
      "args": ["@okfshare/mcp@latest"]
    }
  }
}

도구: whoami, doctor, list_shares, search_share, search_workspace, get_context, pull_bundle, publish_bundle. 레지스트리 매니페스트: server.json.

인용이 중요한 이유

검색은 파일, 정확한 라인, 그리고 해당 라인이 포함된 불변 리비전을 반환합니다. 에이전트가 "우리 규칙에는 X라고 쓰여 있다"고 주장하면 몇 초 만에 그 주장을 감사할 수 있습니다. 그리고 리비전 내용은 제자리에서 변경되지 않으므로 인용은 내일도 동일한 의미를 갖습니다.

Open Knowledge Format

번들은 구조화된 프론트매터(frontmatter)가 있는 Markdown입니다: type, title, description, tags, sources, verification events. 이 형식은 의도적으로 작게 유지되므로 어떤 편집기에서도 읽기 쉽습니다. 최악의 경우에도 남는 것은 일반 파일뿐이며, 락인(lock-in)이 없습니다.

• Spec: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

• Field guide(okfshare 자체와 함께 공개됨): https://okfshare.app/s/ecf08367a22273482c0887ca8700ee8e

• 포크 가능한 규칙 스타터: https://okfshare.app/s/e8ddeda5aab619495c970f031dce7058

개발

pnpm install
pnpm check   # typecheck + test + build across all packages

• Node 20 이상 및 pnpm 10.

• 패키지들은 https://okfshare.app에 호스팅된 API와 통신하므로, 개발에 로컬 서버가 필요 없습니다.

• 승인 절차는 CONTRIBUTING.md를, 취약점 신고는 SECURITY.md를 참고하세요.

링크

• 사이트 및 문서: https://okfshare.app

• 에이전트가 읽을 수 있는 문서: https://okfshare.app/llms.txt 및 https://okfshare.app/llms-full.txt

라이선스

Apache-2.0. NOTICE를 참조하세요. 코드 라이선스는 okfshare 이름이나 브랜딩에 대한 권리를 부여하지 않습니다.