Skip to content
Khiip Khiip Khiip

Activate Khiip Plus

Khiip Plus adds the platform-styled renders and the deeper per-source extraction on top of the free core. It’s an add-on to the free Khiip you already run, not a separate app — so turning it on means putting three things in the same place:

  1. the free Khiip core (you may already have this)
  2. the Plus add-on package (khiip-ee) — private, not on public PyPI
  3. your license key — emailed to you when you start your subscription

Everything is verified locally — your key is checked offline, and Khiip never phones home to activate it.

1. Make sure the core is installed

If you haven’t installed Khiip yet, do that first — see Installation. Note how you installed it (plain pip, pipx, or uv tool); the add-on must go into the same environment, and the command differs per method (step 3).

2. Download the Plus add-on

The add-on ships as a Python wheel. The download link is in your Khiip Plus key email — the same email that carries your license key, sent when you start your subscription. The link is tied to your subscription, so keep it private. The file is named like:

khiip_ee-<version>-py3-none-any.whl

Download it somewhere handy (e.g. ~/Downloads). Use the version that matches your installed core (khiipd version prints the core version).

3. Install the add-on into the same environment

Run the line that matches how you installed Khiip. Adjust the path to wherever you saved the .whl.

Installed with pip (a virtual environment)

Activate the same virtualenv your khiip is in, then:

Terminal window
pip install ~/Downloads/khiip_ee-<version>-py3-none-any.whl

Installed with pipx

pipx inject adds the add-on into Khiip’s isolated environment:

Terminal window
pipx inject khiip ~/Downloads/khiip_ee-<version>-py3-none-any.whl

Installed with uv tool

Reinstall the tool with the add-on included:

Terminal window
uv tool install khiip --with ~/Downloads/khiip_ee-<version>-py3-none-any.whl

4. Add your license key

Put the key from your email into ~/.config/khiip/config.toml:

[tier]
license_key = "<paste the whole key here>"

Prefer to keep it in its own file? Point at it instead:

[tier]
license_key_file = "~/.config/khiip/license.key"

Or set the KHIIP_LICENSE_KEY environment variable before starting the daemon (it takes precedence over the config file).

5. Restart and verify

Restart the daemon so it picks up the add-on and the key:

Terminal window
# stop the running daemon (Ctrl-C where it's running), then:
khiipd serve

Confirm Plus is on:

Terminal window
khiipd version
# 0.x.y
# tier: plus — styled renders + deep extraction active

tier: plus means you’re set. Capture something — your renders now use the platform-styled Plus output.

Because Plus runs on the daemon, every surface picks it up at once — the CLI, agents over MCP, and the Obsidian plugin all return the styled renders and deeper extraction with nothing else to install or toggle.

Still on base tier?

khiipd version shows tier: base after activating? Check, in order:

  • Add-on installed in the right environment? Confirm khiip-ee is present in the same environment as Khiip, using the check for your install method:

    • pip: pip show khiip-ee (with that virtualenv active)
    • pipx: pipx runpip khiip show khiip-ee
    • uv: uv tool list --show-with — your khiip entry should list khiip-ee (uv tool environments don’t ship pip, so pip show won’t work there)

    If it’s missing, redo step 3 with the command for your install method. Not sure which environment runs Khiip? pip show khiip prints its Location:, or run python -c "import shutil; print(shutil.which('khiipd'))" to find the executable.

  • Key picked up? Confirm the path is ~/.config/khiip/config.toml and the [tier] section is spelled exactly as above. A KHIIP_LICENSE_KEY env var overrides the file.

  • Key expired? Keys are time-limited and renew while your subscription is active. If yours lapsed, the latest key is in your most recent renewal email.

  • Restarted? The daemon reads the key and loads the add-on at startup.

Updating Plus

New Plus versions are delivered the same way: download the newer khiip_ee-<version>-py3-none-any.whl from the link in your latest key email and reinstall it with the step-3 command for your setup (the <version> in the filename changes each release — point the command at the new file). Keep the core and the add-on on matching versions; khiipd version prints both.

If you stop paying

Your captures outlive the subscription.

  • Everything already captured stays. The styled Markdown files and the enriched typed payloads are ordinary files in your vault and database — they stay on disk, fully readable, after a lapse. Recall, MCP, and the REST API keep serving them; none of that is gated.
  • Lapse is a graceful downgrade. New captures fall back to the free base tier. Nothing already captured is modified.
  • Subscribing later upgrades old captures retroactively. Khiip keeps the raw bytes of each capture. With an active key, khiipd refetch --re-extract <id> re-derives a capture from its kept bytes with Plus enrichment — offline, no network. (It can only surface what the original bytes contain.)
  • One edge case. Running khiipd refetch --re-render <id> while lapsed re-renders that note in place at the base tier. It’s reversible — the typed payload keeps its Plus depth, and re-rendering under an active key restores the styled card.

Billing, trials, and cancellation

Your subscription, trial, payment method, and cancellation are all managed in your Link account at link.com (your purchase shows as “Sold through Link”, and the link is in your receipt). If you’re on the 30-day free trial, cancel any time before it ends and you won’t be charged — Khiip simply returns to the free base tier (your captured notes stay exactly where they are). The merchant of record is Link / Stripe Managed Payments (not Khiip) — send billing and payment questions to Link support; product questions come to us.