Manual Pricing Sign in

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, Codex, and Amp sync automatically — private by default, visible only to you.

  • Multi-provider: Claude Code, Codex, and Amp gathered in one place.
  • 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>"

4Amp BYOK

Jieli is an independently implemented Amp-compatible server. After you set AMP_URL, the Amp client connects to Jieli instead of Amp’s official server—similar to using the same game client with a compatible third-party server. Jieli is not an official Amp service and is not affiliated with Amp.

Amp officially supports BYOK (Bring Your Own Key), but it currently does not let you set a custom Base URL for a model provider. Jieli Amp BYOK supports both an API Key and a custom Base URL, so you can connect OpenAI- or Anthropic-compatible model providers. Requests routed through BYOK are billed by that provider and do not deduct Jieli balance.

Connect Amp to Jieli

Copy these environment variables from Settings → Account → Client configuration. AMP_API_KEY is your Jieli access token; configure the model provider API Key and Base URL separately under Settings → Models.

# Supports Amp version <= 0.0.1784177987-g5d539a
export AMP_URL=https://jieli.app
export AMP_API_KEY=<your-jieli-api-key>
Currently supported: Amp version <= 0.0.1784177987-g5d539a. Newer versions may be temporarily incompatible if the protocol changes.

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>
amp threads continue <thread>

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.

7Share threads

Every thread is private by default. To share, switch visibility to “unlisted” — anyone with the link can view it read-only — then copy the share link and send it.

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.