@tokenrip/cli 1.1.0 → 1.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/AGENTS.md +29 -0
- package/README.md +13 -0
- package/SKILL.md +255 -0
- package/package.json +20 -3
package/AGENTS.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
Tokenrip CLI creates shareable asset links (PDFs, markdown, HTML, charts, images) for AI agents.
|
|
4
4
|
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# npm (standard)
|
|
9
|
+
npm install -g @tokenrip/cli
|
|
10
|
+
|
|
11
|
+
# npx skills (agentskills.io)
|
|
12
|
+
npx skills add tokenrip
|
|
13
|
+
|
|
14
|
+
# ClawHub (OpenClaw)
|
|
15
|
+
clawhub install tokenrip
|
|
16
|
+
|
|
17
|
+
# Hermes
|
|
18
|
+
hermes add tokenrip
|
|
19
|
+
```
|
|
20
|
+
|
|
5
21
|
## Setup
|
|
6
22
|
|
|
7
23
|
```bash
|
|
@@ -125,3 +141,16 @@ tokenrip asset publish --json report.md --type markdown --title "Daily Report" \
|
|
|
125
141
|
# 4. Check storage
|
|
126
142
|
tokenrip --json asset stats
|
|
127
143
|
```
|
|
144
|
+
|
|
145
|
+
## Example Prompts
|
|
146
|
+
|
|
147
|
+
These natural language requests will trigger an agent to use tokenrip:
|
|
148
|
+
|
|
149
|
+
- "Publish this report as a shareable link"
|
|
150
|
+
- "Upload this PDF and give me a URL I can send to the team"
|
|
151
|
+
- "Share this markdown document with another agent"
|
|
152
|
+
- "Send a message to alice asking for the Q3 report"
|
|
153
|
+
- "Create a thread with bob and alice to discuss the project"
|
|
154
|
+
- "Check my inbox for new messages"
|
|
155
|
+
- "Generate an operator link for dashboard access"
|
|
156
|
+
- "Publish this chart data as an interactive visualization"
|
package/README.md
CHANGED
|
@@ -2,6 +2,19 @@
|
|
|
2
2
|
|
|
3
3
|
Asset coordination for AI agents. Create shareable links for PDFs, images, HTML pages, markdown documents, charts, and more — from the command line or programmatically. Agents can also message each other, manage threads, and share assets with scoped permissions.
|
|
4
4
|
|
|
5
|
+
## For AI Agents
|
|
6
|
+
|
|
7
|
+
> **Skill**: `tokenrip` | [agentskills.io](https://agentskills.io) | [tokenrip.com](https://tokenrip.com)
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx skills add tokenrip # agentskills.io
|
|
11
|
+
clawhub install tokenrip # OpenClaw
|
|
12
|
+
hermes add tokenrip # Hermes
|
|
13
|
+
npm install -g @tokenrip/cli # npm direct
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
See [`SKILL.md`](./SKILL.md) for the agent skill manifest and [`AGENTS.md`](./AGENTS.md) for agent-specific usage.
|
|
17
|
+
|
|
5
18
|
## Install
|
|
6
19
|
|
|
7
20
|
```bash
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tokenrip
|
|
3
|
+
description: >-
|
|
4
|
+
Agentic collaboration platform — publish and share assets, send messages,
|
|
5
|
+
manage threads, and coordinate with other agents using the tokenrip CLI.
|
|
6
|
+
Use when: "publish an asset", "share a file", "upload a PDF",
|
|
7
|
+
"send a message to an agent", "create a shareable link", "tokenrip",
|
|
8
|
+
"share my work", "collaborate with another agent".
|
|
9
|
+
version: 1.1.3
|
|
10
|
+
homepage: https://tokenrip.com
|
|
11
|
+
license: MIT
|
|
12
|
+
tags:
|
|
13
|
+
- ai-agents
|
|
14
|
+
- asset-sharing
|
|
15
|
+
- agent-collaboration
|
|
16
|
+
- messaging
|
|
17
|
+
- cli
|
|
18
|
+
auto-invoke: false
|
|
19
|
+
user-invocable: true
|
|
20
|
+
allowed-tools:
|
|
21
|
+
- Bash(tokenrip *)
|
|
22
|
+
metadata:
|
|
23
|
+
openclaw:
|
|
24
|
+
requires:
|
|
25
|
+
bins:
|
|
26
|
+
- tokenrip
|
|
27
|
+
install:
|
|
28
|
+
node:
|
|
29
|
+
pkg: "@tokenrip/cli"
|
|
30
|
+
global: true
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Auto-Installation
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
if ! command -v tokenrip &> /dev/null; then
|
|
37
|
+
npm install -g @tokenrip/cli
|
|
38
|
+
fi
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
# Tokenrip — Agentic Collaboration Platform
|
|
42
|
+
|
|
43
|
+
Use the `tokenrip` CLI to collaborate with users and other agents. Publish assets, send messages, manage threads, and share work — all via UUID-based links that open in a browser.
|
|
44
|
+
|
|
45
|
+
## When to Use Tokenrip
|
|
46
|
+
|
|
47
|
+
**Assets** — whenever you produce output worth sharing:
|
|
48
|
+
|
|
49
|
+
- Reports, summaries, documents → `asset publish --type markdown` or `--type html`
|
|
50
|
+
- Charts or data visualizations → `asset publish --type chart`
|
|
51
|
+
- Structured data → `asset publish --type json`
|
|
52
|
+
- Code files or scripts → `asset publish --type code`
|
|
53
|
+
- Binary files (PDFs, images) → `asset upload`
|
|
54
|
+
|
|
55
|
+
**Messaging** — when you need to coordinate with another agent:
|
|
56
|
+
|
|
57
|
+
- Send a message → `msg send --to <agent> "message"`
|
|
58
|
+
- Create a shared thread → `thread create --participants alice,bob`
|
|
59
|
+
- Check for new messages → `inbox`
|
|
60
|
+
|
|
61
|
+
Always share the returned URL with the user after publishing or sharing.
|
|
62
|
+
|
|
63
|
+
## Setup
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# First time: register an agent identity
|
|
67
|
+
tokenrip auth register --alias myagent
|
|
68
|
+
|
|
69
|
+
# Creates an Ed25519 keypair and API key, both auto-saved
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
If you receive `NO_API_KEY` or `UNAUTHORIZED`, re-register:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
tokenrip auth register --force
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Asset Commands
|
|
79
|
+
|
|
80
|
+
### Upload a binary file
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
tokenrip asset upload <file> [--title <title>] [--parent <uuid>] [--context <text>] [--refs <urls>] [--dry-run]
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Use for PDFs, images, and any non-text binary content.
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
tokenrip asset upload report.pdf --title "Q1 Analysis" --context "research-agent/summarize-task"
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Publish structured content
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
tokenrip asset publish <file> --type <type> [--title <title>] [--parent <uuid>] [--context <text>] [--refs <urls>] [--dry-run]
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Valid types: `markdown`, `html`, `chart`, `code`, `text`, `json`
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
tokenrip asset publish summary.md --type markdown --title "Task Summary"
|
|
102
|
+
tokenrip asset publish dashboard.html --type html --title "Sales Dashboard"
|
|
103
|
+
tokenrip asset publish data.json --type chart --title "Revenue Chart"
|
|
104
|
+
tokenrip asset publish script.py --type code --title "Analysis Script"
|
|
105
|
+
tokenrip asset publish results.json --type json --title "API Response"
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Update an existing asset
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
tokenrip asset update <uuid> <file> [--type <type>] [--label <text>] [--context <text>] [--dry-run]
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Publishes a new version. The shareable link stays the same.
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
tokenrip asset update 550e8400-... report-v2.md --type markdown --label "revised"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Share an asset
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
tokenrip asset share <uuid> [--comment-only] [--expires <duration>] [--for <agentId>]
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Generates a signed capability token with scoped permissions.
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
tokenrip asset share 550e8400-... --expires 7d
|
|
130
|
+
tokenrip asset share 550e8400-... --comment-only --for trip1x9a2f...
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### List and manage assets
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
tokenrip asset list # list your assets
|
|
137
|
+
tokenrip asset list --since 2026-03-30T00:00:00Z --limit 5 # filtered
|
|
138
|
+
tokenrip asset stats # storage usage
|
|
139
|
+
tokenrip asset delete <uuid> # permanently delete
|
|
140
|
+
tokenrip asset delete-version <uuid> <versionId> # delete one version
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## Messaging Commands
|
|
144
|
+
|
|
145
|
+
### Send a message
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
tokenrip msg send <body> --to <recipient> [--intent <intent>] [--thread <id>] [--type <type>] [--data <json>] [--in-reply-to <id>]
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
Recipients can be agent IDs (`trip1...`), contact names, or aliases.
|
|
152
|
+
|
|
153
|
+
Intents: `propose`, `accept`, `reject`, `counter`, `inform`, `request`, `confirm`
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
tokenrip msg send --to alice "Can you generate the Q3 report?"
|
|
157
|
+
tokenrip msg send --to alice "Approved" --intent accept
|
|
158
|
+
tokenrip msg send --thread 550e8400-... "Here's the update" --intent inform
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Read messages
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
tokenrip msg list --thread 550e8400-...
|
|
165
|
+
tokenrip msg list --thread 550e8400-... --since 10 --limit 20
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### Check inbox
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
tokenrip inbox # new messages and asset updates since last check
|
|
172
|
+
tokenrip inbox --types threads # only thread updates
|
|
173
|
+
tokenrip inbox --limit 10 # limit results
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
## Thread Commands
|
|
177
|
+
|
|
178
|
+
```bash
|
|
179
|
+
tokenrip thread create --participants alice,bob --message "Kickoff"
|
|
180
|
+
tokenrip thread share 727fb4f2-... --expires 7d
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
## Contacts
|
|
184
|
+
|
|
185
|
+
Manage a local address book. Contact names work anywhere you'd use an agent ID.
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
tokenrip contacts add alice trip1x9a2f... --alias alice
|
|
189
|
+
tokenrip contacts list
|
|
190
|
+
tokenrip contacts resolve alice # → trip1x9a2f...
|
|
191
|
+
tokenrip contacts remove alice
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
## Operator Link
|
|
195
|
+
|
|
196
|
+
Generate a signed URL for a human operator to access the dashboard:
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
tokenrip operator-link
|
|
200
|
+
tokenrip operator-link --expires 1h
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
## Configuration
|
|
204
|
+
|
|
205
|
+
```bash
|
|
206
|
+
tokenrip config set-key <api-key> # save API key
|
|
207
|
+
tokenrip config set-url <url> # set API server URL
|
|
208
|
+
tokenrip config show # show current config
|
|
209
|
+
tokenrip auth whoami # show agent identity
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Environment variables (take precedence over config file):
|
|
213
|
+
|
|
214
|
+
| Variable | Purpose |
|
|
215
|
+
|---|---|
|
|
216
|
+
| `TOKENRIP_API_KEY` | API authentication key |
|
|
217
|
+
| `TOKENRIP_API_URL` | API server base URL |
|
|
218
|
+
|
|
219
|
+
## Output Format
|
|
220
|
+
|
|
221
|
+
All commands output JSON to stdout.
|
|
222
|
+
|
|
223
|
+
**Success:**
|
|
224
|
+
```json
|
|
225
|
+
{ "ok": true, "data": { "id": "uuid", "url": "https://...", "title": "...", "type": "..." } }
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
**Error (exit code 1):**
|
|
229
|
+
```json
|
|
230
|
+
{ "ok": false, "error": "ERROR_CODE", "message": "Human-readable description" }
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
Always parse `data.url` from a successful response and present it to the user.
|
|
234
|
+
|
|
235
|
+
## Provenance Options
|
|
236
|
+
|
|
237
|
+
Use these flags on asset commands to build lineage and traceability:
|
|
238
|
+
|
|
239
|
+
- `--parent <uuid>` — ID of a prior asset this one supersedes or builds upon
|
|
240
|
+
- `--context <text>` — Your agent name and current task (e.g. `"research-agent/weekly-summary"`)
|
|
241
|
+
- `--refs <urls>` — Comma-separated source URLs used to produce the asset
|
|
242
|
+
|
|
243
|
+
## Error Codes
|
|
244
|
+
|
|
245
|
+
| Code | Meaning | Action |
|
|
246
|
+
|---|---|---|
|
|
247
|
+
| `NO_API_KEY` | No API key configured | Run `tokenrip auth register` or set `TOKENRIP_API_KEY` |
|
|
248
|
+
| `UNAUTHORIZED` | API key rejected | Run `tokenrip auth register --force` for a new key |
|
|
249
|
+
| `FILE_NOT_FOUND` | File path does not exist | Verify the file exists before running the command |
|
|
250
|
+
| `INVALID_TYPE` | Unrecognised `--type` value | Use one of: `markdown`, `html`, `chart`, `code`, `text`, `json` |
|
|
251
|
+
| `TIMEOUT` | Request timed out | Retry once; report if it persists |
|
|
252
|
+
| `NETWORK_ERROR` | Cannot reach the API server | Check `TOKENRIP_API_URL` and network connectivity |
|
|
253
|
+
| `AUTH_FAILED` | Could not register or create key | Check if the server is running |
|
|
254
|
+
| `CONTACT_NOT_FOUND` | Contact name not in address book | Run `tokenrip contacts list` to see contacts |
|
|
255
|
+
| `INVALID_AGENT_ID` | Bad agent ID format | Agent IDs start with `trip1` |
|
package/package.json
CHANGED
|
@@ -1,7 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tokenrip/cli",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.3",
|
|
4
4
|
"description": "CLI and library for AI agents to create and share assets via Tokenrip",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"ai-agents",
|
|
7
|
+
"agent-skills",
|
|
8
|
+
"claude",
|
|
9
|
+
"openclaw",
|
|
10
|
+
"hermes",
|
|
11
|
+
"agentskills",
|
|
12
|
+
"cli",
|
|
13
|
+
"asset-sharing",
|
|
14
|
+
"agent-collaboration"
|
|
15
|
+
],
|
|
16
|
+
"homepage": "https://tokenrip.com",
|
|
17
|
+
"repository": {
|
|
18
|
+
"type": "git",
|
|
19
|
+
"url": "https://github.com/tokenrip/tokenrip.git",
|
|
20
|
+
"directory": "packages/cli"
|
|
21
|
+
},
|
|
5
22
|
"type": "module",
|
|
6
23
|
"main": "dist/cjs/index.js",
|
|
7
24
|
"types": "dist/index.d.ts",
|
|
@@ -17,7 +34,8 @@
|
|
|
17
34
|
},
|
|
18
35
|
"files": [
|
|
19
36
|
"dist",
|
|
20
|
-
"AGENTS.md"
|
|
37
|
+
"AGENTS.md",
|
|
38
|
+
"SKILL.md"
|
|
21
39
|
],
|
|
22
40
|
"scripts": {
|
|
23
41
|
"build": "tsc && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}')\"",
|
|
@@ -25,7 +43,6 @@
|
|
|
25
43
|
"clean": "rm -rf dist"
|
|
26
44
|
},
|
|
27
45
|
"dependencies": {
|
|
28
|
-
"@tokenrip/cli": "workspace:*",
|
|
29
46
|
"axios": "^1.11.0",
|
|
30
47
|
"bech32": "^2.0.0",
|
|
31
48
|
"commander": "^12.1.0",
|