gcontext
A folder standard that gives an AI agent a memory of your project.
Project knowledge lives in context/, organized by one rule: a path is a chain of common denominators.
Install
uv tool install gcontext-ai
Also works with pip install gcontext-ai.
Get started
gcontext init
This writes context/ with the standard, the scripts, the git hook, and two Claude Code commands (/save, /check-structure). It appends two lines to CLAUDE.md so the agent reads project context at session start.
The three moments
Save. When the agent learns a durable fact, it writes it into the file of its subject. Files and folders are created only when the tests in the standard say so. A Stop hook forces a save every five turns so nothing is lost.
Track. A statusline command shows how many facts and folders were added since the last structure check, colored green, amber, or red. Add it to your Claude Code statusline:
uv run --no-project python3 context/system/scripts/track-context-changes.py . --color
Check. When the count is high, run /check-structure. The agent proposes the smallest tree that passes the three tests. You approve, it applies, the counter resets.
Commands
gcontext init [dir]- writecontext/from the bundled standard.gcontext install <package-folder> [dir]- install a package intocontext/packages/.gcontext serve [dir]- start the MCP server.gcontext check [dir]- run the structure checks.
Documentation
- docs/standard.md - the context standard, version 1.0.
- docs/principles.md - what gcontext is and why.
- docs/cli.md - commands, arguments, exit codes.
- docs/mcp.md - how the MCP server works.
License
MIT
1 maintainer
Release files for gcontext-ai 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gcontext_ai-1.0.1.tar.gz | 68.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gcontext_ai-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 134.3 kB
Release files / gcontext_ai-1.0.1.tar.gz
| Download URL | gcontext_ai-1.0.1.tar.gz |
|---|---|
| Size | 68.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9d012d5714b30a7bc2ebc6d8a73c910fbb9a0534587c99cd630256a15c2a2ef6
|
|
BLAKE2b-256 checksum How to use checksums |
413d2454ee3e8f630c48af94866e2e04bd9383637c66ac4f8f78572205eb79be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.16
|
Release files / gcontext_ai-1.0.1-py3-none-any.whl
| Download URL | gcontext_ai-1.0.1-py3-none-any.whl |
|---|---|
| Size | 65.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74a0754c0fbd9b4643478a9effcb09465f3075b7ab2042392477f63046bfbdf8
|
|
BLAKE2b-256 checksum How to use checksums |
13e5e72fb5d461c36d944be22d735070adc47049688848260e80014c6fc40f4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.16
|
