설치와 첫 동기화

플랫폼에 맞는 한 줄을 실행한 뒤 처음 실행으로 넘어가면 됩니다. 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 없이 설치하려면 최신 릴리스에서 아키텍처에 맞는 tarball을 받아 gadak을 PATH에 두면 됩니다.

Windows

데스크톱 앱은 Microsoft Store에 있습니다. Store가 서명해 주므로 SmartScreen도 Smart App Control도 막지 않고, 업데이트도 Store가 해 줍니다.

CLI는 최신 릴리스에서 gadak_<version>_windows_amd64.zip(또는 windows_arm64)을 받아 풀고 gadak.exe를 PATH에 두세요.

릴리스의 데스크톱 zip(Gadak-<version>-windows-x64.zip)은 여전히 서명이 없어서 SmartScreen이나 Smart App Control이 막을 수 있습니다. 바이러스가 검출된 것이 아니라 서명이 없다는 경고이므로, 막히면 Store에서 설치하세요. 자세한 내용과 sha256 확인 방법: WINDOWS-SIGNING.md.

처음 실행

회사 Jira 사이트에 연결합니다. 사이트, 이메일, API 토큰, 캐시할 프로젝트를 차례로 묻습니다. Server와 Data Center는 gadak init --server로 붙습니다(11.x에서 실측):

gadak init && gadak serve

계정 없이 내장 트래커로 시작하려면:

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

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

화면은 영어·한국어·일본어로 뜹니다. 브라우저 언어를 따르고, 설정에서 바꿀 수 있습니다.

무엇을 캐시할지

캐시할 범위는 직접 고릅니다. 설치했다고 사이트 전체를 내려받지는 않습니다. Confluence 위키는 켜기 전까지 꺼져 있고, 켤 때 스페이스를 지정합니다:

gadak init --spaces ENG,PROD

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

에이전트 연결

Claude Code용 스킬을 설치합니다:

gadak skill install

Claude Desktop에는 MCP 서버를 등록합니다:

gadak mcp install claude-desktop

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