idiolect-mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,32 +1,61 @@
-# idiolect-mcp
+# Idiolect Plugin
 
-MCP server that makes any MCP-compatible AI (Claude Desktop, Claude Code, …)
-write in **your** voice, using your [Idiolect](https://idiolect.lol) Voice Card.
+Write in **your** voice — everywhere your agent writes. Idiolect rewrites the prose
+an agent drafts on your behalf (commit messages, PR descriptions, docs, release
+notes, replies) into your own writing voice, and scores how close it got on a
+validated voice‑fidelity metric. Works in **Claude Code** and **Codex**.
 
 ## Setup
 
-1. Get your voice at **https://idiolect.lol** — note the slug in your result URL
-   (`idiolect.lol/v/<slug>`).
-2. Add to your MCP config:
-
-```json
-{
-  "mcpServers": {
-    "idiolect": {
-      "command": "npx",
-      "args": ["-y", "idiolect-mcp"],
-      "env": { "IDIOLECT_SLUG": "your-slug" }
-    }
-  }
-}
-```
-
-## Tool
-
-- **`get_my_voice`** — returns your Voice Card. The model calls it before writing
-  on your behalf, then writes as you. Pass `slug` per-call or set `IDIOLECT_SLUG`.
-
-Set `IDIOLECT_BASE` to point at a self-hosted instance (defaults to
-`https://idiolect.lol`).
-
-MIT licensed.
+1. **Get your API key** — sign in at <https://idiolect.lol/connect> and generate one.
+2. **Claude Code:**
+   ```
+   /plugin marketplace add 111mihir/idiolect-plugin
+   /plugin install idiolect@idiolect
+   ```
+   Then set your key in the environment Claude Code runs in:
+   ```
+   export IDIOLECT_API_KEY=idl_sk_your_key_here
+   ```
+3. **Codex:** register Idiolect as an MCP server — one command, no clone (it runs
+   via `npx`, writing an `[mcp_servers.idiolect]` entry to `~/.codex/config.toml`):
+   ```
+   codex mcp add idiolect \
+     --env IDIOLECT_API_KEY=idl_sk_your_key_here \
+     --env IDIOLECT_BASE=https://idiolect.lol \
+     -- npx -y github:111mihir/idiolect-plugin
+   ```
+
+The plugin bundles a self‑contained MCP server (`server.mjs`) — no `npm install`
+needed.
+
+## Slash commands
+
+Commands are namespaced by the plugin:
+
+- `/idiolect:voice` — show a summary of your writing voice.
+- `/idiolect:rewrite <text>` — rewrite text into your voice (+ Voice Match).
+- `/idiolect:draft <brief>` — draft new content from a brief, in your voice.
+- `/idiolect:check <text>` — score any text against your voice.
+
+## The skill
+
+The **in‑your‑voice** skill triggers automatically whenever the agent drafts prose
+for you: it calls `get_my_voice`, rewrites the draft via `rewrite_in_voice`, and
+shows the Voice Match — so everything you "write" through the agent sounds like you.
+
+## Tools (MCP)
+
+| Tool | What it does |
+| --- | --- |
+| `get_my_voice` | Load your Voice Card (call before writing on your behalf). |
+| `rewrite_in_voice` | Rewrite text in your voice; returns Voice Match + before→after delta. |
+| `draft_in_voice` | Draft new prose in your voice from a brief. |
+| `score_voice` | Voice Match of any text against your own writing. |
+
+Pro is required for `rewrite_in_voice` / `draft_in_voice`. Your voice and corpus
+live in your Idiolect account; the key resolves to them server‑side.
+
+---
+
+Built from the Idiolect monorepo. To regenerate `server.mjs`, run `plugin/build.sh`.

package/package.json

@@ -1,17 +1,13 @@
 {
   "name": "idiolect-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "description": "MCP server that makes any MCP-compatible agent (Claude Code, Codex, Claude Desktop) write in YOUR voice — rewrites/drafts/scores prose against your Idiolect voice, on a validated fidelity metric.",
   "type": "module",
   "bin": { "idiolect-mcp": "server.mjs" },
-  "description": "MCP server that gives any MCP-compatible AI (Claude, etc.) your Idiolect voice — make AI write as you. https://idiolect.lol",
-  "keywords": ["mcp", "model-context-protocol", "claude", "ai", "writing", "voice", "idiolect"],
+  "files": ["server.mjs"],
   "homepage": "https://idiolect.lol",
-  "repository": { "type": "git", "url": "https://github.com/111mihir/idiolect.git", "directory": "mcp" },
-  "license": "MIT",
-  "files": ["server.mjs", "README.md"],
-  "engines": { "node": ">=18" },
-  "publishConfig": { "access": "public" },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4"
-  }
+  "repository": { "type": "git", "url": "git+https://github.com/111mihir/idiolect-plugin.git" },
+  "keywords": ["mcp", "model-context-protocol", "claude", "codex", "ai", "writing", "voice", "idiolect", "ghostwriting"],
+  "author": "Idiolect (https://idiolect.lol)",
+  "license": "MIT"
 }