@qtv/anchorkit 1.0.0-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clever Lopes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# AnchorKit
+
+AI-native coding CLI with a persistent, project-scoped knowledge vault.
+
+AnchorKit wraps the AI agents you already use (Claude Code, Cursor, or
+direct API access to Anthropic / OpenAI / Gemini) and adds:
+
+- a Markdown vault under `.anchorkit/vault/` that survives across
+  sessions — decisions, incidents, module maps, runbooks
+- slash commands for spec-driven work, code review, security review,
+  vault search, and more
+- an MCP server you can plug into Claude Code so the same vault is
+  visible to both tools
+
+## Install
+
+```bash
+npm install -g @qtv/anchorkit
+```
+
+Requires **Node ≥ 20**. The native SQLite binding ships as a prebuilt
+binary for Linux x64/arm64, macOS x64/arm64, and Windows x64; on other
+platforms `npm install` will compile it (Python + a C++ toolchain
+required).
+
+You also need at least one AI backend on your `PATH` or configured via
+an API key:
+
+| Backend | How |
+|---|---|
+| [Claude Code CLI](https://claude.com/claude-code) | `claude login` |
+| [Cursor CLI](https://cursor.com/cli) | install + sign in |
+| Anthropic API | `export ANTHROPIC_API_KEY=...` |
+| OpenAI API | `export OPENAI_API_KEY=...` |
+| Gemini API | `export GEMINI_API_KEY=...` |
+
+Pick one inside the REPL with `/connect`.
+
+## Quick start
+
+```bash
+cd your-project
+anchorkit onboard      # first time: scaffolds .anchorkit/vault/
+anchorkit              # opens the REPL
+```
+
+Inside the REPL:
+
+- `/help` — list every command
+- `/connect` — choose the AI backend
+- `/vault-map` — index the codebase into `.anchorkit/vault/`
+- `/vault-query <query>` — semantic search across the vault
+- `/commit` — generate a conventional-commit message from the staged diff
+- `/review` / `/security-review` — code review and OWASP review of the diff
+- `/exit` — quit
+
+## Resume a session
+
+```bash
+anchorkit --resume                # resume the most recent session
+anchorkit --resume <session-id>   # resume a specific saved session
+```
+
+Sessions live under `.anchorkit/state.json` per project.
+
+## Use AnchorKit as an MCP server inside Claude Code
+
+`anchorkit internal-mcp-server` boots a stdio-based MCP server that
+exposes the vault tools (`VaultQuery`, `VaultMap`, `VaultWrite`,
+`TodoWrite`, plan-mode helpers) to any MCP client. The typical wiring
+is via Claude Code's `.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "anchorkit": {
+      "command": "anchorkit",
+      "args": ["internal-mcp-server"]
+    }
+  }
+}
+```
+
+After that, Claude Code can read/write your vault and reuse the same
+context AnchorKit's REPL builds up.
+
+## What's in the vault
+
+`anchorkit onboard` lays out an Obsidian-compatible Zettelkasten under
+`.anchorkit/vault/`:
+
+```
+.anchorkit/vault/
+├── CLAUDE.md          ← project rules and conventions (auto-injected)
+├── PROJECT.md         ← project vision
+├── STATE.md           ← persistent state across sessions
+├── knowledge/         ← concepts, patterns, module docs
+├── decisions/         ← ADRs
+├── incidents/         ← debugging sagas, root causes
+├── flows/             ← workflows, pipelines, runbooks
+├── maps/              ← Maps of Content (index notes)
+├── archive/           ← superseded knowledge
+└── _sessions/         ← session lifecycle notes
+```
+
+Everything is plain Markdown, so the vault is portable and reviewable
+in git.
+
+## Beta status
+
+This is a `1.0.0-beta` release. The API surface (slash commands, vault
+schema, MCP tools) is stable; cloud sync features are wired but
+disabled by default. Set `ANCHORKIT_SYNC_DISABLE=1` to silence sync
+errors when you have no credentials.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).
+
+## Links
+
+- Repository: <https://github.com/QTVentures/anchorkit-ai>
+- Issues: <https://github.com/QTVentures/anchorkit-ai/issues>

package/bin/anchorkit

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Node ≥ 20 required. The sync manifest uses better-sqlite3 (native bindings
+// installed via npm prebuild), and the build output is plain ESM.
+import('../dist/cli.mjs').catch((err) => {
+  console.error('anchorkit: failed to start');
+  console.error(err);
+  process.exit(1);
+});