{"id":46912032,"url":"https://github.com/firelock-ai/kin","last_synced_at":"2026-07-26T05:00:59.478Z","repository":{"id":343594282,"uuid":"1178256335","full_name":"firelock-ai/kin","owner":"firelock-ai","description":"The semantic system of record for AI-written software: a graph of entities and relations, not file diffs.","archived":false,"fork":false,"pushed_at":"2026-07-22T20:57:45.000Z","size":13413,"stargazers_count":41,"open_issues_count":5,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-22T21:18:40.593Z","etag":null,"topics":["ai","ai-agents","ai-native","developer-tools","graph-database","mcp","open-source","rust","semantic","semantic-version-control","tree-sitter","vcs","version-control"],"latest_commit_sha":null,"homepage":"https://firelock.ai/labs/kin","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firelock-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-10T21:09:53.000Z","updated_at":"2026-07-22T17:06:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/firelock-ai/kin","commit_stats":null,"previous_names":["firelock-ai/kin","firelock-io/kin"],"tags_count":57,"template":false,"template_full_name":null,"purl":"pkg:github/firelock-ai/kin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firelock-ai","download_url":"https://codeload.github.com/firelock-ai/kin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35901460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-26T02:00:06.503Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-agents","ai-native","developer-tools","graph-database","mcp","open-source","rust","semantic","semantic-version-control","tree-sitter","vcs","version-control"],"created_at":"2026-03-11T02:03:40.711Z","updated_at":"2026-07-26T05:00:59.467Z","avatar_url":"https://github.com/firelock-ai.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kin\n\n\u003e **Software that remembers itself.**\n\u003e\n\u003e Exact context, not more.\n\n[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n[![Latest release](https://img.shields.io/badge/release-latest-6E56CF.svg)](https://github.com/firelock-ai/kin/releases/latest)\n[![kinlab.ai](https://img.shields.io/badge/hosted-kinlab.ai-111111.svg)](https://kinlab.ai)\n\nKin is the system of record for AI-written software. AI agents can write a\nchange faster than a team can establish what it touches, whether it reverses\nan earlier fix, and how far its blast radius reaches. Git records files and\nline history. Kin records the software itself as a graph of entities,\nrelations, changes, and provenance, then gives humans and agents one semantic\nauthority to query and review.\n\nKin is a public alpha. It is usable today as a local CLI, daemon, MCP server,\nreview surface, and graph-backed filesystem projection. It is pre-1.0, so expect\nrough edges and breaking changes. See the [latest stable release](https://github.com/firelock-ai/kin/releases/latest)\nand the [current limitations](#platform-and-maturity) before adopting it in a\ncritical workflow.\n\n## The stack\n\nKin is one system with a few clear public surfaces:\n\n| Surface | What it does |\n| --- | --- |\n| **[kin](https://github.com/firelock-ai/kin)** | Semantic system of record: CLI, daemon, graph lifecycle, MCP, review, provenance, and Git coexistence. |\n| **[kin-vfs](https://github.com/firelock-ai/kin-vfs)** | Projects graph-owned files through normal filesystem calls so existing tools can keep using files. |\n| **[kin-editor](https://github.com/firelock-ai/kin-editor)** | VS Code access to the entity explorer, semantic search, trace, review, and rename surfaces. |\n| **[Kin MCP](docs/mcp-tools.md)** | Typed graph tools for AI agents, bundled into `kin` and launched with `kin mcp start`. |\n| **[KinLab](https://kinlab.ai)** | Hosted collaboration and control plane. Public repository connection is not a first-run flow yet. |\n\nSupporting repositories provide graph storage, retrieval, embeddings, blobs,\nlanguage enrichment, and reproducible proof. They are implementation layers,\nnot separate products a new user needs to assemble.\n\n## Open source and the Kin ecosystem\n\nThe core of Kin is open source under Apache-2.0: [kin](https://github.com/firelock-ai/kin),\n[kin-db](https://github.com/firelock-ai/kin-db), [kin-vfs](https://github.com/firelock-ai/kin-vfs),\nand [kin-editor](https://github.com/firelock-ai/kin-editor), plus the supporting\nlibraries kin-model, kin-blobs, kin-search, kin-vector, kin-infer, kin-lsp, and\nkin-actions.\n\n[KinLab](https://kinlab.ai) is a proprietary product built on this open core: the\nhosted collaboration and control-plane layer described above.\n\nThe same boundary applies to how benchmark work is shared. The [benchmark\nspecification and a standalone, dependency-free bundle verifier](https://github.com/firelock-ai/kin-bench-spec)\nare public, so a claim can be checked without access to the system that produced\nit. The runner and proof infrastructure that produce sealed evidence bundles (the\norchestration, the pinned-release proof gate, and the hosted measurement\nenvironment) remain private for now. The spec and verifier open first; the runner\ncan open later.\n\n## Shortest graph-backed path\n\n### 1. Install and configure Kin\n\nOn macOS or Linux:\n\n```sh\ncurl -fsSL https://get.kinlab.dev/install | sh\nexec \"$SHELL\" -l\nkin setup --intent agent\n```\n\nThe installer resolves the [latest stable release](https://github.com/firelock-ai/kin/releases/latest),\nverifies its published SHA-256 checksum, installs the managed binaries under\n`~/.kin`, and launches setup. Running the explicit `agent` intent configures the\nbuilt-in MCP server for detected supported clients. Use `--intent local` for CLI\nand filesystem use without MCP configuration, or `--intent editor` for the VS\nCode path.\n\nFor manual installation, each archive and its `.sha256` file is published under\n`https://github.com/firelock-ai/kin/releases/latest/download/`. The moving asset\nnames are `kin-macos-aarch64`, `kin-macos-x86_64`, `kin-linux-aarch64`,\n`kin-linux-x86_64`, and `kin-windows-x86_64`; use the Unix `.tar.gz` or Windows\n`.zip` suffix shown on the latest release page.\n\nHomebrew and npm entry points resolve the same public release channel:\n\n```sh\nbrew install firelock-ai/kin/kin\n# or\nnpm install -g @kinlab/kin@latest\n```\n\nOn Windows, run `irm https://get.kinlab.dev/install.ps1 | iex` in PowerShell.\nNative Windows has a smaller capability envelope; read\n[Platform and maturity](#platform-and-maturity) below.\n\n### 2. Build graph truth for an existing repository\n\n```sh\ncd /path/to/your/repository\nkin init .\nkin status\nkin overview\n```\n\nIn an existing Git repository, `kin init` imports recent history by default and\nindexes the checked-out tree into `.kin/`. `kin status` starts or reuses the\nrepository daemon and reports graph and embedding state. The graph is the answer\nauthority for Kin queries; a missing or unavailable graph is reported instead of\nbeing hidden behind raw file search. Initial indexing time scales with repository\nsize; the command sequence itself is the short path, not a fixed performance\npromise for every codebase.\n\n### 3. Ask the graph a real question\n\n```sh\nkin locate \"where are webhook retries handled\"\nkin refs ExactEntityName\nkin trace ExactEntityName\n```\n\nReplace `ExactEntityName` with a symbol returned by `locate`. `locate` finds the\nentities relevant to an intent, `refs` shows graph-owned callers/importers and\nreferences, and `trace` returns the focal entity plus nearby semantic context.\nOnce embeddings are complete, your configured AI agent can use the vector-backed\n`semantic_locate` tool; `get_context_pack`, `find_references`, and\n`trace_data_flow` expose the graph neighborhood directly.\n\n`kin init` builds the graph without waiting for embeddings. At that point locate\nuses graph and lexical signals and reports that vector coverage is incomplete.\nRun `kin embed` to add local vector similarity, then confirm coverage with\n`kin status --json`.\n\n## Review an AI-written change\n\n**AI writes code. Kin proves the change.**\n\nRun `kin init` on the branch you want to review so the relevant Git history is in\nthe graph, then pass explicit commit SHAs to the report-only shadow gate:\n\n```sh\nkin review shadow \"$(git rev-parse main)..$(git rev-parse HEAD)\"\n```\n\nThe result is `PASS`, `NEEDS ATTENTION`, or `WOULD BLOCK`, with graph-derived\nblast radius, repair context, and audit evidence. The command does not block a\nmerge or mutate graph state. It produces evidence for a human or CI policy to\nact on.\n\n## How Kin relates to Git\n\nKin coexists with Git. It does not rewrite Git history, branches, or remotes.\n\n- `kin init --git-history off|recent|full` controls bootstrap history import;\n  `recent` is the default for an existing Git repository.\n- `kin migrate` is the explicit deep-history migration path.\n- Git remains the interoperability and transport boundary while Kin owns the\n  semantic graph used by Kin commands.\n- `kin eject` removes `.kin/` graph state and leaves working files and `.git`\n  untouched.\n- `kin eject --revert-files` is a separate, destructive option that restores\n  the pre-init file snapshot after explicit confirmation. It still never\n  modifies `.git`.\n\nThis lets a team evaluate Kin inside an existing repository without giving up\nits Git remote, history, editor, compiler, or build system.\n\n## Platform and maturity\n\nThe core runtime and the filesystem projection have different support\nboundaries:\n\n| Platform | Core Kin runtime | `kin-vfs` projection |\n| --- | --- | --- |\n| macOS, Apple Silicon and Intel | Native graph, vector, daemon, setup, MCP, and review surfaces ship in the release archive. | Shipped and exercised on both architectures. It uses `DYLD_INSERT_LIBRARIES`; SIP-protected or hardened programs may reject injection. |\n| Linux x86_64 and arm64 | `kin` and `kin-daemon` are static musl builds intended to run on glibc and musl distributions. | The public VFS executable and shim are GNU/glibc builds, not musl builds. Current artifacts require glibc 2.39; Alpine/musl and older-glibc distributions are not supported projection hosts. The arm64 release proof runs on Ubuntu 24.04. |\n| Native Windows x86_64 | Supported for graph, lexical retrieval, daemon, setup, MCP, and review without vectors. | Not shipped. Use WSL2 with a Linux distribution that meets the glibc boundary for projection. |\n\nBounded arm64 testing found the core graph and lexical path usable at 512 MB,\nbut full embedding downloads a roughly 522 MB model and currently needs 2 GB as\nthe safe operating floor; 1 GB is an unsafe edge and 512 MB can terminate during\nembedding. These are observed alpha constraints, not universal sizing promises.\n\nA successful `kin --version` proves only that the core binary runs. It does not\nprove VFS compatibility or a live graph-backed projection. On a supported Unix\nhost, use `kin setup status`, `kin-vfs status --workspace .`, and a real\n`kin-vfs exec --workspace . -- \u003ccommand\u003e` launch. The VFS launcher includes an\ninterposition canary and reports when the operating system strips the shim.\nThe [kin-vfs README](https://github.com/firelock-ai/kin-vfs#current-platform-and-package-boundaries)\ncontains the full boundary.\n\nRelease assets are checksum-published and the release workflow runs anonymous\ninstallation, daemon/MCP, embedding, and real graph-backed VFS projection checks\nacross its supported runner matrix. The workflow itself is public:\n[Install Proof](https://github.com/firelock-ai/kin/actions/workflows/install-proof.yml).\nA green release proves those exact artifacts and environments; it is not a claim\nthat every distribution, tool, or repository shape is already covered.\n\n## Proof posture\n\nThe published preregistered Multi-SWE-Bench Go proof package is pinned to an\nolder build, not the moving latest release, and does not establish a broad\nspeed, token-savings, or category-win claim. Comparative results are withheld\nhere pending independent verification.\n\nRead the methodology, task set, build identity, and artifacts in the\n[public proof package](https://firelock.ai/labs/kin-proof). Treat claims outside\nthat measured scope as hypotheses until they have their own reproducible proof.\n\n## Learn and contribute\n\n- [Quickstart and advanced configuration](docs/quickstart.md)\n- [MCP tool reference](docs/mcp-tools.md)\n- [Graph-first thesis](docs/thesis.md)\n- [GitHub Discussions](https://github.com/firelock-ai/kin/discussions)\n- [Bug reports and feature requests](https://github.com/firelock-ai/kin/issues/new/choose)\n- [Contributing guide](CONTRIBUTING.md)\n- [Private security reporting](SECURITY.md)\n\n## License\n\n[Apache-2.0](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirelock-ai%2Fkin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirelock-ai%2Fkin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirelock-ai%2Fkin/lists"}