SeierkDeveloper/Sigil

One repository, seven packages, MIT licence. TypeScript throughout, Solidity for the contract.

Open the repository

What is in it

packages/core

The cryptography

AES-256-GCM envelopes, HKDF key derivation, key slots, app keys, sealed boxes to a vault's public key, folder sharing and key rotation, Merkle seals, search by words and by meaning, and the ChatGPT and Claude export parsers. Every other part uses this one package.

web

The site and the server

The pages you are reading, the vault dashboard, and the API in web/src/server, backed by SQLite. The server only ever handles ciphertext.

connector

The connector

sigil-connector, the MCP server people run on their own machine. Stdio for apps that start it, HTTP for apps that need a URL. Searches by meaning and seals suggestions there.

extension

The browser extension

A Chrome extension that saves a selection, a page or a ChatGPT or Claude conversation to the inbox, sealed in the browser. Built as an unpacked extension; not in a store.

packages/sdk

Sign in with Sigil

The SDK web apps use to ask for read access to chosen folders, with a small example app in examples/hello-sigil.

contracts

The seal contract

SigilSeal.sol records hourly seal roots on chain and checks proofs with the same rules as the browser. Written and tested; not deployed.

e2e

End-to-end tests

Playwright runs the whole product in Chrome against the built server: sign-up, import, connecting an app, reads, seals, revoke, the inbox, search by meaning, sharing and Sign in with Sigil.

docs

Design brief and screenshots

How the site is styled and a screenshot of every page and every vault state, at desktop and phone sizes.

Run it

Your own Sigil in four commands

Needs Node.js 22.13 or newer, for the built-in SQLite. It serves on http://localhost:3000 and keeps its data in web/.data/sigil.db. Nothing else is required: no account, no external database, no third-party service.

  • Your vault then lives on your own machine, and your connector points at your own address.
  • Passkeys work on localhost. For a public address, serve it over HTTPS and set SIGIL_ORIGIN.
  • For development, npm run dev starts the site with live reload.
Terminal
git clone https://github.com/SeierkDeveloper/Sigil.git
cd Sigil
npm install
npm run build
npm start
Tests
npm run test:unit       # core, server and connector
npm run test:contracts  # the seal contract, with Foundry
npm run test:e2e        # the whole product in Chrome
npm test                # all three

Settings

VariableDefaultMeaning
NEXT_PUBLIC_SITE_URLhttp://localhost:3000The public address, used in links and connector snippets. Set at build time.
SIGIL_ORIGINthe request's own originThe origin trusted for passkeys and same-origin checks in production.
SIGIL_DATA_DIRweb/.dataWhere the SQLite database lives.
SIGIL_SEALSonSeal the read log at the end of every hour.
SIGIL_ANCHORoffPublish seal roots to the SigilSeal contract. Needs an RPC address, the contract address and a sealer key.
SIGIL_SEMANTIConSearch by meaning in the vault. The model runs in the browser; the server only hands out its files.
SIGIL_EMBED_MODELXenova/all-MiniLM-L6-v2The sentence model for search by meaning.
SIGIL_MODEL_DIRweb/.data/modelsWhere the model files are kept.
SIGIL_MODEL_FETCHonFetch missing model files once from the public model hub. Off serves only files already on disk.
Licence

MIT

Use it, change it, host it, build on it, for any purpose. The licence asks only that the copyright notice stays with the code, and it comes without warranty.

Taking part

Issues, changes and security reports

Open an issue or a pull request on the repository. Security problems go through the repository's private security advisories instead of a public issue, so they can be fixed before they are known.