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"

For self-hosted Jieli, also set:

export JIELI_BASE_URL="https://your-jieli.example.com"

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: write ~/.jieli/settings.json, which works even after Codex is already running:

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

path = Path.home() / ".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

For self-hosted Jieli, set base_url to your deployment URL. You can also use environment variables before starting Codex:

export JIELI_API_KEY="your-jieli-api-key"
export JIELI_BASE_URL="https://your-jieli.example.com"

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 skill for reading Jieli thread links from Claude Code.
• Provides the jieli skill for reading Jieli thread links from Codex.
• Redacts common secrets before upload.

Development

make test
make validate