javimosch PicSee Short Link
URL shortener with QR code generation, analytics charts, and link management via CLI.
Works with any agent that can run shell commands (OpenClaw, Claude Code, Codex, etc.).
CLI Path
node ~/.openclaw/workspace/skills/picsee-short-link/cli/dist/cli.js
For brevity, examples below use picsee as alias.
Quick Reference
Shorten a URL
picsee shorten "https://example.com/long-url"
picsee shorten "https://example.com" --slug mylink
picsee shorten "https://example.com" --slug mylink --domain pse.is --title "My Title" --tags seo,marketing
Analytics
picsee analytics mylink
Generate Analytics Chart
picsee chart mylink
Fetches analytics and returns a QuickChart URL visualizing daily clicks.
Generate QR Code
picsee qr "https://pse.is/mylink"
picsee qr "https://pse.is/mylink" --size 500
List Links
picsee list
picsee list --limit 10
picsee list --start "2026-03-31T23:59:59" --keyword "campaign"
picsee list --tag seo --starred
--start queries backward from that time (default: now). Use the END of the period, e.g. 2026-03-31T23:59:59 for March 2026.
Edit a Link
picsee edit mylink --url "https://new-destination.com"
picsee edit mylink --slug newslug --title "New Title" --tags a,b,c
Requires Advanced plan.
Delete / Recover
picsee delete mylink
picsee recover mylink
Authentication
picsee auth <token>
picsee auth-status
Token source: https://picsee.io → avatar → Settings → API → Copy token.
Help
picsee help
Full Options
shorten
| Flag | Description |
|---|---|
--slug <slug> |
Custom slug (3-90 chars) |
--domain <domain> |
Short link domain (default: pse.is) |
--title <title> |
Preview title (Advanced plan) |
--desc <desc> |
Preview description (Advanced plan) |
--image <url> |
Preview thumbnail (Advanced plan) |
--tags t1,t2 |
Comma-separated tags (Advanced plan) |
--utm s:m:c:t:n |
UTM params — source:medium:campaign:term:content |
list
| Flag | Description |
|---|---|
--start <time> |
Query backward from this time (default: now) |
--limit <n> |
Results per page (1-50, default 50) |
--keyword <kw> |
Search title/description (Advanced, 3-30 chars) |
--tag <tag> |
Filter by tag (Advanced) |
--url <url> |
Filter by exact destination URL |
--slug <slug> |
Filter by exact slug |
--starred |
Starred links only |
--api-only |
API-generated links only |
--cursor <mapId> |
Pagination cursor |
edit
| Flag | Description |
|---|---|
--url <url> |
New destination URL |
--slug <slug> |
New slug |
--domain <domain> |
New domain |
--title <title> |
New preview title |
--desc <desc> |
New preview description |
--image <url> |
New preview thumbnail |
--tags t1,t2 |
New tags |
--expire <iso> |
Expiration time (ISO 8601) |
Auth Modes
| Mode | API Host | Features |
|---|---|---|
| Unauthenticated | chrome-ext.picsee.tw |
Create short links only |
| Authenticated | api.pics.ee |
Create + analytics + list + search + edit + delete |
Auto-detected: if encrypted token exists at ~/.openclaw/.picsee_token, authenticated mode is used.
Security
- Token encryption: AES-256-CBC, IV stored alongside ciphertext
- Key derivation:
SHA-256(random-salt + hostname + "-" + username)— the 32-byte random salt is generated once and stored at~/.openclaw/.picsee_salt(mode0600), making the key unpredictable even if hostname/username are known - File permissions:
0600on both token and salt files
Agent Recipes (Post-Processing)
Download QR Code as Image
After picsee qr, download and send the image:
mkdir -p ~/.openclaw/workspace/skills/picsee-short-link/tmp
curl -s -o ~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_qr.png "<originalQrUrl>"
Send via message tool with filePath: "~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_qr.png".
Download Chart as Image
After picsee chart, download and send the image:
mkdir -p ~/.openclaw/workspace/skills/picsee-short-link/tmp
curl -s -o ~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_chart.png "<originalChartUrl>"
Send via message tool with filePath: "~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_chart.png".