Owner's Manual

Welcome to Jieli

Jieli syncs your AI coding threads to the cloud and turns them into searchable, shareable engineering context you can hand off across agents. This manual helps you get the most out of it.

1Why Jieli

Jieli (jiē lì) is the pinyin for 接力 — Chinese for “relay.” Switch tools or open a fresh session and the full context is passed to the next runner, so the task keeps going without dropping the baton. That hand-off is exactly what the name is about.

Jieli is a cloud sync plus browse / search / share platform for AI coding threads. Once the plugin is installed, your sessions in Claude Code and Codex sync automatically — private by default, visible only to you.

Multi-provider: Claude Code and Codex gathered in one place, with support for other agents planned.
Searchable: turn scattered conversations into full-text engineering memory.
Shareable: generate a read-only link to share a debugging session with a teammate.
Hand-off ready: continue with full context across sessions and tools.

Jieli works alongside the plugins. It stores the session records synced by plugins, your original sessions stay on your machine, and every thread exports to md / json so you can always keep your own copy.

2Get started

Sign in to jieli.app with GitHub to create an account.
Copy your access token (API key) from Settings.
Install the Jieli plugin in your coding tool (next section).
From then on, sessions sync automatically through plugin hooks.

3Install the plugin

Claude Code

Run these in your shell:

claude plugin marketplace add jieliapp/plugins
claude plugin install jieli@jieliapp

Codex

Run these in your shell:

codex plugin marketplace add jieliapp/plugins
codex plugin add jieli@jieliapp

Then configure the API key: paste it into the chat for the agent to store, export it as an env var, or write it to ~/.config/jieli/settings.json.

export JIELI_API_KEY="<api-key-from-jieli.app>"

4Sync historical sessions

With Node.js 20+, run this command in your terminal to sync historical Claude Code and Codex sessions:

curl -fsSLo jieli-sync.mjs https://jieli.app/jieli-sync.mjs && node jieli-sync.mjs

The script uses your plugin configuration and prompts for missing settings. For self-hosting, set JIELI_BASE_URL or base_url in ~/.config/jieli/settings.json to your instance URL.

5Browse & search

The threads list supports full-text search and filters by provider, repository, label, visibility, and archived state, so you can find a past thread fast.

The plugin also lets an agent search your history directly — give it a keyword, filename, or repo clue and it calls Jieli to pull relevant threads back as context.

GET /plugin/threads?search=<query>&provider=claude_code&sort=updated

6Resume & cross-agent hand-off

This is the heart of Jieli: a thread's context doesn't have to stay trapped in its original session — carry it into a new session, or even a different tool, and keep going.

Resume in the same tool

On a thread page, click “Open in CLI” to get a resume command for its provider:

claude --resume <session>
codex resume <session>

Cross-agent hand-off

The handoff skill extracts the key information and relevant files from the current thread, writes a hand-off context, and attaches the Jieli thread ID. Give that hand-off (or just the thread link) to a fresh agent — possibly in another tool — and it picks up seamlessly.

When the new agent receives a Jieli thread link, the jieli skill triggers automatically and reads the thread’s markdown export to load the full context.

Paste a single /threads/T-… link and the new session inherits the previous goal, decisions, touched files, and open tasks — no need to re-explain.

Commit trailers (great for code review)

Commits created by Claude Code carry a trailer pointing back to the Jieli thread behind the change:

Jieli-Thread: https://jieli.app/threads/T-...

During code review, click that link to see the full reasoning behind the commit — why it was done this way, what was tried, what was verified — not just the final diff.

8Export & archive

Every thread exports to Markdown or JSON. Archive threads you no longer need to tuck them out of the default list.

Deletion is irreversible and cannot be recovered from Jieli. Export md / json first to keep your own copy.

9Plans

Free keeps up to 30,000 messages with full browse / search / share / export; Pro includes unlimited message storage. See the full comparison atpricing.