Install

Pick your platform, run one line, then first run. Connecting to an Atlassian site needs one API token (it covers Jira and Confluence on the same site) — standalone mode needs no account at all.

macOS

The desktop app, CLI included:

brew install --cask midagedev/tap/gadak

CLI only — same UI 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

From the latest release, download gadak_<version>_windows_amd64.zip (or windows_arm64), unzip, put gadak.exe on PATH. This is the reliable route.

The desktop zip (Gadak-<version>-windows-x64.zip) is currently unsigned — if SmartScreen or Smart App Control blocks it, that is the missing signature, not a virus finding; use the CLI zip above. Details and how to check the sha256: WINDOWS-SIGNING.md.

First run

Connect to your team's Jira (asks for site, email, token, projects):

gadak init && gadak sync && gadak serve

Or start with no tracker at all:

gadak init --standalone
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.

What it mirrors

You choose, and nothing pulls a whole site down because you installed it. 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, 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

Hand the same mirror to your coding agent:

gadak skill install

For MCP clients without a shell (Claude Desktop):

claude mcp add gadak -- gadak mcp

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