@mantra-ai/cli 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,94 @@
+# @mantra-ai/cli
+
+Local-first research paper management from your terminal.
+
+Add papers by DOI, PMID, arXiv ID, or PDF file. Mantra resolves metadata, fetches open-access full text, and normalizes everything into a structured local library backed by SQLite.
+
+## Install
+
+```bash
+npm install -g @mantra-ai/cli
+```
+
+Supports macOS (Apple Silicon & Intel) and Linux (x64 & ARM64).
+
+## Quick start
+
+```bash
+mantra add 10.1038/s41586-024-07487-w   # add by DOI
+mantra add paper.pdf                     # add from a local PDF
+mantra init                              # start a project in the current directory
+mantra papers                            # list papers
+mantra search "CRISPR"                   # full-text search
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `add [inputs...]` | Add papers by DOI, PMID, PMCID, arXiv ID, or PDF path |
+| `init [name]` | Initialize a project in the current directory |
+| `papers` | List papers in the library or current project |
+| `show <id>` | Show full details for a paper |
+| `search <query>` | Full-text search with snippets |
+| `export` | Export as BibTeX, JSON, or CSV |
+| `update [id]` | Re-resolve metadata from upstream sources |
+| `remove <id>` | Remove a paper from the library or unlink from a project |
+| `library` | Show library stats |
+| `config` | Manage settings and API keys |
+
+Use `mantra <command> --help` for detailed options.
+
+## How it works
+
+When you add a paper, Mantra:
+
+1. **Detects the identifier type** (DOI, PMID, PMCID, arXiv ID) and resolves all cross-references via Crossref, OpenAlex, EuropePMC, and source-specific APIs
+2. **Fetches the full text** using a prioritized chain of open-access sources, preferring structured JATS XML when available
+3. **Normalizes the content** into a canonical structured format with sections, blocks, citations, and metadata. For PDFs without JATS XML, it uses Gemini to extract structure
+4. **Stores everything locally** in a SQLite database with full-text search
+
+### Supported sources
+
+Crossref, OpenAlex, EuropePMC, bioRxiv, medRxiv, arXiv, PLOS.
+
+## Projects
+
+Mantra organizes papers into per-directory projects, similar to how git works with repositories. Run `mantra init` in any directory to create a project, then `mantra add` to link papers to it.
+
+```bash
+mkdir my-review && cd my-review
+mantra init
+mantra add 10.1234/example
+mantra papers --project    # list only this project's papers
+mantra search "method" -p  # search within the project
+```
+
+## Configuration
+
+```bash
+mantra config list          # view all settings
+mantra config set key val   # set a config value
+mantra config path          # show config file location
+```
+
+### API keys
+
+For PDF-to-structured-text conversion (when JATS XML is unavailable), set a Gemini API key:
+
+```bash
+mantra config set geminiApiKey YOUR_KEY
+```
+
+Or use the environment variable `GEMINI_API_KEY`.
+
+## Global options
+
+| Flag | Description |
+|---|---|
+| `--json` | Output as JSON |
+| `--no-interactive` | Suppress interactive prompts |
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantra-ai/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CLI for mantra — reverse-engineer research papers into structured data",
   "license": "MIT",
   "bin": {
@@ -10,9 +10,9 @@
     "bin/mantra"
   ],
   "optionalDependencies": {
-    "@mantra-ai/cli-darwin-arm64": "0.1.0",
-    "@mantra-ai/cli-darwin-x64": "0.1.0",
-    "@mantra-ai/cli-linux-x64": "0.1.0",
-    "@mantra-ai/cli-linux-arm64": "0.1.0"
+    "@mantra-ai/cli-darwin-arm64": "0.1.2",
+    "@mantra-ai/cli-darwin-x64": "0.1.2",
+    "@mantra-ai/cli-linux-x64": "0.1.2",
+    "@mantra-ai/cli-linux-arm64": "0.1.2"
   }
 }