Hyprlayer CLI

thoughts 관리 및 통합 메타데이터 스키마

Hyprlayer의 모든 thought는 plan, research, handoff, note, pr 중 하나의 type을 가지며 동일한 10개 표준 속성(title, type, date, status, ticket, project, scope, tags, author, related)을 따릅니다. git, obsidian 같은 파일 기반 백엔드에서는 YAML frontmatter로 저장되고, notion, anytype에서는 각 플랫폼의 데이터베이스 속성으로 저장됩니다. hyprlayer storage info --json 명령으로 현재 프로젝트의 백엔드와 스키마 계약을 확인할 수 있습니다.

스펙 기반 워크플로 명령

AI 에이전트와 함께 사용하는 슬래시 명령이 핵심 진입점입니다. /research_codebase로 기존 코드 동작을 문서화하고, /create_plan으로 단계별 구현 계획을 만들며, /iterate_plan으로 피드백을 반영해 계획을 다듬습니다. 이후 /implement_plan이 계획을 단계별로 실행하고 /validate_plan이 성공 기준을 검증합니다. /commit은 사용자 승인 하에 원자적 커밋을 만들고, /code_review는 codex CLI가 있으면 codex로, 없으면 Claude 서브에이전트로 현재 브랜치의 diff를 적대적으로 리뷰합니다. 마지막으로 /describe_pr이 브랜치 변경 사항으로부터 PR 설명을 생성합니다.

다중 스토리지 백엔드

thoughts는 init 시점에 네 가지 백엔드 중 하나를 선택해 저장합니다. 기본값은 별도 git 저장소이며 hyprlayer thoughts sync로 동기화합니다. Obsidian 백엔드는 로컬 볼트를 직접 사용하고(–vault-path 필요) 동기화는 하지 않습니다. Notion 백엔드는 에이전트 도구의 Notion 커넥터를 사용하며 hyprlayer가 토큰을 관리하지 않고, Anytype 백엔드는 MCP 서버를 자동 등록하므로 Anytype 데스크톱 앱과 ANYTYPE_API_KEY가 필요합니다. 두 백엔드 모두 대상 데이터베이스/오브젝트 타입은 첫 쓰기형 슬래시 명령에서 지연 생성됩니다.

오케스트레이션 검증 및 스케줄링

hyprlayer orchestrate는 스킬 파일의 orchestration: 블록을 데이터로 다루는 검증·계획 도구이며 실행 엔진이 아닙니다. check는 스킬에 대해 6가지 정적 검사를 수행해 훅이나 에디터에서 안전하게 호출할 수 있고, compile은 단계의 when: 가드를 해소해 웨이브 스케줄을 JSON으로 출력합니다. 같은 블록, 같은 저장소 상태, 같은 요청, 같은 fanout 수라면 planHash까지 동일한 결정적 결과물을 생성합니다.

에이전트 번들 설치 및 관리

1.6.0부터 Claude와 Codex용 스킬·에이전트·훅은 각 GitHub 릴리스에 hyprlayer-assets-{claude,codex}-<version>.tar.gz로 첨부되어 SHA256으로 검증 후 설치됩니다. 1.5.x 계열에서도 번들은 ~/.config/hyprlayer/agents/<version>/{claude,codex}에 보관되며 Claude는 ~/.claude/skills, Codex 호환 스킬은 ~/.agents/skills와 ~/.codex/skills에 링크됩니다. hyprlayer ai reinstall로 특정 버전 고정, 해제, 강제 재설치를 할 수 있고 hyprlayer ai status로 현재 버전과 핀 상태를 확인할 수 있습니다.

설치 및 시작하기

Windows에서는 winget을 통해 winget install --id BrightBlock.Hyprlayer --exact로 설치할 수 있습니다. 설치 후 프로젝트 디렉터리에서 hyprlayer thoughts init을 실행하면 thoughts가 초기화되고, 첫 hyprlayer 실행 시 Claude Code와 Codex 자산이 자동으로 프로비저닝됩니다. 이후 AI 에이전트 세션에서 /research_codebase, /create_plan 등 슬래시 명령을 호출해 워크플로를 시작합니다.

활용 예시

• 새 프로젝트의 구현 방향을 단계별 success criteria가 포함된 plan으로 정리해 AI 에이전트와 함께 진행할 때
• 기존 코드베이스를 /research_codebase로 문서화한 뒤, Notion 또는 Obsidian 볼트에 research·handoff 노트로 축적해 팀 지식으로 공유할 때
• 장기 작업을 /create_handoff로 핸드오프 문서로 남기고, 다음 세션에서 /resume_handoff로 이어 받아 재현성 있게 진행할 때
• PR을 올리기 전 /code_review로 현재 브랜치를 적대적으로 리뷰하고, /describe_pr로 PR 설명을 자동 생성할 때

제한·라이선스·확인사항

Hyprlayer CLI는 MIT 라이선스로 배포되며 소스 저장소는 GitHub의 brightblock/hyprlayer-cli에 공개되어 있습니다. 기본값으로 익명 사용 지표가 수집되며, 비활성화는 hyprlayer telemetry off로 설정할 수 있습니다. autoUpdate는 ~/.config/hyprlayer/config.json에서 명시적으로 켠 경우에만 동작하며, Windows의 install.ps1 경로에서만 자동으로 업그레이드를 수행하고 그 외 패키지 관리자에서는 hyprlayer self-update를 명시적으로 실행해야 합니다. 컨트리뷰터는 첫 PR 머지 전 CLA 서명이 필요합니다.