npm package: @openthread/claude-code-plugin
Description: Share Claude Code conversations to OpenThread
Author: OpenThread
Latest version: 0.1.5

# @openthread/claude-code-plugin

Share Claude Code conversations to [OpenThread](https://openthread.me) -- a Reddit-like platform for AI conversation threads.

[![npm version](https://img.shields.io/npm/v/@openthread/claude-code-plugin)](https://www.npmjs.com/package/@openthread/claude-code-plugin)
[![license](https://img.shields.io/npm/l/@openthread/claude-code-plugin)](https://opensource.org/licenses/MIT)
[![downloads](https://img.shields.io/npm/dm/@openthread/claude-code-plugin)](https://www.npmjs.com/package/@openthread/claude-code-plugin)

## Install

```bash
npm i -g @openthread/claude-code-plugin
```

The postinstall script registers the plugin with Claude Code automatically. Restart Claude Code after installing.

## Quick Start

```
> /ot:share fixing auth bug

Sharing conversation to OpenThread...
Auto-generated title: "Debugging PKCE token refresh in auth middleware"
Community: Coding with AI
Tags: typescript, authentication, debugging

Post shared successfully!
View it at: https://openthread.me/post/abc123
```

## Examples

### Share instantly with quick mode

```
> /ot:share building a REST API with Hono
```

Auto-generates title, picks the best community, adds tags, and posts -- no questions asked.

### Share interactively

```
> /ot:share

? Title: Building a REST API with Hono on Bun
? Community:
  > Coding with AI
    Prompt Engineering
    OpenThread Meta
? Tags: typescript, hono, api

Post shared successfully!
View it at: https://openthread.me/post/def456
```

### Share after a long debugging session

```
> /ot:share tracked down a memory leak in the worker pool
```

The plugin reads the full conversation, generates a summary, and shares it as a post others can learn from.

### Share from any project

The plugin auto-detects the current Claude Code session file. Works in any project directory -- just run `/ot:share` and it finds the right conversation.

## Features

- **One-command sharing** -- run `/ot:share` inside any Claude Code session to publish the conversation to OpenThread.
- **Quick mode** -- `/ot:share <description>` auto-generates a title, selects a community, and posts immediately.
- **Interactive mode** -- `/ot:share` with no arguments prompts you to choose a title, community, and tags.
- **Secure auth** -- PKCE OAuth flow with automatic token refresh. Credentials are stored locally at `~/.config/openthread/`.
- **CLI management** -- `openthread-claude` binary for install, uninstall, status checks, and updates.

## Usage

### Quick mode

```
/ot:share <short description of what you worked on>
```

Provide a short description after `/ot:share`. The plugin generates a title from the conversation context, picks the best-matching community, and posts without further prompts.

### Interactive mode

```
/ot:share
```

Run with no arguments to step through each field:

1. Title (suggested from conversation, editable)
2. Community (selectable from list)
3. Tags (suggested, accept or modify)

## CLI Commands

| Command | Description |
| --- | --- |
| `openthread-claude install` | Install and register the plugin with Claude Code |
| `openthread-claude uninstall` | Remove the plugin and deregister from Claude Code |
| `openthread-claude status` | Show plugin installation and registration state |
| `openthread-claude update` | Reinstall plugin (update to current version) |

## Configuration

Environment variables override the default endpoints. Set them in your shell profile or `.env` file.

| Variable | Default | Description |
| --- | --- | --- |
| `OPENTHREAD_API_URL` | `https://openthread.me/api` | Backend API base URL |
| `OPENTHREAD_WEB_URL` | `https://openthread.me` | Web app base URL (used for post links) |

## Manual Install

If you prefer not to use npm:

1. Download the latest `.zip` release from [openthread.me/extensions](https://openthread.me/extensions).
2. Extract it to `~/.claude/plugins/openthread-share/`.
3. Run `openthread-claude install` to register with Claude Code.
4. Restart Claude Code.

```bash
mkdir -p ~/.claude/plugins/openthread-share
unzip openthread-claude-code-plugin.zip -d ~/.claude/plugins/openthread-share/
```

## License

MIT