{"id":43294559,"url":"https://github.com/activememory/ctx","last_synced_at":"2026-02-08T07:30:34.732Z","repository":{"id":333674615,"uuid":"1138059317","full_name":"ActiveMemory/ctx","owner":"ActiveMemory","description":"ctx: do you remember? — a lightweight, file-based system that enables AI coding assistants to persist, structure, and rehydrate project context across sessions.","archived":false,"fork":false,"pushed_at":"2026-01-29T13:01:37.000Z","size":1427,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T19:13:56.929Z","etag":null,"topics":["agent-infrastructure","ai-collaboration","ai-tooling","automation","cognitive-continuity","context","context-management","developer-experience","developer-tools","documentation","human-in-the-loop","infrastructure","knowledge-management","llm","long-lived-context","productivity","project-memory","state-management","tasks","workflow"],"latest_commit_sha":null,"homepage":"https://ctx.ist","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ActiveMemory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-20T07:33:46.000Z","updated_at":"2026-01-29T13:02:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ActiveMemory/ctx","commit_stats":null,"previous_names":["josealekhine/activememory","activememory/ctx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ActiveMemory/ctx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveMemory%2Fctx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveMemory%2Fctx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveMemory%2Fctx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveMemory%2Fctx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ActiveMemory","download_url":"https://codeload.github.com/ActiveMemory/ctx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveMemory%2Fctx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28986347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T18:17:03.387Z","status":"ssl_error","status_checked_at":"2026-02-01T18:16:57.287Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-infrastructure","ai-collaboration","ai-tooling","automation","cognitive-continuity","context","context-management","developer-experience","developer-tools","documentation","human-in-the-loop","infrastructure","knowledge-management","llm","long-lived-context","productivity","project-memory","state-management","tasks","workflow"],"created_at":"2026-02-01T19:01:29.524Z","updated_at":"2026-02-08T07:30:34.724Z","avatar_url":"https://github.com/ActiveMemory.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![ctx](assets/ctx-banner.png)\n\n## `ctx` (*Context*)\n\n\u003e **Context is a system, not a prompt.**\n\nA lightweight, file-based system that enables AI coding assistants to persist,\nstructure, and rehydrate project context across sessions.\n\n`ctx` works with **any AI tool** that can read files; no model or \nvendor lock-in.\n\n**Full documentation: [ctx.ist](https://ctx.ist)**\n\n## The Problem\n\nMost LLM-driven development fails not because models are weak: They fail because\n**context is ephemeral**. Every new session starts near zero:\n\n* You re-explain architecture\n* The AI repeats past mistakes\n* Decisions get rediscovered instead of remembered\n\n## The Solution\n\n`ctx` treats context as infrastructure:\n\n* **Persist**: Tasks, decisions, learnings survive session boundaries\n* **Reuse**: Decisions don't get rediscovered; lessons stay learned\n* **Align**: Context structure mirrors how engineers actually think\n* **Integrate**: Works with any AI tool that can read files\n\nHere's what that looks like in practice:\n\n```text\n❯ \"Do you remember?\"\n\n● Yes. The PreToolUse hook runs ctx agent, and CLAUDE.md tells me to\n  check .context/sessions/. I'll have context.\n\n❯ \"Summarize all sessions we have had so far?\"\n\n● Yes. I can ls .context/sessions/ and read each file:\n    - 2025-01-20: The meta-experiment that started it all\n    - 2025-01-21: The ctx rename + Claude hooks session\n```\n\nThat's the whole point: **Temporal continuity across sessions**.\n\n## Installation\n\nDownload pre-built binaries from the\n[releases page](https://github.com/ActiveMemory/ctx/releases), or build from\nsource:\n\n```bash\ngit clone https://github.com/ActiveMemory/ctx.git\ncd ctx\nCGO_ENABLED=0 go build -o ctx ./cmd/ctx\nsudo mv ctx /usr/local/bin/\n```\n\nSee [installation docs](https://ctx.ist/#installation) for platform-specific\ninstructions.\n\n## Quick Start\n\n```bash\n# Initialize context directory in your project\nctx init\n\n# Check context status\nctx status\n\n# Get an AI-ready context packet\nctx agent --budget 4000\n\n# Add tasks, decisions, learnings\nctx add task \"Implement user authentication\"\nctx add decision \"Use PostgreSQL for primary database\"\nctx add learning \"Mock functions must be hoisted in Jest\"\n```\n\n## Documentation\n\n| Guide                                           | Description                            |\n|-------------------------------------------------|----------------------------------------|\n| [Getting Started](https://ctx.ist)              | Installation, quick start, first steps |\n| [CLI Reference](https://ctx.ist/cli-reference/) | All commands and options               |\n| [Context Files](https://ctx.ist/context-files/) | File formats and structure             |\n| [Integrations](https://ctx.ist/integrations/)   | Claude Code, Cursor, Aider setup       |\n| [Ralph Loop](https://ctx.ist/ralph-loop/)       | Autonomous AI development workflows    |\n\n## Design Philosophy\n\n1. **File-based**: No database, no daemon. Just markdown and convention.\n2. **Git-native**: Context versions with code, branches with code, merges with\n   code.\n3. **Human-readable**: Engineers can read, edit, and understand context\n   directly.\n4. **Token-efficient**: Markdown is cheaper than JSON/XML.\n5. **Tool-agnostic**: Works with Claude Code, Cursor, Aider, Copilot, or raw\n   CLI.\n\n## Contributing\n\nContributions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nAll commits must be signed off (`git commit -s`) to certify the\n[DCO](CONTRIBUTING_DCO.md).\n\n## Community\n\n**Open source is better together**.\n\nJoin the community to ask questions, share feedback, and connect with\nother users:\n\n[Join `#ctx` on `irc.libera.chat`](https://web.libera.chat/#ctx)\n\n## License\n\n[Apache 2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivememory%2Fctx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factivememory%2Fctx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivememory%2Fctx/lists"}