Jieli Plugins

Plugins for syncing AI coding sessions to Jieli.

Claude Code Install

Add the marketplace in Claude Code:

/plugin marketplace add jieliapp/plugins

Install the plugin:

/plugin install claude-code@jieli

Then get an API key from https://jieli.app and configure it for Claude Code.

When Claude Code opens the plugin configuration screen, set:

Jieli API key = your-jieli-api-key

Reload plugins:

/reload-plugins

You can also set it through your shell environment before starting Claude Code:

export JIELI_API_KEY="your-jieli-api-key"

Codex Install

Add the marketplace in Codex:

codex plugin marketplace add jieliapp/plugins

Install the plugin:

codex plugin add codex@jieli

Then enable the plugin and trust its hooks with /hooks.

Configure the API key. Recommended for Codex and Claude Code: write ~/.config/jieli/settings.json, which works even after the agent is already running:

mkdir -p ~/.config/jieli
python3 - <<'PY'
import json
from pathlib import Path

path = Path.home() / ".config/jieli/settings.json"
settings = {"api_key": "your-jieli-api-key", "base_url": "https://jieli.app"}
path.write_text(json.dumps(settings, indent=2) + "\n")
path.chmod(0o600)
PY

You can also use environment variables before starting Codex:

export JIELI_API_KEY="your-jieli-api-key"

What It Does

• Syncs Claude Code sessions to Jieli threads.
• Syncs local Codex sessions to Jieli threads.
• Uploads pasted local images as Jieli attachments.
• Adds Claude-Code-Thread-ID trailers to Claude-created git commits.
• Adds best-effort Jieli-Thread trailers to simple Codex-created git commit commands.
• Provides the jieli-read skill for reading known Jieli thread links or ids.
• Provides the jieli-find skill for searching synced Jieli threads by keywords, repo, file, topic, or clues.
• Redacts common secrets before upload.

Development

make test
make validate