{"_id":"@coctostan/kotadb","name":"@coctostan/kotadb","dist-tags":{"latest":"2.2.1"},"versions":{"2.2.1":{"name":"@coctostan/kotadb","version":"2.2.1","description":"Local-only code intelligence tool for CLI agents. SQLite-backed repository indexing and code search via MCP.","type":"module","module":"src/index.ts","bin":{"kotadb":"src/cli.ts"},"keywords":["mcp","code-search","code-intelligence","sqlite","cli","claude-code","model-context-protocol"],"author":{"name":"Maxwell Newman"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/coctostan/kotadb.git"},"bugs":{"url":"https://github.com/coctostan/kotadb/issues"},"homepage":"https://github.com/coctostan/kotadb#readme","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun --watch src/index.ts","start":"bun run src/index.ts","test":"bun test --preload ./tests/setup.ts","check":"bun run typecheck","typecheck":"bunx tsc --noEmit","build":"bun run typecheck","lint":"bunx biome lint","test:validate-env":"! grep -rn 'process\\.env\\.\\(SUPABASE_URL\\|DATABASE_URL\\)\\s*=\\s*[\"\\x27]' tests/ || (echo 'ERROR: Found hardcoded environment variable string assignments in tests/' && exit 1)","prepare":"husky || true","prepublishOnly":"bun run typecheck && bun run lint"},"dependencies":{"@asteasolutions/zod-to-openapi":"^8.4.0","@modelcontextprotocol/sdk":"^1.26.0","@sentry/node":"^10.38.0","@typescript-eslint/parser":"8.54.0","@typescript-eslint/types":"8.55.0","bcryptjs":"^2.4.3","chokidar":"^5.0.0","cors":"^2.8.6","express":"^4.18.0","zod":"^4.3.6"},"devDependencies":{"@apidevtools/swagger-parser":"^12.1.0","@biomejs/biome":"^1.7.3","@types/bcryptjs":"^2.4.6","@types/cors":"^2.8.19","@types/express":"^4.17.21","@types/node":"^25.2.2","@types/supertest":"^6.0.3","bun-types":"^1.3.9","husky":"^9.1.7","lint-staged":"^16.2.4","supertest":"^7.2.2","typescript":"^5.9.3"},"overrides":{"@typescript-eslint/types":"8.55.0"},"gitHead":"1e01fcce2a8300f8f2a6cf7cd0bb818b7c90d510","_id":"@coctostan/kotadb@2.2.1","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-Hc1qnjl2L+ZHv6+FoiYUqxFChHSajqEacHbJbh0OjAGGRu8OrTEe6ur7RRExhpyZi7u4DhAFvQ1GEYTBMUib4A==","shasum":"5a4dbfe60e8e3d1ac4bfca248c605eb137abcb72","tarball":"https://registry.npmjs.org/@coctostan/kotadb/-/kotadb-2.2.1.tgz","fileCount":79,"unpackedSize":596573,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCN5MVclwncXl5Siu3K0/K+J3sANefmbzkMieo9kxd8nQIhAKjTMSs7B3TK0lG4WblOkkpfA4XWYZVfKm+xZr9s8Skx"}]},"_npmUser":{"name":"coctostan","email":"macnewma@gmail.com"},"directories":{},"maintainers":[{"name":"coctostan","email":"macnewma@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kotadb_2.2.1_1772400541287_0.09269577408766727"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-01T21:29:01.205Z","2.2.1":"2026-03-01T21:29:01.467Z","modified":"2026-03-01T21:29:01.649Z"},"maintainers":[{"name":"coctostan","email":"macnewma@gmail.com"}],"description":"Local-only code intelligence tool for CLI agents. SQLite-backed repository indexing and code search via MCP.","homepage":"https://github.com/coctostan/kotadb#readme","keywords":["mcp","code-search","code-intelligence","sqlite","cli","claude-code","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/coctostan/kotadb.git"},"author":{"name":"Maxwell Newman"},"bugs":{"url":"https://github.com/coctostan/kotadb/issues"},"license":"MIT","readme":"# KotaDB Application Layer\n\nThis directory contains the TypeScript/Bun HTTP API service for indexing and searching code repositories.\n\n## Quick Start\n\n### Prerequisites\n\n- [Bun](https://bun.sh) v1.1+\n\n### Install Dependencies\n\n```bash\nbun install\n```\n\n### Run the Server\n\n```bash\n# Development mode with watch\nbun --watch src/index.ts\n\n# Production mode\nbun run src/index.ts\n\n# Custom port\nPORT=4000 bun run src/index.ts\n```\n\nThe server will start on port 3000 by default. Data is stored in `.kotadb/kota.db` within your project directory.\n\n## Development Commands\n\n### Type Checking and Linting\n\n```bash\nbunx tsc --noEmit    # Type-check without emitting files\nbun run lint         # Biome linting\n```\n\n### Testing\n\n```bash\n# Run tests\nbun test\n```\n\n## Project Structure\n\n```\nsrc/\n  api/          # HTTP routes and database queries\n  db/           # SQLite client and database utilities\n  indexer/      # Git repository indexing logic\n  mcp/          # Model Context Protocol implementation\n  types/        # Shared TypeScript types\n\ntests/          # Test suite\n  api/          # API endpoint tests\n  indexer/      # Indexer tests\n  mcp/          # MCP protocol tests\n  helpers/      # Test utilities\n\nscripts/        # Bash scripts for development\n```\n\n## API Endpoints\n\n- `GET /health` - Health check\n- `POST /index` - Index a repository\n- `GET /search?term=query` - Search indexed files\n- `GET /files/recent` - List recently indexed files\n- `POST /mcp` - Model Context Protocol endpoint\n\n## Learn More\n\n- [Repository Overview](../README.md)\n- [Architecture Documentation](../CLAUDE.md)\n- [Database Schema](../docs/schema.md)\n","readmeFilename":"README.md","_rev":"1-5b17a63c06e2ca0acc0c032ed2fd0353"}