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.
Open source
A vault you cannot inspect asks for blind trust. Every line of Sigil is public under the MIT licence: the encryption, the server, the connector, the browser extension, the SDK and the contract.
One repository, seven packages, MIT licence. TypeScript throughout, Solidity for the contract.
packages/core
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 pages you are reading, the vault dashboard, and the API in web/src/server, backed by SQLite. The server only ever handles ciphertext.
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
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
The SDK web apps use to ask for read access to chosen folders, with a small example app in examples/hello-sigil.
contracts
SigilSeal.sol records hourly seal roots on chain and checks proofs with the same rules as the browser. Written and tested; not deployed.
e2e
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
How the site is styled and a screenshot of every page and every vault state, at desktop and phone sizes.
Run it
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.
git clone https://github.com/SeierkDeveloper/Sigil.git
cd Sigil
npm install
npm run build
npm startnpm 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| Variable | Default | Meaning |
|---|---|---|
NEXT_PUBLIC_SITE_URL | http://localhost:3000 | The public address, used in links and connector snippets. Set at build time. |
SIGIL_ORIGIN | the request's own origin | The origin trusted for passkeys and same-origin checks in production. |
SIGIL_DATA_DIR | web/.data | Where the SQLite database lives. |
SIGIL_SEALS | on | Seal the read log at the end of every hour. |
SIGIL_ANCHOR | off | Publish seal roots to the SigilSeal contract. Needs an RPC address, the contract address and a sealer key. |
SIGIL_SEMANTIC | on | Search by meaning in the vault. The model runs in the browser; the server only hands out its files. |
SIGIL_EMBED_MODEL | Xenova/all-MiniLM-L6-v2 | The sentence model for search by meaning. |
SIGIL_MODEL_DIR | web/.data/models | Where the model files are kept. |
SIGIL_MODEL_FETCH | on | Fetch missing model files once from the public model hub. Off serves only files already on disk. |
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.
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.