moss-cli 0.1.0__tar.gz

moss_cli-0.1.0/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) 2026 InferEdge Inc.
+
+Licensed under the PolyForm Shield License 1.0.0.
+https://polyformproject.org/licenses/shield/1.0.0
+
+For commercial licensing, contact contact@usemoss.dev.

moss_cli-0.1.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: moss-cli
+Version: 0.1.0
+Summary: Command-line interface for Moss semantic search
+Author-email: "InferEdge Inc." <contact@usemoss.dev>
+Keywords: search,semantic,cli,moss
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: moss>=1.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: flake8>=7.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# Moss CLI
+
+**Command-line interface for Moss semantic search** — manage indexes, documents, and queries directly from your terminal.
+
+Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
+
+## Features
+
+- ⚡ **Full SDK coverage** — every SDK operation available as a CLI command
+- 🔍 **Semantic search** — query indexes with configurable hybrid search (semantic + keyword)
+- 📦 **Index management** — create, list, inspect, and delete indexes
+- 📄 **Document management** — add, update, retrieve, and delete documents
+- 🚀 **Local by default** — downloads indexes for on-device queries, `--cloud` to skip
+- 🔧 **Flexible auth** — CLI flags, environment variables, or config file
+- 📊 **Multiple output formats** — rich tables for humans, `--json` for scripts
+- ⏳ **Job tracking** — poll background jobs with live progress display
+- 🔗 **Pipe-friendly** — stdin/stdout support for composing with other tools
+
+## Installation
+
+```bash
+pip install moss-cli
+```
+
+## Quick Start
+
+```bash
+# 1. Save your credentials
+moss init
+
+# 2. List your indexes
+moss index list
+
+# 3. Create an index from a JSON file
+moss index create my-index -f docs.json --wait
+
+# 4. Search it
+moss query my-index "what is machine learning"
+
+# 5. Search via cloud API (skips local download)
+moss query my-index "neural networks" --cloud
+```
+
+## Authentication
+
+Credentials are resolved in this order:
+
+1. **CLI flags**: `--project-id` and `--project-key`
+2. **Environment variables**: `MOSS_PROJECT_ID` and `MOSS_PROJECT_KEY`
+3. **Config file**: `~/.moss/config.json` (created by `moss init`)
+
+```bash
+# Option 1: Interactive setup (recommended)
+moss init
+
+# Option 2: Environment variables
+export MOSS_PROJECT_ID="your-project-id"
+export MOSS_PROJECT_KEY="your-project-key"
+
+# Option 3: Inline flags
+moss index list --project-id "..." --project-key "..."
+```
+
+## Commands
+
+### Index Management
+
+```bash
+# Create an index with documents from a JSON file
+moss index create my-index -f documents.json --model moss-minilm
+
+# Create and wait for completion
+moss index create my-index -f documents.json --wait
+
+# List all indexes
+moss index list
+
+# Get index details
+moss index get my-index
+
+# Delete an index
+moss index delete my-index
+moss index delete my-index --confirm  # skip prompt
+```
+
+### Document Management
+
+```bash
+# Add documents to an existing index
+moss doc add my-index -f new-docs.json
+
+# Add with upsert (update existing, insert new)
+moss doc add my-index -f docs.json --upsert --wait
+
+# Get all documents
+moss doc get my-index
+
+# Get specific documents
+moss doc get my-index --ids doc1,doc2,doc3
+
+# Delete documents
+moss doc delete my-index --ids doc1,doc2
+```
+
+### Query
+
+```bash
+# Search (downloads index and queries on-device by default)
+moss query my-index "what is deep learning"
+
+# Tune results: more results, keyword-heavy
+moss query my-index "neural networks" --top-k 20 --alpha 0.3
+
+# Cloud mode (skip download, query via cloud API)
+moss query my-index "transformers" --cloud
+
+# With metadata filter (local only)
+moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq": "footwear"}}'
+
+# Pipe query from stdin
+echo "what is AI" | moss query my-index
+
+# JSON output for scripting
+moss query my-index "query" --json | jq '.docs[0].text'
+```
+
+### Job Tracking
+
+```bash
+# Check job status
+moss job status <job-id>
+
+# Wait for job to finish (with live progress)
+moss job status <job-id> --wait
+```
+
+### Other
+
+```bash
+# Print version info
+moss version
+
+# Global JSON output
+moss index list --json
+moss doc get my-index --json
+```
+
+## Document File Format
+
+### JSON (recommended)
+
+```json
+[
+  {"id": "doc1", "text": "Machine learning fundamentals", "metadata": {"topic": "ml"}},
+  {"id": "doc2", "text": "Deep learning with neural networks"},
+  {"id": "doc3", "text": "Natural language processing", "metadata": {"topic": "nlp"}}
+]
+```
+
+Also supports a wrapper format: `{"documents": [...]}`.
+
+### CSV
+
+```csv
+id,text,metadata
+doc1,Machine learning fundamentals,"{""topic"": ""ml""}"
+doc2,Deep learning with neural networks,
+doc3,Natural language processing,"{""topic"": ""nlp""}"
+```
+
+### stdin
+
+```bash
+cat docs.json | moss index create my-index -f -
+cat docs.json | moss doc add my-index -f -
+```
+
+## Global Options
+
+| Flag | Short | Description |
+|---|---|---|
+| `--project-id` | `-p` | Project ID (overrides env/config) |
+| `--project-key` | | Project key (overrides env/config) |
+| `--json` | | Machine-readable JSON output |
+| `--verbose` | `-v` | Enable debug logging |
+
+## Available Models
+
+| Model | Description |
+|---|---|
+| `moss-minilm` | Lightweight, optimized for speed (default) |
+| `moss-mediumlm` | Balanced accuracy and performance |
+| `custom` | Used automatically when documents include embeddings |
+
+## License
+
+Copyright (c) 2026 InferEdge Inc. — PolyForm Shield License 1.0.0.
+
+See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@usemoss.dev.

moss_cli-0.1.0/README.md

@@ -0,0 +1,199 @@
+# Moss CLI
+
+**Command-line interface for Moss semantic search** — manage indexes, documents, and queries directly from your terminal.
+
+Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
+
+## Features
+
+- ⚡ **Full SDK coverage** — every SDK operation available as a CLI command
+- 🔍 **Semantic search** — query indexes with configurable hybrid search (semantic + keyword)
+- 📦 **Index management** — create, list, inspect, and delete indexes
+- 📄 **Document management** — add, update, retrieve, and delete documents
+- 🚀 **Local by default** — downloads indexes for on-device queries, `--cloud` to skip
+- 🔧 **Flexible auth** — CLI flags, environment variables, or config file
+- 📊 **Multiple output formats** — rich tables for humans, `--json` for scripts
+- ⏳ **Job tracking** — poll background jobs with live progress display
+- 🔗 **Pipe-friendly** — stdin/stdout support for composing with other tools
+
+## Installation
+
+```bash
+pip install moss-cli
+```
+
+## Quick Start
+
+```bash
+# 1. Save your credentials
+moss init
+
+# 2. List your indexes
+moss index list
+
+# 3. Create an index from a JSON file
+moss index create my-index -f docs.json --wait
+
+# 4. Search it
+moss query my-index "what is machine learning"
+
+# 5. Search via cloud API (skips local download)
+moss query my-index "neural networks" --cloud
+```
+
+## Authentication
+
+Credentials are resolved in this order:
+
+1. **CLI flags**: `--project-id` and `--project-key`
+2. **Environment variables**: `MOSS_PROJECT_ID` and `MOSS_PROJECT_KEY`
+3. **Config file**: `~/.moss/config.json` (created by `moss init`)
+
+```bash
+# Option 1: Interactive setup (recommended)
+moss init
+
+# Option 2: Environment variables
+export MOSS_PROJECT_ID="your-project-id"
+export MOSS_PROJECT_KEY="your-project-key"
+
+# Option 3: Inline flags
+moss index list --project-id "..." --project-key "..."
+```
+
+## Commands
+
+### Index Management
+
+```bash
+# Create an index with documents from a JSON file
+moss index create my-index -f documents.json --model moss-minilm
+
+# Create and wait for completion
+moss index create my-index -f documents.json --wait
+
+# List all indexes
+moss index list
+
+# Get index details
+moss index get my-index
+
+# Delete an index
+moss index delete my-index
+moss index delete my-index --confirm  # skip prompt
+```
+
+### Document Management
+
+```bash
+# Add documents to an existing index
+moss doc add my-index -f new-docs.json
+
+# Add with upsert (update existing, insert new)
+moss doc add my-index -f docs.json --upsert --wait
+
+# Get all documents
+moss doc get my-index
+
+# Get specific documents
+moss doc get my-index --ids doc1,doc2,doc3
+
+# Delete documents
+moss doc delete my-index --ids doc1,doc2
+```
+
+### Query
+
+```bash
+# Search (downloads index and queries on-device by default)
+moss query my-index "what is deep learning"
+
+# Tune results: more results, keyword-heavy
+moss query my-index "neural networks" --top-k 20 --alpha 0.3
+
+# Cloud mode (skip download, query via cloud API)
+moss query my-index "transformers" --cloud
+
+# With metadata filter (local only)
+moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq": "footwear"}}'
+
+# Pipe query from stdin
+echo "what is AI" | moss query my-index
+
+# JSON output for scripting
+moss query my-index "query" --json | jq '.docs[0].text'
+```
+
+### Job Tracking
+
+```bash
+# Check job status
+moss job status <job-id>
+
+# Wait for job to finish (with live progress)
+moss job status <job-id> --wait
+```
+
+### Other
+
+```bash
+# Print version info
+moss version
+
+# Global JSON output
+moss index list --json
+moss doc get my-index --json
+```
+
+## Document File Format
+
+### JSON (recommended)
+
+```json
+[
+  {"id": "doc1", "text": "Machine learning fundamentals", "metadata": {"topic": "ml"}},
+  {"id": "doc2", "text": "Deep learning with neural networks"},
+  {"id": "doc3", "text": "Natural language processing", "metadata": {"topic": "nlp"}}
+]
+```
+
+Also supports a wrapper format: `{"documents": [...]}`.
+
+### CSV
+
+```csv
+id,text,metadata
+doc1,Machine learning fundamentals,"{""topic"": ""ml""}"
+doc2,Deep learning with neural networks,
+doc3,Natural language processing,"{""topic"": ""nlp""}"
+```
+
+### stdin
+
+```bash
+cat docs.json | moss index create my-index -f -
+cat docs.json | moss doc add my-index -f -
+```
+
+## Global Options
+
+| Flag | Short | Description |
+|---|---|---|
+| `--project-id` | `-p` | Project ID (overrides env/config) |
+| `--project-key` | | Project key (overrides env/config) |
+| `--json` | | Machine-readable JSON output |
+| `--verbose` | `-v` | Enable debug logging |
+
+## Available Models
+
+| Model | Description |
+|---|---|
+| `moss-minilm` | Lightweight, optimized for speed (default) |
+| `moss-mediumlm` | Balanced accuracy and performance |
+| `custom` | Used automatically when documents include embeddings |
+
+## License
+
+Copyright (c) 2026 InferEdge Inc. — PolyForm Shield License 1.0.0.
+
+See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@usemoss.dev.

moss_cli-0.1.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "moss-cli"
+version = "0.1.0"
+description = "Command-line interface for Moss semantic search"
+readme = "README.md"
+requires-python = ">=3.10"
+license-files = ["LICENSE"]
+authors = [
+    { name = "InferEdge Inc.", email = "contact@usemoss.dev" }
+]
+keywords = ["search", "semantic", "cli", "moss"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "moss>=1.0.0",
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "black>=24.0.0",
+    "isort>=5.0.0",
+    "flake8>=7.0.0",
+    "mypy>=1.0.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
+[project.scripts]
+moss = "moss_cli.main:run"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.black]
+line-length = 88
+target-version = ['py310']
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = false
+warn_unused_configs = true
+disallow_untyped_defs = true
+ignore_missing_imports = true

moss_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

moss_cli-0.1.0/src/moss_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Moss CLI - Command-line interface for Moss semantic search."""
+
+__version__ = "0.1.0"

moss_cli-0.1.0/src/moss_cli/commands/doc.py

@@ -0,0 +1,101 @@
+"""moss doc {add, delete, get} commands."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from moss import MossClient, GetDocumentsOptions, MutationOptions
+
+from .. import output
+from ..config import resolve_credentials
+from ..documents import load_documents
+from ..job_waiter import wait_for_job
+
+console = Console()
+doc_app = typer.Typer(name="doc", help="Manage documents in an index")
+
+
+def _client(ctx: typer.Context) -> MossClient:
+    pid, pkey = resolve_credentials(
+        ctx.obj.get("project_id"), ctx.obj.get("project_key")
+    )
+    return MossClient(pid, pkey)
+
+
+@doc_app.command(name="add")
+def add(
+    ctx: typer.Context,
+    index_name: str = typer.Argument(..., help="Index name"),
+    file: str = typer.Option(..., "--file", "-f", help="Path to JSON/CSV document file, or '-' for stdin"),
+    upsert: bool = typer.Option(False, "--upsert", "-u", help="Update existing documents"),
+    wait: bool = typer.Option(False, "--wait", "-w", help="Wait for job to complete"),
+    poll_interval: float = typer.Option(2.0, "--poll-interval", help="Seconds between status checks"),
+) -> None:
+    """Add documents to an index."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+    docs = load_documents(file)
+
+    options = MutationOptions(upsert=True) if upsert else None
+
+    if not json_mode:
+        console.print(
+            f"Adding {len(docs)} document(s) to [cyan]{index_name}[/cyan]"
+            f"{' (upsert)' if upsert else ''}..."
+        )
+
+    result = asyncio.run(client.add_docs(index_name, docs, options))
+    output.print_mutation_result(result, json_mode=json_mode)
+
+    if wait:
+        asyncio.run(wait_for_job(client, result.job_id, poll_interval, json_mode))
+
+
+@doc_app.command(name="delete")
+def delete(
+    ctx: typer.Context,
+    index_name: str = typer.Argument(..., help="Index name"),
+    ids: str = typer.Option(..., "--ids", "-i", help="Comma-separated document IDs"),
+    wait: bool = typer.Option(False, "--wait", "-w", help="Wait for job to complete"),
+    poll_interval: float = typer.Option(2.0, "--poll-interval", help="Seconds between status checks"),
+) -> None:
+    """Delete documents from an index by ID."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+    doc_ids = [i.strip() for i in ids.split(",") if i.strip()]
+
+    if not doc_ids:
+        output.print_error("No document IDs provided.", json_mode=json_mode)
+        raise typer.Exit(1)
+
+    if not json_mode:
+        console.print(f"Deleting {len(doc_ids)} document(s) from [cyan]{index_name}[/cyan]...")
+
+    result = asyncio.run(client.delete_docs(index_name, doc_ids))
+    output.print_mutation_result(result, json_mode=json_mode)
+
+    if wait:
+        asyncio.run(wait_for_job(client, result.job_id, poll_interval, json_mode))
+
+
+@doc_app.command(name="get")
+def get(
+    ctx: typer.Context,
+    index_name: str = typer.Argument(..., help="Index name"),
+    ids: Optional[str] = typer.Option(None, "--ids", "-i", help="Comma-separated document IDs (omit for all)"),
+) -> None:
+    """Retrieve documents from an index."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+
+    options = None
+    if ids:
+        doc_ids = [i.strip() for i in ids.split(",") if i.strip()]
+        options = GetDocumentsOptions(doc_ids=doc_ids)
+
+    docs = asyncio.run(client.get_docs(index_name, options))
+    output.print_doc_table(docs, json_mode=json_mode)

moss_cli-0.1.0/src/moss_cli/commands/index.py

@@ -0,0 +1,92 @@
+"""moss index {create, list, get, delete} commands."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from moss import MossClient
+
+from .. import output
+from ..config import resolve_credentials
+from ..documents import load_documents
+from ..job_waiter import wait_for_job
+
+console = Console()
+index_app = typer.Typer(name="index", help="Manage indexes")
+
+
+def _client(ctx: typer.Context) -> MossClient:
+    pid, pkey = resolve_credentials(
+        ctx.obj.get("project_id"), ctx.obj.get("project_key")
+    )
+    return MossClient(pid, pkey)
+
+
+@index_app.command(name="create")
+def create(
+    ctx: typer.Context,
+    name: str = typer.Argument(..., help="Index name"),
+    file: str = typer.Option(..., "--file", "-f", help="Path to JSON/CSV document file, or '-' for stdin"),
+    model: Optional[str] = typer.Option(None, "--model", "-m", help="Model ID (default: moss-minilm)"),
+    wait: bool = typer.Option(False, "--wait", "-w", help="Wait for job to complete"),
+    poll_interval: float = typer.Option(2.0, "--poll-interval", help="Seconds between status checks"),
+) -> None:
+    """Create a new index with documents."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+    docs = load_documents(file)
+
+    if not json_mode:
+        console.print(f"Creating index [cyan]{name}[/cyan] with {len(docs)} document(s)...")
+
+    result = asyncio.run(client.create_index(name, docs, model))
+    output.print_mutation_result(result, json_mode=json_mode)
+
+    if wait:
+        asyncio.run(wait_for_job(client, result.job_id, poll_interval, json_mode))
+
+
+@index_app.command(name="list")
+def list_indexes(ctx: typer.Context) -> None:
+    """List all indexes."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+    indexes = asyncio.run(client.list_indexes())
+    output.print_index_table(indexes, json_mode=json_mode)
+
+
+@index_app.command(name="get")
+def get(
+    ctx: typer.Context,
+    name: str = typer.Argument(..., help="Index name"),
+) -> None:
+    """Get details of an index."""
+    json_mode = ctx.obj.get("json_output", False)
+    client = _client(ctx)
+    info = asyncio.run(client.get_index(name))
+    output.print_index_detail(info, json_mode=json_mode)
+
+
+@index_app.command(name="delete")
+def delete(
+    ctx: typer.Context,
+    name: str = typer.Argument(..., help="Index name"),
+    confirm: bool = typer.Option(False, "--confirm", "-y", help="Skip confirmation"),
+) -> None:
+    """Delete an index."""
+    json_mode = ctx.obj.get("json_output", False)
+    if not confirm and not json_mode:
+        typer.confirm(f"Delete index '{name}'?", abort=True)
+
+    client = _client(ctx)
+    result = asyncio.run(client.delete_index(name))
+
+    if result:
+        output.print_success(f"Index '{name}' deleted.", json_mode=json_mode)
+    else:
+        output.print_error(f"Failed to delete index '{name}'.", json_mode=json_mode)
+        raise typer.Exit(1)