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

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

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.