이슈, 댓글, 위키를 한 검색창에서
이슈 제목과 본문, 댓글, 위키 문서를 한 검색창에서 찾습니다. 단어를 다 치기 전에 결과가 나옵니다. 캐시에서 찾기 때문에 서버 응답을 기다리지 않습니다.
gadak
묵은 Jira 이슈를 Claude Code로 찾아봅니다.
지라를 쓰기 싫은데 어쩔 수 없이 써야 해서 만들었습니다. 묵은 이슈들을 클로드로 뒤지다가 한참 걸리고 결국 rate limit에 걸려 중단된 적이 있는데, 그때 시작했습니다. 크롬에 지라 탭이 잔뜩 쌓여 피곤해지는 것도 겸사겸사 없애고 싶었고요. 필요한 Jira 프로젝트와 Confluence 스페이스만 골라 캐시해 두고, 검색과 이슈 조회는 거기서 합니다. 직접 찾아도 되고, Claude Code에 맡겨도 됩니다.
설치 macOS 앱은 Homebrew로, Windows 앱은 Microsoft Store에서. Linux는 CLI를 설치하고 gadak serve로 브라우저에서 씁니다. 라이브 데모 이슈 534건이 들어 있는 데모를 브라우저에서 바로 엽니다. 설치도 계정도 필요 없습니다.
검색
Claude Code에 맡기기
스킬 하나면 Claude Code가 같은 캐시를 읽습니다
스킬을 설치하면 Claude Code가 gadak CLI로 이슈를 찾고, 만들고, 상태를 옮깁니다. 스킬에는 한국어 계정에서 에이전트가 자주 빠지는 함정도 적어 두었습니다. Jira는 상태와 우선순위 이름을 계정 언어로 번역합니다. 그래서 영어 이름으로 물으면 오류 없이 빈 결과가 돌아오고, 에이전트는 그걸 "그런 이슈는 없다"로 읽습니다. 에이전트가 남긴 댓글과 만든 이슈에는 에이전트 이름이 붙습니다. 에이전트는 읽은 내용을 자기 모델로 보냅니다. 캐시 범위는 그걸 감안해 정하세요.
도구별 연결 방법 → docs/AGENT_SETUP.md
녹화 더 보기: 대시보드, 팀 테마, 런처, MCP 세션 → docs/SHOWCASE.md
폰 앱
같은 캐시를 폰에서 베타
아이폰 앱은 이미 돌리고 있는 gadak serve에 페어링한다. 자기 네트워크 안에서 끝나고, 중간에 계정도 남의 서버도 없다. 캐시가 가진 것은 폰도 보여준다 — 필드, 첨부, 연결된 이슈, 위키, 진행 중인 스프린트와 그 뒤의 전부. 한 줄로 끝나는 수정은 폰에서 끝난다. 코멘트, 라벨, 마감일, 사진, 에픽 밑에 새 이슈. 쓰기는 데스크톱과 똑같이 원본을 먼저 통과한다. 페이지나 커스텀 필드 편집, 뷰 작성, 대시보드 배치, 카드 끌기는 데스크톱 몫이고, 앱이 그 컨트롤 자리에서 그렇게 말한다.
베타이고 상태는 그게 전부다. 빌드는 내부 테스터용 TestFlight 로만 가고 공개 다운로드는 없다. 스토어 등록은 심사자가 내 네트워크에 들어오지 않고도 앱을 볼 수 있는 경로가 먼저다.
잰 값
Jira API에 물을 때와 캐시에 물을 때
| Jira REST API | gadak | ||
|---|---|---|---|
| 텍스트 검색 | 543 ms | 41 ms | 13× |
| 에픽별 열린 이슈 (GROUP BY) | 4,761 ms | 22 ms | 214× |
2026-08-26에 실제 Atlassian Cloud 업무 프로젝트(이슈 3,296건)에서 잰 중앙값입니다. 에픽별 열린 이슈는 REST API 쪽이 응답 8페이지를 받아 합산한 값이고, gadak 쪽은 쿼리 한 번에 CLI 프로세스가 뜨는 시간까지 넣은 값입니다. 첫 전체 동기화는 그 사이트에서 3.7분 걸렸고(2026-09-09 측정), 그 뒤로 캐시는 동기화 주기만큼 늦습니다. 측정 방법과 나머지 행: docs/BENCHMARKS.md.
연결하기 전에
회사 데이터를 두고 쓰는 도구라서, 먼저 알아야 할 것
- 어느 Jira인가. Atlassian Cloud는 API 토큰으로, Jira Server와 Data Center는
gadak init --server와 개인 액세스 토큰으로 붙습니다. Cloud는 토큰 하나로 같은 사이트의 Jira와 Confluence를 함께 가져오고, Confluence Server는 아직 클라이언트가 없어서 Server 워크스페이스는 이슈만 가져옵니다. - 얼마나 가져오나.
--projects로 고른 프로젝트만, 내 계정이 이미 볼 수 있는 만큼만 가져옵니다.--spaces로 스페이스를 지정하기 전에는 위키를 건드리지 않습니다. - 어디에 남나. 이 컴퓨터 안의 SQLite 파일 하나입니다. 처음 한 번은 전체 동기화가 필요하고, 그 뒤로는 동기화 주기만큼 늦습니다. 지워도 되고, 다시 동기화하면 그대로 돌아옵니다.
- 밖으로 나가는 것. 텔레메트리도, 분석 도구도, gadak 계정도 없습니다. 직접 설정한 곳에만 연결하고, 읽기는 그 파일에서 합니다. Jira에 직접 묻는 것은 네 가지뿐입니다. 첨부파일 보기,
gadak issue --editmeta,gadak fields,gadak api. - 토큰은 어디에.
~/.gadak/config.json에0600으로 두고, 내 사이트에만 보냅니다. 캐시에도, 로그에도, 스냅샷에도 남지 않습니다. - 쓰기는 어떻게. Jira로 먼저 갑니다. Jira가 받아들이면 캐시를 갱신하고, 거절하면 그 자리에서 실패합니다. 캐시에 쌓아 두고 나중에 보내는 일은 없습니다.
- 에이전트를 붙이면. 캐시를 읽은 에이전트는 읽은 내용을 자기 모델로 보냅니다. gadak 자신은 아무 데도 보내지 않습니다. 에이전트에게 보여도 되는 범위만 가져오세요.
밖으로 나가는 연결 전체와 그 조건 → SECURITY.md
연결마다 끄는 방법 → docs/NETWORK.md
설치
설치와 첫 동기화
데스크톱 앱(CLI 포함):
brew install --cask midagedev/tap/gadakCLI만:
brew install midagedev/tap/gadak-cliWindows 데스크톱 앱은 Microsoft Store에 있습니다.
회사 Jira Cloud에 연결합니다. 사이트 주소, 이메일, API 토큰, 캐시할 프로젝트를 차례로 묻습니다. 위키까지 캐시하려면 --spaces를 붙입니다:
gadak init && gadak serve동기화가 끝나면 Claude Code용 스킬을 설치합니다:
gadak skill installClaude Desktop에는 MCP 서버를 등록합니다:
gadak mcp install claude-desktop 어디까지 왔는지
0.24, 만드는 사람 한 명, Apache-2.0
- 버전 0.24, 아직 0.x입니다. 동기화, 읽기 API, Jira를 먼저 거치는 쓰기, 데스크톱·웹·CLI·MCP를 실제 사이트에서 확인했습니다.
- 캐시는 평범한 SQLite 파일입니다. gadak이 내일 사라져도 그 파일은 아무 SQLite 클라이언트에서나 열리고, 이슈는 그대로 들어 있습니다.
- 스프린트 계획, Jira 대시보드와 알림, 관리자 작업, 1분의 지연도 안 되는 일은 Jira에서 계속 합니다.
- Atlassian Cloud, Jira Server와 Data Center, Linear, 내장 트래커에서 같은 명령을 씁니다. 서비스별로 되는 것과 안 되는 것은 셀마다 직접 실행해서 표 하나에 적어 두었습니다.
서비스별 지원 범위 · 자주 묻는 질문 · 무엇이 나왔는지 · GitHub
써 보셨다면
한 줄 남겨 주세요
텔레메트리가 없어서 누가 쓰는지 저는 모릅니다. 어디에 썼는지, 그 뒤로도 쓰고 있는지 한 줄만 알려 주세요.
공개된 곳에는 실제 이슈 내용과 토큰, 사이트 주소를 빼고 적어 주세요.