Spectrum Store Developer Preview

Turn any repo into a local searchable memory in minutes.

Install the CLI, run the guided walkthrough, and get a compact lossless .specpack served through a local HTTP API for agents, apps, and RAG workflows.

npm install -g spectrumstore
spectrum load

Start The Walkthrough Desktop App CLI Tutorial Benchmark HUD GitHub

Turnkey Install

One install, guided local serving

spectrum load checks the install, packs your repo, verifies the output, and starts the local Spectrum HTTP API. Use spectrum demo from the legacy benchmark CLI when you want the full retrieval comparison walkthrough.

npm install -g spectrumstore
spectrum load ./my-repo ./my-repo.specpack --yes

# Local API
curl http://127.0.0.1:7777/health
curl http://127.0.0.1:7777/packs

Spectrum Hub

A guided control plane for portable project context

Spectrum Hub wraps the project workflow into simple guided commands for building, appending, serving, and verifying local .specpack stores. It helps an AI agent start from the live project API instead of guessing from loose files: discover the running pack, read the manifest, pull agent context, check ops readiness, search for the right note, and hydrate exact source only when it is needed.

In practice that gives agents like Codex a cleaner workflow: project rules, deployment facts, SSH policy, and safety flags travel inside the pack, while the local HTTP API exposes the same authoritative context to every tool in the loop.

spectrum hub -bBuild a portable pack.

spectrum hub -aAppend new project context.

spectrum hub -sServe the pack locally.

spectrum hub -vVerify running APIs and agent URLs.

Desktop App

Spectrum Hub is now available for Windows and macOS

The desktop build packages the guided Spectrum Hub workflow into native Windows and macOS installers. Create or open a .specpack, run the local project server without a terminal window, open the dashboard, and append documents by drag and drop.

Download for Windows Download for macOS Release Notes

The Linux desktop build is on the way. For now, Linux users can use the npm CLI and local HTTP API.

Linux And CLI Users

Spectrum CLI quick tutorial

Use the npm package directly when you want a terminal-first workflow for plain packs, encrypted packs, local serving, appends, restores, and automation.

Install or update

npm install -g spectrumstore@latest
spectrum doctor

Create a plain pack

spectrum pack ./my-project ./my-project.specpack --json

Serve it locally

spectrum serve ./my-project.specpack --port 7777

Agent/API URLs

http://127.0.0.1:7777/health
http://127.0.0.1:7777/packs
http://127.0.0.1:7777/projects/repo/context

Create an encrypted pack

spectrum pack ./my-project ./my-project.specpack --encrypt --hint "non-secret reminder"

You will be prompted for a passphrase and confirmation.

Inspect locked metadata

spectrum inspect ./my-project.specpack

Unlock for operations

spectrum verify ./my-project.specpack --unlock
spectrum index ./my-project.specpack --unlock --embed
spectrum search ./my-project.specpack "deploy nginx ssh" --unlock

Serve unlocked

spectrum serve ./my-project.specpack --unlock --port 7777

Append files or folders

Plain pack

spectrum append ./my-project.specpack ./new-notes --replace --all
spectrum index ./my-project.specpack --embed

Encrypted pack

spectrum append ./my-project.specpack ./new-notes --replace --all --unlock
spectrum index ./my-project.specpack --embed --unlock

Restore a pack to files

Plain

spectrum unpack ./my-project.specpack ./restored

Encrypted

spectrum unpack ./my-project.specpack ./restored --unlock

One-step project workflow

Plain

spectrum project init ./my-project ./my-project.specpack --name "My Project"
spectrum project serve ./my-project.specpack --port 7777

Encrypted

spectrum project init ./my-project ./my-project.specpack --name "My Project" --encrypt --hint "non-secret reminder"
spectrum project serve ./my-project.specpack --unlock --port 7777

Automation secret source

For scripts or servers only:

export SPECTRUM_PASSPHRASE="your passphrase"
spectrum serve ./my-project.specpack --unlock --port 7777

Prefer interactive prompts for normal use; environment variables can leak through shell history, process environments, or logs.

Single Artifact

The compressed pack and retrieval representation are designed to travel together, instead of keeping raw chunks and a separate search store as the source of truth.

Exact Source

Packs are deterministic and lossless, so selected context can hydrate back into byte-for-byte source rather than approximate snippets.

Agent Ready

Serve a pack locally, search it over HTTP, and give agents exact code context without shipping your repo to a hosted vector store.

Developer Flow

From repo to local API

InstallGet the npm CLI with bundled Spectrum runtime.
LoadPoint Spectrum at a local repo or folder.
ServeStart the local API at 127.0.0.1:7777.
IntegrateSearch, hydrate, verify, and unpack from tools or agents.

Current Benchmark Signal

Large-corpus serving profile

Corpus: 72,601 documents
Raw bytes: 1.03 GB
Compact store: 0.3585x raw
Serving footprint: 0.4882x raw
MRR: 0.8625
Recall@5: 0.8750
Avg E2E: 4.78 ms
P95 E2E: 6.35 ms