설치

플랫폼 골라 한 줄 실행하고, 처음 실행으로 넘어가면 됩니다. Atlassian 사이트에 연결하려면 API 토큰 하나면 되고 (같은 사이트의 Jira·Confluence를 함께 커버합니다), 스탠드얼론 모드는 계정 자체가 필요 없습니다.

macOS

데스크톱 앱, CLI 포함:

brew install --cask midagedev/tap/gadak

CLI만 — 같은 UI를 브라우저 탭에서 gadak serve로:

brew install midagedev/tap/gadak-cli

Homebrew가 없다면 최신 릴리즈의 Gadak-<version>-arm64.dmg(서명·공증 완료)를 받으면 됩니다.

Linux

brew install midagedev/tap/gadak-cli

Homebrew 없이: 최신 릴리즈에서 아키텍처에 맞는 타볼을 받아 gadak을 PATH에 두면 됩니다.

Windows

최신 릴리즈에서 gadak_<version>_windows_amd64.zip(또는 windows_arm64)을 받아 풀고 gadak.exe를 PATH에 두세요. 이 경로가 가장 확실합니다.

데스크톱 zip(Gadak-<version>-windows-x64.zip)은 아직 미서명이라 SmartScreen이나 Smart App Control이 막을 수 있습니다 — 바이러스 검출이 아니라 서명 부재 경고이니, 그 경우 위의 CLI zip을 쓰세요. 자세한 내용과 sha256 확인 방법: WINDOWS-SIGNING.md.

처음 실행

회사 Jira에 연결 (사이트·이메일·토큰·프로젝트를 차례로 묻습니다):

gadak init && gadak sync && gadak serve

또는 트래커 없이 시작:

gadak init --standalone
gadak create "방금 생각난 일"
gadak serve

어느 쪽이든 gadak serve가 주소를 출력합니다 — http://gadak.localhost:7777을 열어 이슈가 보이면 설치 검증 끝입니다.

무엇을 미러링할지

직접 고릅니다. 설치했다는 이유만으로 사이트 전체를 내려받는 일은 없습니다. Confluence 위키는 요청하기 전까지 꺼져 있고, 켤 때는 스페이스를 지정합니다:

gadak init --spaces ENG,PROD

Jira도 같은 방식입니다 — --projects ENG,PROD, 비워 두면 계정이 볼 수 있는 모든 프로젝트. 둘 다 설정 → 소스에 픽커가 있어서, 지금 좁게 잡아 둔 범위를 나중에 무엇도 다시 실행하지 않고 넓힐 수 있습니다.

에이전트 연결

같은 미러를 코딩 에이전트에게 넘기려면:

gadak skill install

셸이 없는 MCP 클라이언트(Claude Desktop)에는:

claude mcp add gadak -- gadak mcp

연결 후 에이전트가 할 수 있는 일: AGENT_SETUP.md.