프로젝트 단위로 이슈를 관리하는 트래커입니다. Linear에서 영감을 받은 칸반 보드 위에, AI 에이전트가 MCP 프로토콜로 직접 이슈를 읽고 쓸 수 있는 구조를 얹었습니다.
사람은 브라우저에서 드래그앤드롭으로 이슈를 옮기고, AI는 터미널에서 이슈를 생성하고 PR을 연결합니다. 같은 프로젝트, 같은 데이터, 같은 상태를 공유합니다.
기존 이슈 트래커들은 사람만 쓴다고 설계되어 있습니다. AI 에이전트가 이슈를 다루려면 브라우저 자동화나 API 스크래핑에 의존해야 하죠.
Hinear은 처음부터 AI가 일급 사용자인 이슈 트래커입니다. MCP(Model Context Protocol) 서버가 내장되어 있어서, Claude Code, Cursor, Copilot 같은 AI 도구가 네이티브로 이슈와 상호작용합니다.
personal과 team 프로젝트를 만들고, 프로젝트마다 독립된 이슈 네임스페이스를 갖습니다. WEB-1, API-42 같은 프로젝트 키 기반 식별자로 이슈를 구분합니다.
Linear 스타일의 드래그앤드롭 칸반 보드. 상태 흐름:
Triage → Backlog / Todo → In Progress → Done
이슈를 클릭하면 drawer로 빠르게 보거나, 풀 페이지로 상세 내용을 확인할 수 있습니다.
AI 에이전트가 18개의 MCP 툴로 Hinear 이슈 시스템에 직접 접근합니다:
| 영역 | 할 수 있는 것 |
|---|---|
| 이슈 | 검색, 생성, 상태 변경, 상세 조회 |
| 라벨 | 생성, 수정, 삭제 |
| 멤버 | 조회, 초대, 역할 변경, 제거 |
| 배치 | 최대 100개 이슈 동시 업데이트 |
| GitHub | 브랜치 생성, 이슈/PR 연동 |
"이슈 만들어줘", "진행 중인 이슈 보여줘" 같은 자연어 요청이 바로 실행됩니다.
이슈에서 GitHub 브랜치를 바로 생성하고, PR을 올리면 자동으로 이슈 상태를 in_review로 변경합니다. PR이 merge되면 done으로. AI 에이전트가 이 흐름을 자동으로 수행합니다.
브라우저에 설치해서 앱처럼 쓸 수 있습니다. Firebase Cloud Messaging으로 실시간 푸시 알림을 받습니다.
┌───────────┐ ┌───────────┐ ┌──────────────┐
│ 사람 │ │ AI 에이전트│ │ GitHub / CI │
│ 브라우저 │ │ 터미널 │ │ 웹훅 │
└─────┬─────┘ └─────┬─────┘ └──────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌──────────────┐
│ hinear-web│ │ hinear-mcp│ │hinear-harness│
│ Next.js │ │ MCP Server│◄──│ 웹훅 브릿지 │
│ 칸반 보드 │ │ 18개 툴 │ │ │
└─────┬─────┘ └─────┬─────┘ └──────┬───────┘
│ │ │
└───────────────┼────────────────┘
▼
┌─────────────┐
│ Supabase │
│ PostgreSQL │
│ RLS 보안 │
└─────────────┘
hinear-web은 사람을 위한 웹 인터페이스, hinear-mcp는 AI를 위한 툴 서버, hinear-harness는 GitHub/AI 이벤트를 Hinear로 브릿지합니다. 세 서비스가 하나의 Supabase 데이터베이스를 공유합니다.
| 레이어 | 기술 |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS v4, TipTap, Framer Motion |
| Database | Supabase PostgreSQL + Row Level Security |
| State | @tanstack/react-query |
| AI Protocol | MCP (Streamable HTTP) |
| GitHub | Octokit REST API |
| Notifications | Firebase Cloud Messaging, Service Worker |
| Testing | Vitest, Testing Library |
| Deploy | Vercel (web), Railway (mcp), Docker |
hinear/
├── hinear-web/ → 사용자 웹 앱 [README](./hinear-web/README.md)
├── hinear-mcp/ → AI용 MCP 서버 [README](./hinear-mcp/README.md)
└── hinear-harness/ → GitHub 웹훅 브릿지 [README](./hinear-harness/README.md)
각 프로젝트의 README에 상세 설정, 명령어, 구현 TODO가 있습니다.
- 프로젝트 생성/관리 (personal, team)
- 칸반 보드 이슈 관리
- AI 에이전트로 이슈 CRUD
- GitHub 브랜치/PR 연동
- 멤버 초대 및 역할 관리
- 라벨 관리
- PWA 설치
- 실시간 알림 (푸시/이메일)
- @멘션 시스템
- 낙관적 잠금 (동시 편집 충돌 해결)
- 이슈 템플릿
- 고급 필터링
- 이슈 관계 (하위 태스크, 의존성)
- 양방향 GitHub 동기화
- 대시보드/리포트
- 다크 모드
- 이슈 내보내기/가져오기
- 주간 요약 리포트
- 실시간 협업 편집