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 (mode 0600), making the key unpredictable even if hostname/username are known
File permissions: 0600 on 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".

picsee-short-link

PicSee Short Link

CLI Path

Quick Reference