stevesolun/ctx

Not an Amazon-style catalog or marketplace. ctx is a recommendation layer: bring your org tools or use the shipped graph to load the right skills, agents, MCPs, and harnesses only for the current dev window, cutting token bills and local compute waste: 79,958-node LLM-wiki graph, 68,494 skills, 467 agents, 10,790 MCPs, 207 harnesses.

GitHub에서 열기 ↗ agentsai-agentsanthropicautomationclaudeclaude-codecontext-managementdeveloper-toolsharnessknowledge-graphllmllm-wikimcpmicro-skillsobsidianreal-timerecommendation-engineskill-managementskillswiki

547

GitHub 스타

포크

Python

언어

MIT

라이선스

2026.07.09

최근 푸시

2026.04.21

별표한 날

AI 분석

설치 난이도: 보통

큐레이터 노트

LLM 기반 개발 환경에서 컨텍스트 관리를 최적화하려는 팀이나 개인에게 적합합니다. 특히 Claude Code 사용자나 다양한 스킬/에이전트를 효율적으로 관리하려는 경우 유용합니다.

강점

방대한 사전 구축 지식 그래프(79,958개 노드, 68,494개 스킬)를 제공하여 즉시 사용 가능한 추천 기능을 제공합니다.
Claude Code뿐만 아니라 로컬/API 모델도 지원하며 하네스 설치 흐름을 별도로 제공합니다.
토큰 및 컴퓨팅 자원 절약에 초점을 맞춰 컨텍스트 예산 문제를 해결합니다.

약점

초기 설정이 복잡할 수 있으며 여러 CLI 명령과 옵션을 이해해야 합니다.
대규모 그래프 다운로드 및 처리가 필요하여 설치 시간이 오래 걸릴 수 있습니다.
Windows에서 tar 명령어에 제약이 있어 추가 안내가 필요합니다.

주의사항

기존 엔티티 업데이트 시 기본적으로 교체를 건너뛰므로 `--update-existing` 플래그를 명시적으로 사용해야 합니다.
Windows 사용자는 tar 명령어 사용 시 별도의 지침을 따라야 합니다.
전체 그래프 모드(`--graph-install-mode full`)는 상당한 디스크 공간을 차지할 수 있습니다.

시작 가이드

pip install claude-ctx로 설치 후 ctx-init 마법사를 실행하여 기본 설정을 완료합니다.
ctx-scan-repo --repo . --recommend로 현재 저장소에 대한 추천을 확인합니다.
ctx-monitor serve로 대시보드를 실행하여 로드된 항목을 시각적으로 관리합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

ctx — 스킬, 에이전트, MCP 및 하네스 추천

ctx는 스킬, MCP, 에이전트, 도구 또는 하네스의 Amazon 스타일 카탈로그가 아닙니다. 추천 레이어입니다. 조직의 자체 도구를 가리키거나 사전 구축된 그래프를 사용하면 ctx가 현재 개발 창에 가장 유용한 작은 번들을 추천합니다. 목표는 적절한 순간에 올바른 스킬, 에이전트, MCP 서버 및 선택적 하네스를 로드하여 호스팅된 LLM이 더 적은 토큰을 사용하고 로컬 모델이 CPU/GPU 작업을 낭비하지 않도록 하는 것입니다.

ctx는 사용자가 구축 중인 것을 관찰하고 79,958개 노드 그래프를 탐색하여 현재 작업에 대한 작고 최고 점수의 스킬, 에이전트 및 MCP 서버 번들을 추천합니다. Claude Code 대신 자체 로컬/API 모델을 사용하는 경우 ctx에는 별도의 하네스 설정 흐름이 있습니다. 모델과 목표를 알려주고 추천 하네스를 검토한 후 dry-run/update/uninstall 제어 기능으로 설치합니다.

현재 제공되는 스냅샷:

68,494개 스킬 엔티티 페이지, 67,024개 수화된 설치 가능한 SKILL.md 본문.
467개 에이전트, 10,790개 MCP 서버, 207개 하네스.
의미적 유사성, 태그, 슬러그 토큰, 소스 중복, 직접 링크, 품질, 사용량, 유형 선호도 및 그래프 구조에 걸친 1,778,069개 그래프 에지.
원시 긴 프롬프트를 제공하는 대신 마이크로 스킬 게이트를 통해 변환된 28,612개 긴 스킬 본문.
스킬, 에이전트, MCP 및 하네스에 대한 엔티티 업데이트는 혜택/위험을 출력하고 명시적으로 업데이트를 승인하지 않으면 교체를 건너뜁니다.

존재 이유

발견 — 68,494개 스킬 페이지, 467개 에이전트, 10,790개 MCP 서버, 207개 하네스가 있으면 어떤 것이 존재하는지 또는 현재 작업에 적용되는지 알 수 없습니다.
컨텍스트 예산 — 모든 것을 로드하면 토큰이 낭비되고 품질이 저하됩니다. 세션당 올바른 10-15개가 필요합니다.
스킬 부패 — 몇 달 전에 설치하고 사용하지 않은 스킬이 컨텍스트를 어지럽히고 있습니다. 오래된 스킬은 자동으로 플래그 지정되어야 합니다.

예시 사용자 스토리

정식 QA 트래커는 docs/qa/feature-user-story-status.csv에 있습니다. 해당 트래커의 예시:

트래커 행	사용자 스토리	예상 ctx 동작
`CLI-002`	사용자로서 현재 저장소 추천을 ctx에 요청할 수 있습니다.	`ctx-recommend`는 공유 추천 엔진에서 관련 스킬, 에이전트 및 MCP 서버의 제한된 그래프 점수 번들을 반환합니다.
`CLI-026`	로컬/API 모델 사용자로서 하네스 추천을 받고 하나를 설치할 수 있습니다.	`ctx-harness-install --dry-run`은 모델/목표/도구/개인정보를 인터뷰하고 임계값 이상의 적합한 하네스를 추천하거나 적합하지 않은 경우 맞춤 하네스 PRD를 내보냅니다.
`API-011`	대시보드 사용자로서 엔티티를 수동으로 추가, 편집 또는 삭제할 수 있습니다.	`/api/entity/upsert` 및 `/api/entity/delete`는 유형, 슬러그 및 본문의 유효성을 검사한 다음 맹목적으로 변경하는 대신 안전한 그래프/위키 업데이트를 대기시킵니다.

설치

pip install claude-ctx
ctx-init                    # 터미널 마법사: 훅, 그래프, 모델, 하네스 목표
ctx-init --graph --hooks --model-mode skip  # 빠른 런타임 그래프 + Claude Code 훅
ctx-init --graph --graph-install-mode full  # 로컬에 전체 마크다운 위키 확장
ctx-init --wizard           # 스크립트/테스트에서 동일한 마법사 강제 실행
ctx-init --model-mode custom --model openai/gpt-5.5 --goal "build a CAD agent"

선택적 추가 기능: pip install "claude-ctx[embeddings]" (의미적 백엔드용), pip install "claude-ctx[harness]" (로컬/API 모델 하네스 실행용), pip install "claude-ctx[dev]" (테스트 도구 체인용).

사전 구축된 지식 그래프

그래프 기반 추천에는 사전 구축된 그래프가 필요합니다. 기본적으로 ctx-init --graph는 빠른 런타임 아티팩트를 설치합니다: 소스 체크아웃의 graph/wiki-graph-runtime.tar.gz 또는 pip 설치의 일치하는 GitHub 릴리스 에셋. 여기에는 graphify-out/*, 추천에 필요한 제공된 스킬 인덱스 및 ctx-harness-install에 필요한 207개 하네스 페이지가 포함됩니다:

ctx-init --graph

전체 LLM-위키 아티팩트는 로컬 브라우징, Obsidian 및 확장된 마크다운 페이지를 위해 계속 사용할 수 있습니다:

ctx-init --graph --graph-install-mode full

전체 wiki-graph.tar.gz에는 제공된 스킬 인덱스, entities/skills/ 아래의 68,494개 스킬 엔티티 페이지, converted/ 아래의 67,024개 수화된 설치 가능한 SKILL.md 파일 및 entities/harnesses/ 아래의 207개 하네스 페이지가 포함됩니다.

Windows: PowerShell의 내장 tar.exe는 --force-local을 지원하지 않습니다. tar -xzf graph\wiki-graph.tar.gz -C "$env:USERPROFILE\.claude\skill-wiki"를 사용하세요. Git Bash 또는 MSYS에서는 -C 대상이 C:/Users/...와 같은 드라이브 문자 경로인 경우에만 --force-local을 사용하세요.

사용법

ctx-init --hooks 또는 마법사 훅 단계 후에 ctx는 Claude Code의 PostToolUse 및 Stop 이벤트를 관찰합니다. 일반적인 흐름:

ctx-scan-repo --repo.     # 현재 저장소 스캔 및 신호 스택
ctx-scan-repo --repo. --recommend  # 스킬/에이전트/MCP 추천 포함
ctx-agent-add --agent-path./code-reviewer.md --name code-reviewer
ctx-harness-add --repo https://github.com/earthtojake/text-to-cad --tag cad
ctx-harness-install text-to-cad --dry-run   # 복제/실행 전 검사
ctx-harness-install text-to-cad             # 계획 검토 후 설치
ctx-harness-install text-to-cad --update --dry-run
ctx-harness-install text-to-cad --uninstall --dry-run
ctx-skill-quality list     # 모든 스킬에 대한 4-신호 품질 점수
ctx-skill-quality explain python-patterns   # 단일 스킬 상세 분석
ctx-skill-health dashboard # 구조적 건강 + 드리프트 감지
ctx-toolbox run --event pre-commit          # 현재 diff에 대한 council 실행
ctx-monitor serve          # 로컬 대시보드: http://127.0.0.1:8765/

푸시하기 전에 로컬 PR 게이트를 실행하세요:

python scripts/ci_preflight.py --profile pr

GitHub Actions와 동일한 변경 파일 분류기를 사용한 다음 일치하는 로컬 검사를 실행합니다: stats, ruff, mypy, pip check, unit coverage, canaries, package build, twine, docs, graph validation, browser 및 similarity gates. 릴리스 작업 전에 --profile full을 사용하여 문서 전용 또는 그래프 전용 변경에도 소스/패키지 게이트를 강제 실행합니다.

ctx-monitor 대시보드는 현재 로드된 스킬, 에이전트, MCP 서버, 설치된 하네스 레코드 및 일반 하네스 검증/에스컬레이션 상태를 보여줍니다. ctx가 라이브 작업을 소유하는 곳에 로드/언로드 버튼, 그래프 보기(/graph?slug=...), LLM-위키 엔티티 브라우저(/wiki/<slug>), 필터링 가능한 스킬 그리드, 세션 타임라인, 감사/런타임 로그 보기 및 라이브 SSE 이벤트 스트림을 제공합니다. 설치된 하네스 레코드는 /loaded에 나타납니다. 하네스 페이지는 /wiki 및 /graph에 나타납니다. 하네스 설치/업데이트/제거 작업은 ctx-harness-install에 남아 있습니다.

ctx-skill-add, ctx-agent-add, ctx-mcp-add 또는 ctx-harness-add가 기존 엔티티를 찾으면 ctx는 혜택/위험 업데이트 검토를 출력하고 기본적으로 교체를 건너뜁니다. 검토 후 카탈로그 또는 로컬 에셋 업데이트를 적용하려면 --update-existing와 함께 다시 실행하세요.

단계별 엔티티 온보딩: <https://stevesolun.github.io/ctx/entity-onboarding/>

전체 문서, 아키텍처 및 모든 모듈: <https://stevesolun.github.io/ctx/>

라이선스

MIT — LICENSE 참조.

원본 저장소: stevesolun/ctx

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.