A lightweight, multi-client memory layer that persists cross-project coding conventions
Project description
Helix
Global convention memory for AI coding agents — persist your coding preferences once, surface them in every Claude Code, Cursor, or MCP-compatible session.
Install
# With uv (recommended)
uv tool install helix-memory
# Or with pip
pip install helix-memory
Quick start
# 1. Hook Helix into your agent (Claude Code, Cursor, …).
helix install
# 2. Save your first convention.
helix remember pydantic-validation \
"Prefer Pydantic v2 for any external-boundary validation." \
--tags python,validation
From there, your next agent session will see the conventions automatically.
CLI
helix remember <name> "<body>" --tags <comma,separated>
helix list [--tags <tag>]
helix recall "<query>" [--tags <tag>]
helix forget <name>
helix install # wire Helix into your agent
helix uninstall # remove the integration
helix serve # start the MCP server
MCP server
helix serve starts a stdio MCP server that exposes four tools: remember, recall, list_conventions, forget.
Claude Code
Project-scoped (recommended — one .mcp.json per repo):
// .mcp.json at the project root
{
"mcpServers": {
"helix": {
"command": "helix",
"args": ["serve"]
}
}
}
User-scoped (available in every project):
claude mcp add helix -- helix serve
Or edit ~/.claude.json manually:
{
"mcpServers": {
"helix": {
"command": "helix",
"args": ["serve"]
}
}
}
Cursor
Global (all projects):
// ~/.cursor/mcp.json
{
"mcpServers": {
"helix": {
"command": "helix",
"args": ["serve"]
}
}
}
Project-scoped:
// .cursor/mcp.json at the project root
{
"mcpServers": {
"helix": {
"command": "helix",
"args": ["serve"]
}
}
}
After adding the config, restart your client. Verify the server is visible: in Claude Code run /mcp, in Cursor open the MCP panel.
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file helix_memory-4.1.0.tar.gz.
File metadata
- Download URL: helix_memory-4.1.0.tar.gz
- Upload date:
- Size: 88.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b2bd96470759f567a96cd4b8e12994937bb8b4d36e9e5712ec25409651c21512
|
|
| MD5 |
758f60443bfa6824e42d1d90f760e3dd
|
|
| BLAKE2b-256 |
239e4cd4b259a34f86f0e988343f65ced8ecfa9f663f40fff20bc260ec61d132
|
Provenance
The following attestation bundles were made for helix_memory-4.1.0.tar.gz:
Publisher:
ci.yml on justmatias/helix
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
helix_memory-4.1.0.tar.gz -
Subject digest:
b2bd96470759f567a96cd4b8e12994937bb8b4d36e9e5712ec25409651c21512 - Sigstore transparency entry: 1625353904
- Sigstore integration time:
-
Permalink:
justmatias/helix@4975db2236b9f32ebfe628425028983f11f93292 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/justmatias
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@4975db2236b9f32ebfe628425028983f11f93292 -
Trigger Event:
push
-
Statement type:
File details
Details for the file helix_memory-4.1.0-py3-none-any.whl.
File metadata
- Download URL: helix_memory-4.1.0-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e26918373d1e89361134ffeddedcbd89e62f58cefd94751817756f58c689a74
|
|
| MD5 |
3bef63ea8cb8992c7e82638f2a548f24
|
|
| BLAKE2b-256 |
e6521463dcd016c77990987175c5641f3f3a05196bc507cfb6f0b1faca59cc82
|
Provenance
The following attestation bundles were made for helix_memory-4.1.0-py3-none-any.whl:
Publisher:
ci.yml on justmatias/helix
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
helix_memory-4.1.0-py3-none-any.whl -
Subject digest:
0e26918373d1e89361134ffeddedcbd89e62f58cefd94751817756f58c689a74 - Sigstore transparency entry: 1625353938
- Sigstore integration time:
-
Permalink:
justmatias/helix@4975db2236b9f32ebfe628425028983f11f93292 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/justmatias
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@4975db2236b9f32ebfe628425028983f11f93292 -
Trigger Event:
push
-
Statement type:
