papiers 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -3
- package/dist/index.js +785 -356
- package/package.json +3 -2
- package/skills/papiers-research/SKILL.md +116 -0
package/README.md
CHANGED
|
@@ -15,19 +15,42 @@ Requires Node.js 22 or newer.
|
|
|
15
15
|
In Papiers, open Settings -> API tokens, create a token, then sign in:
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
-
papiers auth login
|
|
18
|
+
papiers auth login
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
Paste the token when prompted. The CLI saves it locally so you do not need to
|
|
22
22
|
paste it again.
|
|
23
23
|
|
|
24
|
+
## Use with an AI agent
|
|
25
|
+
|
|
26
|
+
This is what `papiers` is really for. Point a coding or research agent (Claude
|
|
27
|
+
Code, Cursor, your own harness) at the CLI and it can ground its work in *your
|
|
28
|
+
own reading* — the papers you saved, the passages you highlighted, the notes
|
|
29
|
+
you wrote, the conversations you had — instead of generic web knowledge.
|
|
30
|
+
|
|
31
|
+
The package ships a ready-to-use agent skill at
|
|
32
|
+
[`skills/papiers-research/SKILL.md`](skills/papiers-research/SKILL.md). It
|
|
33
|
+
encodes the loop — survey what you've been reading, search across passages +
|
|
34
|
+
highlights + conversations in one ranking, then read and cite your own sources.
|
|
35
|
+
Hand that file to your agent (or drop it in its skills directory) and ask it to
|
|
36
|
+
propose an idea, design an experiment, or review a draft. It will think with
|
|
37
|
+
your library, not around it.
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
# the agent only needs your token in its environment:
|
|
41
|
+
export PAPIERS_TOKEN=pap_live_...
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Every data command emits a stable JSON envelope (`--json` makes errors JSON
|
|
45
|
+
too), so an agent can learn the whole tool from `papiers --help --all` alone.
|
|
46
|
+
|
|
24
47
|
## Common Commands
|
|
25
48
|
|
|
26
49
|
```bash
|
|
27
|
-
papiers capabilities
|
|
28
50
|
papiers list --kind document --limit 5
|
|
29
51
|
papiers search "retrieval augmented generation" --limit 10
|
|
30
52
|
papiers read doc_... --format markdown
|
|
53
|
+
papiers doctor # check your setup and connection
|
|
31
54
|
```
|
|
32
55
|
|
|
33
56
|
Use `--json` for stable machine-readable output. Use `--ids`, `--ids0`, and
|
|
@@ -35,4 +58,4 @@ Use `--json` for stable machine-readable output. Use `--ids`, `--ids0`, and
|
|
|
35
58
|
|
|
36
59
|
## Automation
|
|
37
60
|
|
|
38
|
-
For
|
|
61
|
+
For scripts and automation, set `PAPIERS_TOKEN` and pass `--json` for stable machine-readable output.
|