cord-bot 1.0.2 → 1.0.5

package/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Update npm for OIDC support
+        run: npm install -g npm@latest
+
+      - name: Publish to npm with provenance
+        run: npm publish --provenance --access public

package/README.md

@@ -1,27 +1,42 @@
 # Cord
 
-A simple bridge that connects Discord to Claude Code CLI.
+A Discord bot that connects to Claude Code CLI, plus a Claude Code skill that lets your assistant control the bot.
 
 > **cord** /kôrd/ — a connection between two things.
 
-When someone @mentions your bot, it:
-1. Creates a thread for the conversation
-2. Queues the message for Claude processing
-3. Posts Claude's response back to the thread
-4. Remembers context for follow-up messages
+[![npm version](https://badge.fury.io/js/cord-bot.svg)](https://www.npmjs.com/package/cord-bot)
 
-## Architecture
+## What You Get
 
-```
-Discord Bot  →  BullMQ Queue  →  Claude Spawner
- (Node.js)       (Redis)          (Bun)
+**Discord Bot** — @mention the bot in Discord, it spawns Claude Code to respond. Conversations happen in threads with full context preserved across messages.
+
+**Claude Code Skill** — Teaches your assistant to use the bot to send messages, embeds, files, and interactive buttons. Installed automatically during setup. No MCP server needed.
+
+## Quick Start
+
+```bash
+# Create a new Cord project
+bunx create-cord my-bot
+cd my-bot
+
+# Start Redis (if not already running)
+redis-server &
+
+# Start Cord
+cord start
 ```
 
-- **Bot** (`src/bot.ts`): Catches @mentions, creates threads, sends to queue
-- **Queue** (`src/queue.ts`): BullMQ job queue for reliable processing
-- **Worker** (`src/worker.ts`): Pulls jobs, spawns Claude, posts responses
-- **Spawner** (`src/spawner.ts`): The Claude CLI integration (the core)
-- **DB** (`src/db.ts`): SQLite for thread→session mapping
+<details>
+<summary>Alternative: Clone from GitHub</summary>
+
+```bash
+git clone https://github.com/alexknowshtml/cord.git my-bot
+cd my-bot
+bun install
+cord setup
+cord start
+```
+</details>
 
 ## Prerequisites
 
@@ -45,23 +60,19 @@ Discord Bot  →  BullMQ Queue  →  Claude Spawner
 
 **Note:** This runs 100% locally. The bot connects *outbound* to Discord's gateway - no need to expose ports or use ngrok.
 
-## Quick Start
-
-```bash
-# Install dependencies
-bun install
-
-# Set environment variables
-export DISCORD_BOT_TOKEN="your-bot-token"
-
-# Start Redis (if not already running)
-redis-server &
+## Architecture
 
-# Start the bot and worker
-bun run src/bot.ts &
-bun run src/worker.ts
+```
+Discord Bot  →  BullMQ Queue  →  Claude Spawner
+ (Node.js)       (Redis)          (Bun)
 ```
 
+- **Bot** (`src/bot.ts`): Catches @mentions, creates threads, sends to queue
+- **Queue** (`src/queue.ts`): BullMQ job queue for reliable processing
+- **Worker** (`src/worker.ts`): Pulls jobs, spawns Claude, posts responses
+- **Spawner** (`src/spawner.ts`): The Claude CLI integration (the core)
+- **DB** (`src/db.ts`): SQLite for thread→session mapping
+
 ## Environment Variables
 
 | Variable | Required | Default | Description |
@@ -72,41 +83,31 @@ bun run src/worker.ts
 | `CLAUDE_WORKING_DIR` | No | `cwd` | Working directory for Claude |
 | `DB_PATH` | No | `./data/threads.db` | SQLite database path |
 
-## How It Works
-
-### New Mentions
+## CLI Commands
 
-1. User @mentions the bot with a question
-2. Bot creates a thread from the message
-3. Bot generates a UUID session ID
-4. Bot stores thread_id → session_id in SQLite
-5. Bot queues a job with the prompt and session ID
-6. Worker picks up the job
-7. Worker spawns Claude with `--session-id UUID`
-8. Worker posts Claude's response to the thread
+Once running, Cord provides CLI commands for interacting with Discord:
 
-### Follow-up Messages
-
-1. User sends another message in the thread
-2. Bot looks up the session ID from SQLite
-3. Bot queues a job with `resume: true`
-4. Worker spawns Claude with `--resume UUID`
-5. Claude has full context from previous messages
-
-## Key CLI Flags
+```bash
+cord send <channel> "message"           # Send a message
+cord embed <channel> "text" --title "T" # Send formatted embed
+cord file <channel> ./report.md         # Send file attachment
+cord buttons <channel> "Pick:" --button label="Yes" id="yes" style="success"
+cord typing <channel>                   # Show typing indicator
+cord edit <channel> <msgId> "new text"  # Edit message
+cord delete <channel> <msgId>           # Delete message
+cord reply <channel> <msgId> "reply"    # Reply to message
+cord react <channel> <msgId> "emoji"    # Add reaction
+cord thread <channel> <msgId> "name"    # Create thread
+cord rename <threadId> "new name"       # Rename thread
+```
 
-The magic is in `src/spawner.ts`:
+See [skills/cord/SKILL.md](./skills/cord/SKILL.md) for full CLI documentation.
 
-```typescript
-// For new sessions:
-claude --print --session-id UUID -p "prompt"
+## HTTP API
 
-// For follow-ups:
-claude --print --resume UUID -p "prompt"
+Cord also exposes an HTTP API on port 2643 for external scripts and webhooks.
 
-// Inject context that survives compaction:
-claude --append-system-prompt "Current time: ..."
-```
+See [skills/cord/HTTP-API.md](./skills/cord/HTTP-API.md) for API documentation.
 
 ## License