Install
npm install -g @kleos-research/kaleidoscopeThat is the whole install. You need a key to run it — email contact@kleosresearch.xyz and we will send you one.
What your machine needs
Section titled “What your machine needs”| Operating system | macOS or Linux |
| Architecture | arm64 (Apple Silicon) or x86_64 |
| Node.js | 18 or newer |
Windows is not supported yet. Platforms has the full matrix.
What lands on your disk
Section titled “What lands on your disk”Two packages, both at version 0.0.8.
| Package | Carries |
|---|---|
@kleos-research/kaleidoscope | the kscope command, and the launcher that picks your platform’s binary |
| one platform package, below | the memory engine as object code, with the setup work kscope init does compiled into it |
npm installs the platform package that matches your machine and skips the other three.
| Machine | Platform package |
|---|---|
| macOS, Apple Silicon | @kleos-research/kaleidoscope-darwin-arm64 |
| macOS, x86_64 | @kleos-research/kaleidoscope-darwin-x64 |
| Linux, arm64 | @kleos-research/kaleidoscope-linux-arm64 |
| Linux, x86_64 | @kleos-research/kaleidoscope-linux-x64 |
There is no install hook, no download at install time, no compiler step and no source build. Installing puts files on your disk and does nothing else.
kscope init from an npm install copies kscope to .kaleidoscope/bin in your
home folder, and your editors run that copy, because npm may delete its own. A
newer kscope replaces the copy the next time it runs mcp or call, so your
agents and your terminal run the same version. kscope where reports both.
Licences
Section titled “Licences”The memory engine is proprietary object code, and its source is not in the package. Everything around it is Apache-2.0: the command-line tool, both SDKs, every integration and the agent skill.
Signing
Section titled “Signing”Nothing is signed for release. There is no Apple signing and no notarisation, and the native code is ad-hoc signed only. It is on the list to fix.
There is no Python package
Section titled “There is no Python package”kscope-memory on PyPI is a 0.0.0 placeholder whose own summary says it is not
yet released. kaleidoscope-memory was planned and never registered — if you
find that name, it is not us.
Next: Getting started activates your key and gives a project a memory.