Jike Skill

Task

Enable AI agents to interact with the Jike social network: browse feeds, post, comment, search, and check notifications. Auth is QR scan (no passwords).

Process

0. Install As A Codex Plugin

When the user asks how to install or enable this repository for Codex, use the Codex plugin marketplace route:

codex plugin marketplace add MidnightDarling/jike-skill
codex plugin marketplace upgrade jike-skill

Then ask the user to fully restart Codex, open /plugins, and confirm that Jike from jike-skill is installed and enabled. A successful Codex install loads the packaged skill from:

~/.codex/plugins/cache/jike-skill/jike/<version>/skills/jike/SKILL.md

Do not rely on this root SKILL.md alone for Codex plugin discovery. It is useful documentation, but Codex loads the installed plugin copy from its marketplace cache.

1. Authenticate

Run scripts/auth.py — user scans the QR with Jike app:

python3 scripts/auth.py

QR rendering depends on the optional qrcode[pil] extra:

If qrcode is installed: a temporary HTML page (PNG embedded as base64) is written to a unique tempfile and its file:// URI is printed — open it in a browser to scan. The same QR is also rendered as ASCII to stderr as a fallback. The HTML file is created with mode 0o600 and automatically removed when the auth flow exits.
If qrcode is not installed: the raw jike:// URL is printed for manual scanning. Install with pip install jike-skill[qr].

Outputs JSON with access_token and refresh_token to stdout. Save the refresh_token for reuse (long validity, avoids re-scanning).

Prefer environment variables for subsequent commands:

export JIKE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
export JIKE_REFRESH_TOKEN="YOUR_REFRESH_TOKEN"

2. Interact

Run scripts/client.py with any command:

# Browse feed
python3 scripts/client.py feed

# Post
python3 scripts/client.py post --content "Hello"

# Search
python3 scripts/client.py search --keyword "AI"

# User profile
python3 scripts/client.py profile --username "someone"

3. Token Lifecycle

All commands auto-refresh on 401 (transparent to caller)
If refresh fails, re-run scripts/auth.py
Only dependency: requests (standard, likely already installed)

Operations

Command	Description	Key Args
`feed`	Following feed	`--limit`
`post`	Create post	`--content`
`delete-post`	Remove post	`--post-id`
`comment`	Comment on post	`--post-id`, `--content`
`delete-comment`	Remove comment	`--comment-id`
`search`	Search content	`--keyword`, `--limit`
`profile`	User profile	`--username`
`user-posts`	List user's posts	`--username`, `--limit`
`notifications`	Unread + list	—

3. Export All Posts

Run scripts/export.py to export a user's entire post history to Markdown:

python3 scripts/export.py --username USERNAME \
  --output posts.md --download-images --json-dump

Flag	Description
`--username`	Jike username to export
`--output`	Output file (default: `<username>_jike_export.md`)
`--download-images`	Download images locally
`--images-dir`	Custom directory for images
`--json-dump`	Also save raw JSON alongside Markdown

The export automatically:

Paginates through all posts (rate-limited)
Preserves images (inline URLs or downloaded)
Includes repost/share content with original author
Sorts chronologically (oldest first)
Includes topic tags and link attachments

Bundled Resources

scripts/auth.py — Standalone QR auth, no pip install needed
scripts/client.py — Standalone API client, no pip install needed
scripts/export.py — Full post history export to Markdown
references/api.md — Complete API endpoint reference (read when needed)

API Reference

For endpoint details, headers, and request/response formats: see references/api.md.

Security

No password auth — QR scan only (same as Jike web)
All requests require Origin: https://web.okjike.com header
Tokens auto-refresh; only refresh_token needs persistence
QR HTML page is written to an unpredictable tempfile path (no symlink TOCTOU window), with 0o600 permissions on POSIX, and is removed before the auth flow returns. Caption text is HTML-escaped.

jike