jike

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](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.