Install

Pick your platform, run one line, then first run. Connecting to an Atlassian site needs one API token, which covers Jira and Confluence on the same site. The built-in tracker needs no account at all.

macOS

The desktop app, CLI included:

brew install --cask midagedev/tap/gadak

CLI only. The same UI opens in a browser tab via gadak serve:

brew install midagedev/tap/gadak-cli

No Homebrew? The latest release has a signed, notarized Gadak-<version>-arm64.dmg.

Linux

brew install midagedev/tap/gadak-cli

Without Homebrew: grab the tarball for your arch from the latest release and put gadak on PATH.

Windows

The desktop app is on the Microsoft Store. The Store signs it, so neither SmartScreen nor Smart App Control gets in the way, and it updates through the Store.

For the CLI, download gadak_<version>_windows_amd64.zip (or windows_arm64) from the latest release, unzip, and put gadak.exe on PATH.

The release's desktop zip (Gadak-<version>-windows-x64.zip) is unsigned. If SmartScreen or Smart App Control blocks it, that is the missing signature, not a virus finding. Install from the Store instead, and do not turn Smart App Control off. Details and how to check the sha256: WINDOWS-SIGNING.md.

First run

Connect to your team's Jira site. It asks for the site, your email, an API token and the projects to mirror. Server and Data Center connect with gadak init --server (measured on 11.x):

gadak init && gadak serve

Or start on the built-in tracker, with no account at all:

gadak init --local
gadak create "the thing I just noticed"
gadak serve

Either way, gadak serve prints the address. Open http://gadak.localhost:7777 and you should see your issues. That is the whole verification.

The UI is in English, Korean or Japanese. It follows your browser language, and Settings switches it.

What it mirrors

You choose the scope, and nothing pulls a whole site down by default. The Confluence wiki is off until you ask for it, and when you do you name the spaces:

gadak init --spaces ENG,PROD

Jira narrows the same way: --projects ENG,PROD, and blank means every project the account can see. Both are also a picker in Settings → Sources, so a scope you set now is one you can widen later without re-running anything.

For agents

Install the skill for Claude Code:

gadak skill install

For Claude Desktop, register the MCP server:

gadak mcp install claude-desktop

What the agent can do from there: AGENT_SETUP.md.