@unravel-tech/thing 0.3.0 → 0.4.1

package/README.md

@@ -1,10 +1,10 @@
 # @unravel-tech/thing
 
-CLI for [thing](https://thing.unravel.tech): push, version, and share artifacts — HTML pages, Markdown docs, standalone images and PDFs — from coding agents.
+CLI for [thing](https://usething.ai): push, version, and share artifacts (HTML pages, Markdown docs, standalone images and PDFs) from coding agents.
 
 ```sh
 npm i -g @unravel-tech/thing
-thing login                          # defaults to https://thing.unravel.tech
+thing login                          # defaults to https://usething.ai
 thing push report.html --json
 thing push notes.md --json           # Markdown gets a styled reader view
 thing push chart.png --json          # images and PDFs too
@@ -38,10 +38,28 @@ the overrides set the server picks your default (e.g. the Unravel org for Unrave
 
 ## MCP
 
-Any MCP client can push artifacts through your CLI login — register the server as:
+Claude Code, Cursor, Codex, and anything else that speaks Model Context
+Protocol can publish through thing. No terminal login needed: create a token at
+[usething.ai](https://usething.ai) under Settings, then Tokens, and paste this
+into your client's MCP config.
 
 ```json
-{ "command": "thing", "args": ["mcp"] }
+{
+  "mcpServers": {
+    "thing": {
+      "command": "npx",
+      "args": ["-y", "@unravel-tech/thing", "mcp"],
+      "env": { "THING_TOKEN": "paste-your-token-here" }
+    }
+  }
+}
 ```
 
+The server exposes three tools: `push_artifact` to publish a file or inline
+content and get back a link, `list_artifacts` to see what you have, and
+`whoami` to check which account and team you are pushing to.
+
+If you already ran `thing login`, the stored credential is used and
+`THING_TOKEN` can be left out.
+
 Requires Node >= 18 or Bun. No runtime dependencies.

package/package.json

@@ -3,8 +3,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.0",
-  "description": "CLI for thing: push, version, and share artifacts (HTML, Markdown, images, PDFs) from coding agents.",
+  "version": "0.4.1",
+  "description": "Artifacts for any coding agent. Publish what Claude Code, Codex, Cursor or Gemini CLI builds to a durable link, with versions and comments on the page.",
+  "mcpName": "io.github.unravel-team/thing",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,7 +25,13 @@
     "html",
     "cli",
     "agents",
-    "claude-code"
+    "claude-code",
+    "mcp",
+    "model-context-protocol",
+    "share",
+    "publish",
+    "codex",
+    "cursor"
   ],
   "scripts": {
     "smoke": "bun test/cli-smoke.mjs",

package/src/index.js

@@ -5,7 +5,8 @@ import { homedir } from "node:os";
 import { spawn } from "node:child_process";
 import { pathToFileURL } from "node:url";
 
-const DEFAULT_SERVER = process.env.THING_SERVER || "https://thing.unravel.tech";
+const DEFAULT_SERVER = process.env.THING_SERVER || "https://usething.ai";
+let clientName = "thing-cli/0.3.0";
 const VISIBILITIES = new Set(["team", "public"]);
 
 class CliError extends Error {
@@ -36,6 +37,7 @@ function projectConfigPath(cwd) {
 
 function loadState(cwd, env = process.env) {
   return {
+    env,
     globalPath: configPath(env),
     global: readJson(configPath(env)),
     projectPath: projectConfigPath(cwd),
@@ -87,9 +89,13 @@ function stripSlash(server) {
 }
 
 function context(state, flags = {}) {
+  const env = state.env ?? process.env;
   return {
-    server: stripSlash(flags.server || state.project.server || state.global.server || DEFAULT_SERVER),
-    token: flags.token || state.global.token || null,
+    // THING_SERVER and THING_TOKEN let an MCP client run this with no prior
+    // `thing login`: the whole config is a paste, which is the difference
+    // between usable and not for anyone who does not live in a terminal.
+    server: stripSlash(flags.server || env.THING_SERVER || state.project.server || state.global.server || DEFAULT_SERVER),
+    token: flags.token || env.THING_TOKEN || state.global.token || null,
     team: flags.team || state.project.team || state.global.activeTeam || null,
     project: flags.project || state.project.project || state.global.activeProject || null
   };
@@ -129,6 +135,7 @@ function formatText(value) {
 async function api(ctx, path, options = {}) {
   const headers = {
     Accept: "application/json",
+    "X-Thing-Client": clientName,
     ...(options.body ? { "Content-Type": "application/json" } : {}),
     ...(ctx.token ? { Authorization: `Bearer ${ctx.token}` } : {}),
     ...(options.headers || {})
@@ -407,7 +414,7 @@ const MCP_TOOLS = [
   {
     name: "push_artifact",
     description:
-      "Publish a file as a thing artifact and get a live, shareable URL. Every push creates a new immutable version. Pass either `path` (any supported file: html, md, pdf, png, jpg, gif, webp) or inline `content` with a `filename` (html or md).",
+      "Use this whenever the user wants to share, send, show, or publish something you produced: a report, a dashboard, a prototype, a Markdown doc, a PDF, an image. Publishes it to a durable URL that stays live, and returns the link. Pushing the same name again creates a new version at the same link rather than a second link, so prefer reusing a name over inventing one. Pass either `path` (html, md, pdf, png, jpg, gif, webp) or inline `content` with a `filename` (html or md).",
     inputSchema: {
       type: "object",
       properties: {
@@ -423,7 +430,8 @@ const MCP_TOOLS = [
   },
   {
     name: "list_artifacts",
-    description: "List the artifacts the logged-in user can see, with team, visibility, and title.",
+    description:
+      "Use this to find a link the user published earlier, or to check whether something is already published before pushing it again. Lists artifacts the signed-in user can see, with team, visibility and title.",
     inputSchema: {
       type: "object",
       properties: {
@@ -434,7 +442,8 @@ const MCP_TOOLS = [
   },
   {
     name: "whoami",
-    description: "Show the logged-in thing user, the server, and where pushes land by default.",
+    description:
+      "Use this to confirm the user is signed in and which team will own a new artifact. Shows the account, the server, and where pushes land when no team is named.",
     inputSchema: { type: "object", properties: {} }
   }
 ];
@@ -481,6 +490,7 @@ async function mcpTool(state, parsed, name, args) {
 }
 
 async function mcp(parsed, state, io) {
+  clientName = "thing-mcp/0.3.0";
   const respond = (id, body) => io.stdout.write(`${JSON.stringify({ jsonrpc: "2.0", id, ...body })}\n`);
   const handle = async (req) => {
     if (req.method === "initialize") {