@unravel-tech/thing

CLI für thing: Artefakte (HTML-Seiten, Markdown-Dokumente, eigenständige Bilder und PDFs) von Coding-Agenten pushen, versionieren und teilen.

npm i -g @unravel-tech/thing
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

Befehle

Jeder Befehl akzeptiert --json für maschinenlesbare Ausgabe.

Sichtbarkeitswerte: private, team, anyone-with-link (gibt eine mit Token versehene Freigabe-URL aus), public.

Related MCP server: drop

Kontextauflösung

Welches Team ein Push erreicht, wird in dieser Reihenfolge bestimmt: --team-Flag → .thing.json im Arbeitsverzeichnis → eine lokale thing use-Überschreibung → deine server-seitige Standardeinstellung (thing default) → dein persönlicher Bereich. Beim Login wird kein Team mehr festgelegt; wenn also keine der Überschreibungen gesetzt ist, wählt der Server deine Standardeinstellung (z. B. die Unravel-Organisation für Unravel-Mitglieder).

MCP

Claude Code, Cursor, Codex und alles andere, das Model Context Protocol spricht, kann über thing veröffentlichen. Kein Terminal-Login nötig: Erstelle auf usething.ai unter Einstellungen, dann Tokens, ein Token und füge es in die MCP-Konfiguration deines Clients ein.

{
  "mcpServers": {
    "thing": {
      "command": "npx",
      "args": ["-y", "@unravel-tech/thing", "mcp"],
      "env": { "THING_TOKEN": "paste-your-token-here" }
    }
  }
}

Der Server stellt drei Tools bereit: push_artifact, um eine Datei oder Inline-Inhalte zu veröffentlichen und einen Link zurückzubekommen, list_artifacts, um zu sehen, was du hast, und whoami, um zu prüfen, zu welchem Konto und Team du pushst.

Wenn du bereits thing login ausgeführt hast, werden die gespeicherten Anmeldedaten verwendet und THING_TOKEN kann weggelassen werden.

Erfordert Node >= 18 oder Bun. Keine Laufzeitabhängigkeiten.