{"id":46912032,"url":"https://github.com/firelock-ai/kin","last_synced_at":"2026-06-16T04:01:03.046Z","repository":{"id":343594282,"uuid":"1178256335","full_name":"firelock-ai/kin","owner":"firelock-ai","description":"Local-first semantic version control for AI-native teams. Git stores text history. Kin understands code.","archived":false,"fork":false,"pushed_at":"2026-06-16T03:01:46.000Z","size":10350,"stargazers_count":42,"open_issues_count":10,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-16T03:14:57.478Z","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":null,"dco":null,"cla":null}},"created_at":"2026-03-10T21:09:53.000Z","updated_at":"2026-06-16T03:01: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":29,"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":34390052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"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-06-16T04:01:03.041Z","avatar_url":"https://github.com/firelock-ai.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kin — The Semantic System of Record for Software Work\n\nKin is a semantic, graph-first repository and collaboration substrate for AI-native software development. Unlike traditional file-first, diff-first systems (like Git), Kin represents software as a semantic graph of entities (functions, methods, classes, structs, traits, enums, interfaces, types, constants) and relations (calls, imports, references, inheritance).\n\nIn Kin, the graph is the source of authority. The filesystem is a derived projection over that graph truth, made transparently available to existing editors and compilers through the `kin-vfs` virtual filesystem.\n\n## Core Features\n\n- **Semantic VCS**: Version control at the level of entities and relations instead of lines and files.\n- **AI-native context packs**: Build structured context packs containing a target entity plus its caller/callee neighborhood in a single call (`kin context`).\n- **Trace \u0026 dataflow**: Trace call chains and dataflow dependencies in one step instead of looping over file reads (`kin trace`, `kin trace-data-flow`).\n- **Ejectable brownfield compatibility**: Works alongside Git and traditional toolchains. `kin eject` removes Kin and restores files to their pre-init state, so there is no data lock-in.\n\n---\n\n## Installation\n\nInstall Kin with a single command:\n\n```sh\ncurl -fsSL https://get.kinlab.dev/install | sh\n```\n\nThe installer downloads the latest release from GitHub, places the `kin` and `kin-vfs`\nbinaries into `~/.kin/bin`, updates your shell profile (`.zshrc` / `.bashrc`), and then\nruns the interactive setup wizard.\n\n### Installer configuration\n\nConfigure the installer with environment variables:\n\n- `KIN_VERSION`: Pin a specific version to download (e.g. `0.1.0`). If omitted, the latest release is resolved automatically.\n- `KIN_DIR`: Custom installation directory (defaults to `~/.kin`).\n- `KIN_NO_SETUP`: Set to `1` to skip the interactive setup wizard after the binaries are downloaded.\n\n### Runtime configuration\n\nThe Kin daemon is the canonical authority for graph truth. Commands that analyze the\ngraph in-process (`kin merge`, `kin release`, `kin semver`, `kin rollback`, `kin git export`)\nread from the daemon and auto-start it as needed — no configuration required for normal use.\n\n- `KIN_NO_DAEMON`: Set to `1` to disable daemon auto-start. The CLI will only use an\n  already-running daemon (or `KIN_DAEMON_URL`).\n- `KIN_DAEMON_URL`: Point the CLI at an explicit daemon endpoint instead of the\n  repo-local one.\n- `KIN_ALLOW_DAEMON_BOOTSTRAP_ADMIN`: Offline/admin escape hatch. Set to `1` to let\n  the above read-only commands fall back to reading the local `.kin` snapshot directly\n  when the daemon cannot be reached. Not needed for normal use, and never used for\n  writes — all graph mutations still route through the daemon.\n\n---\n\n## Quickstart\n\nSee [docs/quickstart.md](docs/quickstart.md) for the full end-to-end walkthrough.\n\n### 1. Initialize a repository\n\nBuild a semantic graph over your codebase:\n\n```sh\nkin init\n```\n\n*Options:*\n- `[PATH]`: Directory to initialize (defaults to the current directory).\n- `--force`: Initialize even if a `.git/` directory is detected.\n- `--git-history \u003coff|recent|full\u003e`: Git history import depth (default: `recent`).\n- `--no-lsp`: Skip LSP enrichment for a faster, tree-sitter-only init.\n\n### 2. Add embeddings (enables semantic search)\n\n`kin init` builds the graph instantly without embeddings. Run `kin embed` to add the\nvector index that powers semantic search and `kin locate`:\n\n```sh\nkin embed\n```\n\nEmbeddings are generated locally with `nomic-embed-text-v1.5` (768 dimensions; override\nvia `KIN_EMBED_MODEL_ID`). `kin status --json` reports embedding coverage under its\n`enrichment` block (`embeddingsIndexed` / `embeddingsPending` / `embeddingsTotal`).\n\n### 3. Configure your system and shell\n\nRun the setup wizard, or run health checks at any time:\n\n```sh\nkin setup\n```\n\n*Options:*\n- `status`: Show what's installed.\n- `doctor`: Run a quick health check.\n- `--mode \u003cnative|compatibility\u003e`: Repository operation mode.\n- `--shell \u003czsh|bash|powershell\u003e`: Target shell for profile updates.\n- `--auto-daemon`: Auto-start `kin-daemon` when entering workspaces.\n\n### 4. Everyday commands\n\n- **Status of the working copy**:\n  ```sh\n  kin status [--json]\n  ```\n- **Commit changes semantically**:\n  ```sh\n  kin commit -m \"commit message\"\n  ```\n- **Show the change log**:\n  ```sh\n  kin log [-n \u003ccount\u003e]\n  ```\n- **Semantic diff**:\n  ```sh\n  kin diff [\u003cbase\u003e] [\u003chead\u003e]\n  ```\n- **Search entities** (add `--semantic` for vector similarity over what is embedded):\n  ```sh\n  kin search \"\u003cpattern\u003e\" [--semantic] [--show-body]\n  ```\n- **Locate files relevant to an issue**:\n  ```sh\n  kin locate \"\u003cproblem text\u003e\" [--explain]\n  ```\n- **Eject and restore files**:\n  ```sh\n  kin eject [--force]\n  ```\n\n---\n\n## MCP Server Integration\n\nKin ships with a built-in MCP (Model Context Protocol) server that exposes semantic tools\nto AI assistants (Claude, Cursor, Gemini, Codex, etc.). It runs as a stdio server that the\nMCP client launches as a subprocess:\n\n```sh\nkin mcp start\n```\n\nFor the full tool surface, see [docs/mcp-tools.md](docs/mcp-tools.md).\n\n---\n\n## Architecture \u0026 Thesis\n\nTo understand the philosophy behind Kin, see the [thesis document](docs/thesis.md).\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"}