@paparats/cli 0.2.2 → 0.2.3

package/README.md

@@ -1,6 +1,15 @@
 # @paparats/cli
 
-CLI for [Paparats MCP](https://github.com/IBazylchuk/paparats-mcp) — semantic code search across multiple repositories. MCP server powered by Qdrant vector search and Ollama embeddings, designed for AI coding assistants (Claude Code, Cursor).
+CLI for [Paparats MCP](https://github.com/IBazylchuk/paparats-mcp) - semantic code search across repositories with AST-based chunking, symbol graph, and vector search. Designed for AI coding assistants (Claude Code, Cursor).
+
+## Features
+
+- **AST-based code chunking** via tree-sitter (10 languages) with regex fallback
+- **Symbol graph** - cross-chunk call/reference relationships
+- **Vector search** powered by Qdrant + Ollama (Jina Code Embeddings)
+- **Git metadata** - commit history and ticket references per chunk
+- **Dual MCP endpoints** - coding mode and support mode with different tool sets
+- **Docker-based deployment** - one command setup with Qdrant, Ollama, and MCP server
 
 ## Install
 
@@ -10,27 +19,94 @@ npm install -g @paparats/cli
 
 ## Prerequisites
 
-- **Docker** + **Docker Compose** — runs Qdrant and MCP server
-- **Ollama** — local embedding model (on host)
+- **Docker** + **Docker Compose** - runs Qdrant, Ollama, and MCP server
+- **Node.js** >= 18
 
-## Quick start
+## Quick Start
 
 ```bash
-# 1. Ensure Docker, Docker Compose, and Ollama are installed
-docker --version && docker compose version && ollama --version
-
-# 2. One-time setup: starts Qdrant + MCP server, downloads GGUF (~1.6 GB)
+# 1. One-time setup: starts Docker containers, downloads embedding model (~1.6 GB)
 paparats install
 
-# 3. In your project
+# 2. In your project directory
 cd your-project
-paparats init   # creates .paparats.yml
-paparats index  # index the codebase
+paparats init    # creates .paparats.yml config
+paparats index   # index the codebase
 
-# 4. Run watch to keep the index in sync when files change
+# 3. Keep index in sync when files change
 paparats watch
 
-# 5. Connect your IDE (Cursor, Claude Code) to the MCP server
+# 4. Connect your IDE (Cursor, Claude Code) to the MCP server
+```
+
+## Install Modes
+
+```bash
+# Developer mode (default) - Docker stack + local project indexing
+paparats install --mode developer
+
+# Server mode - full Docker stack with auto-indexer for multiple repos
+paparats install --mode server --repos owner/repo1,owner/repo2
+
+# Support mode - client-only setup, connects to existing server
+paparats install --mode support --server http://your-server:9876
 ```
 
-See the [full documentation](https://github.com/IBazylchuk/paparats-mcp#readme) for MCP setup and configuration.
+## Commands
+
+| Command                   | Description                                      |
+| ------------------------- | ------------------------------------------------ |
+| `paparats install`        | Set up Docker containers and configure IDE       |
+| `paparats init`           | Create `.paparats.yml` config in current project |
+| `paparats index`          | Index the codebase (or reindex after changes)    |
+| `paparats watch`          | Watch for file changes and auto-reindex          |
+| `paparats search <query>` | Search indexed code from terminal                |
+| `paparats doctor`         | Check health of all services                     |
+| `paparats status`         | Show indexing status for current project         |
+
+## MCP Tools
+
+Once connected, your AI assistant gets access to these tools:
+
+**Coding mode** (`/mcp`): `search_code`, `get_chunk`, `find_usages`, `health_check`, `reindex`
+
+**Support mode** (`/support/mcp`): all coding tools plus `get_chunk_meta`, `search_changes`, `explain_feature`, `recent_changes`, `impact_analysis`
+
+## Configuration
+
+Project config lives in `.paparats.yml`:
+
+```yaml
+project: my-project
+group: my-group
+language: [typescript]
+
+indexing:
+  paths: [src, lib]
+  exclude: [node_modules, dist, '**/*.test.ts']
+
+chunking:
+  max_lines: 60
+  overlap_lines: 5
+
+metadata:
+  service: my-service
+  tags: [backend, api]
+```
+
+## Related Packages
+
+| Package                                                                 | Description                                             |
+| ----------------------------------------------------------------------- | ------------------------------------------------------- |
+| [@paparats/shared](https://www.npmjs.com/package/@paparats/shared)      | Shared utilities (path validation, gitignore, excludes) |
+| [ibaz/paparats-server](https://hub.docker.com/r/ibaz/paparats-server)   | MCP server Docker image                                 |
+| [ibaz/paparats-indexer](https://hub.docker.com/r/ibaz/paparats-indexer) | Auto-indexer Docker image                               |
+| [ibaz/paparats-ollama](https://hub.docker.com/r/ibaz/paparats-ollama)   | Ollama with pre-baked embedding model                   |
+
+## Documentation
+
+See the [full documentation](https://github.com/IBazylchuk/paparats-mcp#readme) for detailed setup guides, architecture overview, and configuration reference.
+
+## License
+
+MIT

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@paparats/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "mcpName": "io.github.IBazylchuk/paparats-mcp",
   "type": "module",
-  "description": "CLI for Paparats MCP — semantic code search for AI coding assistants",
+  "description": "CLI for Paparats MCP - semantic code search with AST chunking, symbol graph, and vector search for AI coding assistants",
   "license": "MIT",
   "author": "Ilya Bazylchuk",
   "homepage": "https://github.com/IBazylchuk/paparats-mcp#readme",
@@ -15,10 +15,16 @@
     "ollama",
     "cursor",
     "claude",
+    "claude-code",
     "model-context-protocol",
     "cli",
     "code-search",
-    "ai-assistant"
+    "ai-assistant",
+    "tree-sitter",
+    "ast",
+    "symbol-graph",
+    "docker",
+    "code-intelligence"
   ],
   "repository": {
     "type": "git",