TL;DR

레포는 standalone tool로 로컬에서 브라우저 기반 이슈 보드를 구동하며 Node.js 22.5 이상이 필요합니다. React UI와 taskctl CLI가 동일한 HTTP API를 사용하고 SQLite 데이터는 .data/taskboard.sqlite에 저장되므로 로컬 퍼스트 워크플로우를 유지할 수 있습니다. Codex용 Skill과 injector/launcher로 Codex 앱 내부에 사이드바 항목을 삽입할 수 있고 권장 방식은 별도 Codex 인스턴스에 CDP로 연결하는 방법입니다. 기본 LAN 모드는 인증을 제공하지 않으며 Cloudflare 기반 클라우드 배포 문서가 포함되어 있어 공개 배포 시 별도 인증 구성이 필요합니다.

핵심 포인트

• 레포는 standalone tool로 브라우저에서 로컬 우선 이슈 보드를 실행하며 Node.js 22.5 이상에서 동작합니다. 실행 절차는 npm install, npm run build, npm start로 간단하고 기본 HTTP 포트는 47823이며 데이터는 .data/taskboard.sqlite에 SQLite로 저장됩니다. 이 구조는 네트워크 없이도 로컬에서 완전한 작업 흐름을 유지하면서 파일 시스템 기반 프로젝트 매핑과 빠른 복구를 가능하게 합니다.
• React 기반 웹 UI와 taskctl CLI가 동일한 HTTP API를 통해 작동하므로 동일한 백엔드로부터 UI와 스크립트 양쪽을 제어할 수 있습니다. 개발 중에는 Vite(포트 5173)를 프론트엔드 핫리로드용으로 사용하고 API 요청은 로컬 서비스로 프록시되며 taskctl 예시 명령은 프로젝트 생성·이슈 생성 같은 일반 워크플로우를 자동화하는 방법을 보여줍니다. 이 통합은 로컬 개발 반복성을 높이고 CI/CD 없는 소규모 팀에서 빠르게 도입할 수 있는 실용적 이점을 제공합니다.
• Codex 통합은 skills/manage-taskboard를 Codex 스킬 디렉터리에 심볼릭 링크하거나 injector/launcher 스크립트를 통해 Codex 윈도우에 사이드바 항목을 삽입하는 방식으로 구현됩니다. 권장 워크플로우는 별도 Codex 인스턴스를 CDP로 띄워 injector를 실행하는 것이며 대안으로 standalone launcher로 Codex를 재시작해 Taskboard를 OOPIF로 로드하는 방법도 제공합니다. 통합은 Codex의 프로젝트, composer, route bridge를 활용하고 React 패치나 파일 변경 같은 침습적 조작을 하지 않으므로 기존 Codex 환경을 건드리지 않고 임베드 기능을 추가할 수 있습니다.
• 협업·배포 측면에서 기본 LAN 모드는 인증을 제공하지 않으므로 같은 신뢰 네트워크 내의 사용자는 읽기·쓰기가 가능하다는 보안 제약이 있습니다. README는 Cloudflare Workers + D1 + R2를 이용한 클라우드 배포 옵션을 제시하며 이 경우 HTTPS Basic Auth와 기기별 로컬 경로 매핑, 단일 권위 데이터베이스(D1)를 사용하는 동작 방식을 따릅니다. 따라서 소규모 로컬 팀이나 개인용으로는 즉시 유용하지만 공개 인터넷에 노출하려면 인증 경계와 비밀번호 회전 같은 추가 보안 구성이 필요합니다.