{"id":50189443,"url":"https://github.com/konteks/cli","last_synced_at":"2026-05-25T12:00:59.507Z","repository":{"id":355448634,"uuid":"1223853501","full_name":"konteks/cli","owner":"konteks","description":"A local context graph for AI coding agents.","archived":false,"fork":false,"pushed_at":"2026-05-24T12:35:52.000Z","size":1606,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T14:25:04.512Z","etag":null,"topics":["agent-memory","ai-memory","coding-agent","context","knowledge-graph","local-first","mcp","model-context-protocol"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/konteks-cli","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/konteks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T18:06:46.000Z","updated_at":"2026-05-24T12:35:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/konteks/cli","commit_stats":null,"previous_names":["dominosaurs/konteks","konteks/cli"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/konteks/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konteks%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konteks%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konteks%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konteks%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/konteks","download_url":"https://codeload.github.com/konteks/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konteks%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33473706,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"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-memory","ai-memory","coding-agent","context","knowledge-graph","local-first","mcp","model-context-protocol"],"created_at":"2026-05-25T12:00:38.707Z","updated_at":"2026-05-25T12:00:59.502Z","avatar_url":"https://github.com/konteks.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1536\" height=\"1024\" alt=\"Banner\" src=\"https://github.com/user-attachments/assets/37e29d10-ed23-409d-92b2-2c6fab854f72\" /\u003e\n\n# Konteks\n\n**Konteks** is a memory engine for AI coding agents.\n\nIt builds a project-local context graph through autonomous **knowledge curation**, ensuring you **never re-explain your project** to an AI agent.\n\nMemory artifacts are stored directly inside your repository, exposing compact, task-specific recall through an MCP server without requiring global installation or cloud dependencies.\n\n## 🚀 Key Features\n\n* **Zero-Install**: Run anywhere via `npx` or `bunx` without global installation.\n* **Language-Aware**: Understands code structure across [various file types](src/assets/grammar-registry.ts).\n* **Local-First**: Your project memory stays in your repo—no cloud, no accounts.\n* **Token-Efficient**: High-fidelity context synthesis designed for LLM economy.\n\n## 🧠 How It Works\n\nKonteks treats a repository as a local memory system for agent workflows. It builds searchable project artifacts from source files, retrieves task-relevant evidence, and expands related context through a lightweight graph of entities and relations when available.\n\nFor a deep dive into the philosophy, architecture, and usage, see the [Full Documentation](docs/README.md).\n\n* [Overview](docs/getting-started/overview.md): Vision, Philosophy, and the \"Why.\"\n* [Session Lifecycle](docs/getting-started/lifecycle.md): How to work with Konteks (Warm Up -\u003e Build -\u003e Save).\n* [Architecture Overview](docs/core-concepts/overview.md): How the memory engine works under the hood.\n* [Glossary](docs/reference/glossary.md): Short definitions for Konteks terms.\n\n## ⚡ Quickstart\n\nKonteks runs on **Node.js (\u003e=22)** or **Bun**. Start by initializing memory from your project root:\n\n```bash\nnpx -y konteks-cli init\n```\n\nContinue with the [Quickstart](docs/getting-started/quickstart.md) for MCP setup and the Warm Up -\u003e Build -\u003e Save flow.\n\n### 🤖 AI-Assisted Installation\n\nIf you are using an AI coding agent such as Claude Code, Codex, or OpenCode, let the agent handle the setup from your project root.\n\nPaste this prompt into your agent. It points the agent to the Konteks installation playbook, asks it to follow project defaults, and keeps MCP setup, verification, and lifecycle guidance in one flow:\n\n```text\nI want to add Konteks to this project.\n\nRead and follow https://raw.githubusercontent.com/konteks/cli/refs/heads/main/docs/for-agents/installation.md. Treat that Markdown as the source of truth for installing Konteks, configuring MCP, verifying setup, and explaining the Warm Up -\u003e Build -\u003e Save workflow.\n```\n\nThe agent should read the instructions, make safe defaults, ask only when a local-machine or agent-configuration decision is required, and leave you with a verified Konteks setup.\n\n## 📂 Local Storage\n\nKonteks writes local memory under `.konteks/`. It uses SQLite for extracted content, durable memories, diary entries, retrieval indexes, embeddings, and graph metadata; extraction manifests and project config live beside the database.\n\n## ⚖️ License\n\nMIT Licensed. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonteks%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkonteks%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonteks%2Fcli/lists"}