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.0
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.0.tar.gz | 68.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gcontext_ai-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 134.6 kB
Release files / gcontext_ai-1.0.0.tar.gz
| Download URL | gcontext_ai-1.0.0.tar.gz |
|---|---|
| Size | 68.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58b9057d27b80b42e3d595312f2f84f37c582d851efecfd8b20ecea47148c79f
|
|
BLAKE2b-256 checksum How to use checksums |
fa647910da3b772bbed175328934e1dbbb5bb7c719bca5214f9766106b3292ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.16
|
Release files / gcontext_ai-1.0.0-py3-none-any.whl
| Download URL | gcontext_ai-1.0.0-py3-none-any.whl |
|---|---|
| Size | 66.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eabf78bd410ac9a69174addaf5e306211c0aceceeda5e1a39fe98e9a11124c63
|
|
BLAKE2b-256 checksum How to use checksums |
3f0011361990c0da8a68ea17e2519926ea5898c6b05094985e1f1e175ed379af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.16
|
