Build from source
Build Krad ADE from source and run it on macOS, Windows or Linux.
Issues and pull requests are welcome on GitHub. Every change follows the engineering guide in CLAUDE.md; Checks summarises it.
Requirements
All platforms need:
- The Rust toolchain pinned in
rust-toolchain.toml, a nightly.rustupinstalls it on the first build. gitonPATH, for groups, worktrees and the file tree.- At least one harness installed as usual and signed in, or a Gateway.
The pinned toolchain and git are enough.
Harnesses
| Harness | Requirement |
|---|---|
| Claude Code | claude on PATH |
| opencode v2 | opencode on PATH; 1.x is not supported |
| Codex | codex on PATH, signed in with codex login |
| A Gateway such as CLIProxyAPI | Set in Settings › Gateway |
Build and run
Clone the repository
git clone https://github.com/joordih/krad-ade.git
cd krad-adeBuild and start the app
cargo run --release -p krad-app --bin krad-adeThe release build places krad-ade-agents next to krad-ade. The app puts its own folder on the PATH of every terminal it opens, which is how agents find the bus CLI.
The console krad-ade-agents CLI also builds without the desktop feature as a static musl binary for SSH hosts:
just agents-linuxPackages
| Platform | What | Where |
|---|---|---|
| Windows | Inno Setup installer with the app icon | installer/krad-ade.iss |
| Linux | Desktop entry and icons from 16 to 1024 px | packaging/linux, packaging/icon/png |
| macOS | Info.plist and .icns icon of Krad ADE.app | packaging/macos |
| All | Install marker and public key of in-app updates | packaging/update |
All icons come from one source, packaging/icon/krad-ade-logo.png. This command regenerates the PNG, ICO and ICNS files and the README banner:
python3 packaging/icon/generate_icons.pyLicense
Krad ADE is licensed under either of the Apache License, Version 2.0 or the MIT license, at your option. Unless stated otherwise, a contribution intentionally submitted for inclusion is dual licensed the same way, without additional terms or conditions.