Get Adduce

How to install

The CLI and the daemon, for Linux and Windows on x86-64 and for Apple Silicon macOS. One command installs it, one connects your agent, and everything below is for a machine that needs something else.

1Install

$ curl --proto '=https' --tlsv1.2 -sSf https://adduce.dev/install.sh | sh

2Tell Claude Code about it

$ claude plugin marketplace add https://api.adduce.dev/releases/marketplace.json$ claude plugin install adduce@adduce

Registers the tools and the backed-research skill together. Cursor, Zed and anything else speaking MCP run adduce-daemon --mcp instead.

The script reads the release manifest, checks the download against the SHA-256 published with it, installs into ~/.adduce/bin and hooks your shell. Files it does not ship are left alone, so a reinstall keeps a provisioned PDF backend. Already have Adduce somewhere else? adduce migrate moves it and deletes nothing.

Or hand it to your agent

Paste this into your agent

Install Adduce on this machine.

Run the installer for my platform:

  curl --proto '=https' --tlsv1.2 -sSf https://adduce.dev/install.sh | sh     # macOS and Linux
  powershell -c "irm https://adduce.dev/install.ps1 | iex"                     # Windows

It reads the release manifest, verifies the download against the SHA-256 published with it, installs into ~/.adduce/bin and hooks my shell. Do not build from source: the workspace vendors RocksDB and ONNX Runtime, and a cold build takes tens of minutes. If it reports a missing shared library, install the package it names and run it again.

If Adduce is already installed somewhere else on this machine, run "adduce migrate" instead. It moves the install to ~/.adduce/bin, deletes nothing, and is safe to run twice.

Then, in a shell that has picked up the new PATH:

1. Run "adduce login" and show me the code and URL it prints, then wait for it to finish signing in.
2. Run "adduce license sync" to fetch this account's licence and store it. If it reports that the account has no paid plan, tell me and stop.
3. Run "adduce doctor" and show me the output.

If the installer refuses my platform, stop and tell me rather than substituting a different target. https://api.adduce.dev/releases/AGENTS.md is the full contract if you need it.

Or download the archive

Linux · x86-64

.tar.gz · 39 MB

Download 0.3.7

macOS (Apple Silicon) · x86-64

.tar.gz · 32 MB

Download 0.3.7

Windows · x86-64

.tar.gz · 51 MB

Download 0.3.7

By hand

  1. Unpack the archive. It is a .tar.gz on both platforms; Windows 10 and 11 unpack it with tar -xf and need nothing installed.
  2. Put adduce and adduce-daemon on your PATH, and keep the whole unpacked tree together. On Windows both take a .exe suffix and DirectML.dll sits beside them; on Linux libonnxruntime.so.1 does, and neither binary starts without it.
  3. Run adduce login. It prints a code, you enter it here, and the machine is signed in. Nothing else needs configuring.
  4. The OCR and ML workers need uv on first use.

First run

After the installer, in a shell that has picked up the new PATH. Your agent does this too, and the prompt above tells it to.

  1. adduce login

    Prints a code and a URL. Approve it in the browser and the machine is signed in. This proves who you are; it does not by itself grant a licence.

  2. adduce license sync

    Fetches this account's licence and stores it in the OS keychain, or in a file only you can read when the keychain cannot be unlocked. Run it after subscribing, and again on every other machine you work from. An account with no paid plan is told so rather than handed a token.

  3. adduce doctor

    Reports the state of every subsystem and names the command that repairs each one it finds unready. It runs even when the licence is denied, which is exactly when it is wanted.

  4. adduce cite add 10.1103/PhysRevLett.116.061102

    Puts the first paper in the library, by DOI. arXiv ids, a PDF on disk, a research blog and your own repositories go in the same way.

Already installed

Update Adduce on this machine.

Run "adduce update", then "adduce doctor", and show me both outputs. If the update reports that it is already current, say so and stop.

Current release 0.3.7. An installed daemon updates itself, so this is only needed once.