← Back to overview
Install
Install IDACC with the compatible ID Agents manager.
Run three commands. The installer builds the desktop app, installs or safely updates the compatible manager, keeps it running, and connects IDACC to it. Then complete team setup from HR Manager.
IDACC: Latest release or main branch from GitHub
ID Agents manager: Latest compatible fork from GitHub
Source check: Release and changelog links remain available below
The inline launcher below can also be pasted into another website to point operators back to idacc.bittrees.org.
Terminal
git clone https://github.com/bobofbuilding/idacc.git ~/Projects/idacc-stack/idacc
cd ~/Projects/idacc-stack/idacc
node scripts/install-idacc-stack.mjs
Want to inspect it first?
node scripts/install-idacc-stack.mjs --dry-run
Requires macOS, Git, and Node.js 20 or newer. Existing settings and local manager work are preserved.
- Clones IDACC and clones or fast-forwards the compatible ID Agents fork from
main. - Refuses dirty worktrees, foreign remotes, unexpected branches, and non-fast-forward updates.
- Installs each package through its lockfile with
npm ci. - Builds the desktop app, installs the TUI, and compiles the manager.
- Installs the app atomically into
~/Applicationsand merges its local manager profile without replacing existing settings. - Runs the manager as a persistent per-user launch service and never takes over an unknown existing process.
website-launcher.html
<a href="https://idacc.bittrees.org"
style="display:inline-flex;align-items:center;gap:10px;padding:12px 14px;border:1px solid #1f4f46;border-radius:8px;background:#071312;color:#f5fbf8;text-decoration:none;font:600 14px system-ui,sans-serif">
<span style="display:grid;place-items:center;width:28px;height:28px;border-radius:6px;background:#35d19f;color:#071312;font-weight:800">ID</span>
<span>Manage agents with IDACC</span>
</a>