dunsocial 0.2.0 → 0.3.1

package/README.md

@@ -1,157 +1,102 @@
-# DunSocial CLI (`dun`)
+# DunSocial CLI
 
-Agent-first command line client for [DunSocial](https://dunsocial.com).
-
-Wraps the existing Mobile API (`apps/api`) — **no duplicate publish logic**.  
-Remote AI hosts (ChatGPT / Claude web) should keep using **MCP**. This CLI is for local agents (Claude Code, Codex), CI, and power users.
-
-Linear: [DUN-262](https://linear.app/thisuxco/issue/DUN-262) · [DUN-263](https://linear.app/thisuxco/issue/DUN-263) · [DUN-264](https://linear.app/thisuxco/issue/DUN-264)
+Post and schedule to your social accounts from the terminal.
 
 ## Install
 
-### Monorepo (dev)
-
 ```bash
-bun install
-bun run dev:cli -- --help
-bun apps/cli/src/index.ts auth status --json
+npm install -g dunsocial
 ```
 
-### Built package (Node 20+)
-
-```bash
-bun run --cwd apps/cli build
-node apps/cli/dist/index.js --help
+Then use the `dun` command (Node.js 20+).
 
-# npm (when published)
-npm i -g dunsocial
-dun --help
-```
+---
 
-Bins: `dun` · `dunsocial`. Package name: `dunsocial`.
+## Get started
 
-## Quick start
+### 1. Sign in
 
 ```bash
-# 1. Authenticate with a Better Auth bearer session token
-export DUN_TOKEN=...          # or: dun auth login --token ...
-export DUN_API_URL=https://api.dunsocial.com   # optional
-
-# 2. Pick a workspace
-dun workspace list --json
-dun workspace use <id-or-slug>
+dun auth login
+```
 
-# 3. Discover connected accounts
-dun accounts list --json
+A browser window opens so you can approve access. After that, you’re set on this machineأتى### 2. Choose your workspace
 
-# 4. Schedule
-dun posts schedule \
-  --text "Hello from the DunSocial CLI" \
-  --accounts <socialAccountId> \
-  --in 1h \
-  --json
+```bash
+dun workspace list
+dun workspace use your-workspace
 ```
 
-## Auth
-
-### Device login (default)
+### 3. See connected accounts
 
 ```bash
-dun auth login
-# opens app.dunsocial.com/cli/authorize — approve, CLI stores token
-dun auth login --no-browser   # print URL only
+dun accounts list
 ```
 
-### PAT / CI (recommended for automation)
+Copy the **account id** you want to post with (not the @username).
 
-Create a token in **Settings → CLI** (hashed at rest, scoped, revocable):
+### 4. Schedule a post
 
 ```bash
-export DUN_TOKEN='dun_pat_…'
-export DUN_WORKSPACE_ID='…'
-dun auth status --json
+dun posts schedule \
+  --text "Hello from DunSocial" \
+  --accounts ACCOUNT_ID \
+  --in 1h
 ```
 
-### Session token (humans / legacy)
+Post right away:
 
 ```bash
-dun auth login --token <bearer-session>
-export DUN_TOKEN=...
-dun auth whoami --json
-dun auth logout
+dun posts publish \
+  --text "Hello from DunSocial" \
+  --accounts ACCOUNT_ID
 ```
 
-Config: `~/.config/dunsocial/config.json` (0600). Override path with `DUN_CONFIG`.
-
-Env (wins over config):
+---
 
-| Var | Purpose |
-|-----|---------|
-| `DUN_TOKEN` | Bearer token |
-| `DUN_WORKSPACE_ID` | Default workspace |
-| `DUN_API_URL` | API base URL |
-| `DUN_JSON=1` | Force JSON output |
-| `DUN_DEBUG=1` | Log HTTP to stderr |
+## Automated posting (CI)
 
-PATs with scoped UI management are a later follow-up. See `docs/cli.md` for a GitHub Actions announce example.
+1. In DunSocial, open **Settings → CLI**
+2. Create an access token and copy it (shown once)
+3. Add these secrets in your CI:
+   - `DUN_TOKEN` — your access token  
+   - `DUN_WORKSPACE_ID` — your workspace id  
 
-## Commands
-
-See `dun --help` for the full map. Highlights:
-
-| Area | Examples |
-|------|----------|
-| Workspaces | `workspace list\|use\|current` |
-| Accounts | `accounts list [--platform x]` |
-| Posts | `schedule`, `publish`, `list`, `get`, `reschedule`, `cancel`, `delete`, `x-cap`, `schedule-thread`, `publish-thread` |
-| Drafts | `create`, `list`, `get`, `update`, `delete` |
-| Media | `upload <file>`, `list`, `get`, `delete` |
-| Memory | `collections list\|create`, `save`, `list`, `search`, `delete` |
-| Skills | `skill install claude\|codex` |
-
-### Global flags
+```bash
+export DUN_TOKEN=your_token
+export DUN_WORKSPACE_ID=your_workspace_id
 
+dun posts schedule \
+  --text "We just shipped a new release" \
+  --accounts ACCOUNT_ID \
+  --in 5m
 ```
---json  --workspace <id>  --api-url <url>  --token <token>
---debug  --quiet  --yes  --help  --version
-```
-
-JSON is the default when stdout is not a TTY or `CI=1`.
-
-### Exit codes
 
-0 ok · 1 usage · 2 auth · 3 forbidden · 4 validation · 5 not found · 6 rate limited · 7 network
+---
 
-## Agent skills
+## Useful commands
 
 ```bash
-dun skill install claude   # ~/.claude/skills/dunsocial/SKILL.md
-dun skill install codex    # ~/.codex/skills/... + AGENTS.md block
-```
-
-## Development
-
-```bash
-bun run --cwd apps/cli test
-bun run --cwd apps/cli type-check
-bun run --cwd apps/cli build
-bun run --cwd apps/cli release-check
+dun --help
+dun auth status
+dun posts list
+dun media upload ./photo.png
+dun drafts create --text "Idea for later"
 ```
 
-## Releases (npm)
+Tips:
 
-Do **not** bump `version` by hand for normal releases.
+- Help for any command: `dun posts --help`
+- Structured output for scripts: add `--json`
+- Prefer ChatGPT or Claude **in the browser**? Use [MCP](https://docs.dunsocial.com/mcp) instead of the CLI
 
-1. Merge conventional commits affecting `apps/cli` to `main`
-2. Merge the **release-please** PR (version + `CHANGELOG.md`)
-3. CI publishes `dunsocial` to npm (`NPM_TOKEN` secret)
+---
 
-See [docs/release.md](../../docs/release.md). Manual: Actions → **Release CLI** → run with an existing tag.
+## Links
 
-## Architecture
+- [dunsocial.com](https://dunsocial.com)
+- [npm package](https://www.npmjs.com/package/dunsocial)
 
-```
-dun → HTTPS + Bearer + X-Workspace-Id → apps/api REST
-```
+## License
 
-Do not import DB/MCP server code into the CLI. Keep it a thin client.
+MIT

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-import{mkdir as dn,readFile as Ie,writeFile as rn,chmod as tn,unlink as mn}from"node:fs/promises";import{dirname as yn,join as ue}from"node:path";import{homedir as pe}from"node:os";var o={OK:0,USAGE:1,AUTH:2,FORBIDDEN:3,VALIDATION:4,NOT_FOUND:5,RATE_LIMITED:6,NETWORK:7};class w extends Error{code;details;constructor(e,n=o.USAGE,u){super(e);this.name="CliError",this.code=n,this.details=u}}function ne(e){if(e===401)return o.AUTH;if(e===403)return o.FORBIDDEN;if(e===404)return o.NOT_FOUND;if(e===429)return o.RATE_LIMITED;if(e>=400&&e<500)return o.VALIDATION;return o.NETWORK}var Ge="https://api.dunsocial.com",W="0.2.0";function Ve(){if(process.env.DUN_CONFIG)return process.env.DUN_CONFIG;let e=process.env.XDG_CONFIG_HOME,n=e?e:ue(pe(),".config");return ue(n,"dunsocial","config.json")}async function _e(){let e=Ve();try{let n=await Ie(e,"utf8");return JSON.parse(n)}catch(n){if(n.code==="ENOENT")return{};throw new w(`Failed to read config at ${e}: ${n.message}`,o.USAGE)}}async function de(e){let n=await _e(),u=(e.apiUrl||process.env.DUN_API_URL||n.apiUrl||Ge).replace(/\/$/,""),t=e.token||process.env.DUN_TOKEN||n.token,y=e.workspace||process.env.DUN_WORKSPACE_ID||n.defaultWorkspaceId||void 0,d=process.env.DUN_JSON==="0",i=!process.stdout.isTTY,r=d?!1:e.json===!0||process.env.DUN_JSON==="1"||process.env.CI==="true"||process.env.CI==="1"||i;return{apiUrl:u,token:t,workspaceId:y,json:r,debug:e.debug===!0||process.env.DUN_DEBUG==="1",quiet:e.quiet===!0,yes:e.yes===!0||process.env.CI==="true"||process.env.CI==="1",config:n}}function re(e){let n={},u=[],t=0,y=!0;while(t<e.length){let O=e[t];if(y&&O==="--"){y=!1,t+=1;continue}if(y&&O.startsWith("--")){let A=O.indexOf("=");if(A!==-1){n[O.slice(2,A)]=O.slice(A+1),t+=1;continue}let T=O.slice(2),U=e[t+1];if(U!==void 0&&!U.startsWith("-"))n[T]=U,t+=2;else n[T]=!0,t+=1;continue}if(y&&O.startsWith("-")&&O.length>1&&O!=="-"){let A=O.slice(1);if(A.length>1&&!A.includes("=")){for(let V of A)n[V]=!0;t+=1;continue}let T=A,U=e[t+1];if(U!==void 0&&!U.startsWith("-"))n[T]=U,t+=2;else n[T]=!0,t+=1;continue}u.push(O),t+=1}let d=u[0],i,r,m=1;if(d==="memory"&&(u[1]==="collections"||u[1]==="collection"))r="collections",i=u[2],m=i?3:2;else i=u[1],m=i?2:1;return{group:d,action:i,nest:r,flags:n,positionals:u.slice(m)}}function M(e,...n){for(let u of n){let t=e[u];if(typeof t==="string"&&t.length>0)return t}return}function K(e,...n){for(let u of n){let t=e[u];if(t===!0)return!0;if(typeof t==="string"){let y=t.toLowerCase();if(y==="1"||y==="true"||y==="yes")return!0}}return!1}function F(e){return K(e,"help","h")}function q(e){return K(e,"version","v","V")}function s(e,n){if(n.quiet&&!n.json)return;if(n.json||!process.stdout.isTTY){process.stdout.write(`${JSON.stringify({ok:!0,data:e},null,2)}
+import{mkdir as dn,readFile as Ie,writeFile as rn,chmod as tn,unlink as mn}from"node:fs/promises";import{dirname as yn,join as ue}from"node:path";import{homedir as pe}from"node:os";var o={OK:0,USAGE:1,AUTH:2,FORBIDDEN:3,VALIDATION:4,NOT_FOUND:5,RATE_LIMITED:6,NETWORK:7};class w extends Error{code;details;constructor(e,n=o.USAGE,u){super(e);this.name="CliError",this.code=n,this.details=u}}function ne(e){if(e===401)return o.AUTH;if(e===403)return o.FORBIDDEN;if(e===404)return o.NOT_FOUND;if(e===429)return o.RATE_LIMITED;if(e>=400&&e<500)return o.VALIDATION;return o.NETWORK}var Ge="https://api.dunsocial.com",W="0.3.1";function Ve(){if(process.env.DUN_CONFIG)return process.env.DUN_CONFIG;let e=process.env.XDG_CONFIG_HOME,n=e?e:ue(pe(),".config");return ue(n,"dunsocial","config.json")}async function _e(){let e=Ve();try{let n=await Ie(e,"utf8");return JSON.parse(n)}catch(n){if(n.code==="ENOENT")return{};throw new w(`Failed to read config at ${e}: ${n.message}`,o.USAGE)}}async function de(e){let n=await _e(),u=(e.apiUrl||process.env.DUN_API_URL||n.apiUrl||Ge).replace(/\/$/,""),t=e.token||process.env.DUN_TOKEN||n.token,y=e.workspace||process.env.DUN_WORKSPACE_ID||n.defaultWorkspaceId||void 0,d=process.env.DUN_JSON==="0",i=!process.stdout.isTTY,r=d?!1:e.json===!0||process.env.DUN_JSON==="1"||process.env.CI==="true"||process.env.CI==="1"||i;return{apiUrl:u,token:t,workspaceId:y,json:r,debug:e.debug===!0||process.env.DUN_DEBUG==="1",quiet:e.quiet===!0,yes:e.yes===!0||process.env.CI==="true"||process.env.CI==="1",config:n}}function re(e){let n={},u=[],t=0,y=!0;while(t<e.length){let O=e[t];if(y&&O==="--"){y=!1,t+=1;continue}if(y&&O.startsWith("--")){let A=O.indexOf("=");if(A!==-1){n[O.slice(2,A)]=O.slice(A+1),t+=1;continue}let T=O.slice(2),U=e[t+1];if(U!==void 0&&!U.startsWith("-"))n[T]=U,t+=2;else n[T]=!0,t+=1;continue}if(y&&O.startsWith("-")&&O.length>1&&O!=="-"){let A=O.slice(1);if(A.length>1&&!A.includes("=")){for(let V of A)n[V]=!0;t+=1;continue}let T=A,U=e[t+1];if(U!==void 0&&!U.startsWith("-"))n[T]=U,t+=2;else n[T]=!0,t+=1;continue}u.push(O),t+=1}let d=u[0],i,r,m=1;if(d==="memory"&&(u[1]==="collections"||u[1]==="collection"))r="collections",i=u[2],m=i?3:2;else i=u[1],m=i?2:1;return{group:d,action:i,nest:r,flags:n,positionals:u.slice(m)}}function M(e,...n){for(let u of n){let t=e[u];if(typeof t==="string"&&t.length>0)return t}return}function K(e,...n){for(let u of n){let t=e[u];if(t===!0)return!0;if(typeof t==="string"){let y=t.toLowerCase();if(y==="1"||y==="true"||y==="yes")return!0}}return!1}function F(e){return K(e,"help","h")}function q(e){return K(e,"version","v","V")}function s(e,n){if(n.quiet&&!n.json)return;if(n.json||!process.stdout.isTTY){process.stdout.write(`${JSON.stringify({ok:!0,data:e},null,2)}
 `);return}if(e===void 0||e===null){process.stdout.write(`ok
 `);return}if(typeof e==="string"){process.stdout.write(`${e}
 `);return}process.stdout.write(`${Je(e)}
@@ -12,7 +12,7 @@ import{mkdir as dn,readFile as Ie,writeFile as rn,chmod as tn,unlink as mn}from"
 ${t}`:t}return Object.entries(n).map(([u,t])=>`${u}: ${P(t)}`).join(`
 `)}return String(e)}function te(e){if(e.length===0)return"(empty)";let n=["id","name","slug","status","providerName","username","displayName","role","scheduledAt","content","text","originalFilename","score","collectionId"],u=new Set;for(let m of e)for(let O of Object.keys(m))u.add(O);let t=[...n.filter((m)=>u.has(m)),...[...u].filter((m)=>!n.includes(m)).slice(0,6)].slice(0,8),y=e.map((m)=>t.map((O)=>He(P(m[O]),O==="content"||O==="text"?48:28))),d=t.map((m,O)=>Math.max(m.length,...y.map((A)=>A[O]?.length??0))),i=t.map((m,O)=>m.padEnd(d[O])).join("  "),r=y.map((m)=>m.map((O,A)=>O.padEnd(d[A])).join("  ")).join(`
 `);return`${i}
-${r}`}function P(e){if(e===null||e===void 0)return"";if(typeof e==="string")return e.replace(/\s+/g," ").trim();if(typeof e==="number"||typeof e==="boolean")return String(e);if(e instanceof Date)return e.toISOString();if(typeof e==="object"){let n=e;if(typeof n.id==="string"&&typeof n.name==="string")return`${n.name} (${n.id})`;if(typeof n.status==="string")return n.status;return JSON.stringify(e)}return String(e)}function He(e,n){if(e.length<=n)return e;return`${e.slice(0,Math.max(0,n-1))}…`}var G={OK:0,USAGE:1,AUTH:2,FORBIDDEN:3,VALIDATION:4,NOT_FOUND:5,RATE_LIMITED:6,NETWORK:7};class S extends Error{code;details;constructor(e,n=G.USAGE,u){super(e);this.name="CliError",this.code=n,this.details=u}}import{mkdir as Ye,readFile as Rn,writeFile as ze,chmod as We,unlink as Me}from"node:fs/promises";import{dirname as Qe,join as me}from"node:path";import{homedir as Xe}from"node:os";var Q="0.2.0";function E(){if(process.env.DUN_CONFIG)return process.env.DUN_CONFIG;let e=process.env.XDG_CONFIG_HOME,n=e?e:me(Xe(),".config");return me(n,"dunsocial","config.json")}function L(){return E()}async function J(e){let n=E();await Ye(Qe(n),{recursive:!0});let u={...e,updatedAt:new Date().toISOString()};await ze(n,`${JSON.stringify(u,null,2)}
+${r}`}function P(e){if(e===null||e===void 0)return"";if(typeof e==="string")return e.replace(/\s+/g," ").trim();if(typeof e==="number"||typeof e==="boolean")return String(e);if(e instanceof Date)return e.toISOString();if(typeof e==="object"){let n=e;if(typeof n.id==="string"&&typeof n.name==="string")return`${n.name} (${n.id})`;if(typeof n.status==="string")return n.status;return JSON.stringify(e)}return String(e)}function He(e,n){if(e.length<=n)return e;return`${e.slice(0,Math.max(0,n-1))}…`}var G={OK:0,USAGE:1,AUTH:2,FORBIDDEN:3,VALIDATION:4,NOT_FOUND:5,RATE_LIMITED:6,NETWORK:7};class S extends Error{code;details;constructor(e,n=G.USAGE,u){super(e);this.name="CliError",this.code=n,this.details=u}}import{mkdir as Ye,readFile as Rn,writeFile as ze,chmod as We,unlink as Me}from"node:fs/promises";import{dirname as Qe,join as me}from"node:path";import{homedir as Xe}from"node:os";var Q="0.3.1";function E(){if(process.env.DUN_CONFIG)return process.env.DUN_CONFIG;let e=process.env.XDG_CONFIG_HOME,n=e?e:me(Xe(),".config");return me(n,"dunsocial","config.json")}function L(){return E()}async function J(e){let n=E();await Ye(Qe(n),{recursive:!0});let u={...e,updatedAt:new Date().toISOString()};await ze(n,`${JSON.stringify(u,null,2)}
 `,"utf8");try{await We(n,384)}catch{}}async function oe(){let e=E();try{await Me(e)}catch(n){if(n.code!=="ENOENT")throw new w(`Failed to clear config: ${n.message}`,o.USAGE)}}function R(e){if(!e.token)throw new w("Not authenticated. Run `dun auth login --token <token>` or set DUN_TOKEN.",o.AUTH);return e.token}function k(e){if(!e.workspaceId)throw new w("No workspace selected. Run `dun workspace use <id|slug>` or pass --workspace / DUN_WORKSPACE_ID.",o.VALIDATION);return e.workspaceId}var X=`dun — DunSocial agent-first CLI v${Q}
 
 Usage:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dunsocial",
-	"version": "0.2.0",
+	"version": "0.3.1",
 	"description": "DunSocial agent-first CLI — schedule and publish social posts from the terminal, CI, and coding agents",
 	"type": "module",
 	"license": "MIT",
@@ -22,8 +22,8 @@
 		"mcp"
 	],
 	"bin": {
-		"dun": "./dist/index.js",
-		"dunsocial": "./dist/index.js"
+		"dun": "dist/index.js",
+		"dunsocial": "dist/index.js"
 	},
 	"files": [
 		"dist",

package/skills/dunsocial/SKILL.md

@@ -1,44 +1,53 @@
 ---
 name: dunsocial
-description: Schedule, publish, and manage DunSocial posts, drafts, media, and memory from the shell via the dun CLI. Use when the user wants to post or schedule to X/LinkedIn/Bluesky/Threads/Reddit/Pinterest/Instagram/YouTube through DunSocial, manage drafts or media uploads, search workspace memory, or wire social publishing into CI/agent workflows.
+description: Schedule, publish, and manage DunSocial posts, drafts, media, and memory from the shell via the dun CLI (npm package dunsocial). Use when the user wants to post or schedule to X/LinkedIn/Bluesky/Threads/Reddit/Pinterest/Instagram/YouTube through DunSocial, manage drafts or media uploads, search workspace memory, or wire social publishing into CI/agent workflows.
 ---
 
 # DunSocial CLI skill
 
-Use the `dun` binary (`@dunsocial/cli`). Prefer **`--json`** on every command so output is machine-parseable.
+Use the **`dun`** binary from the **`dunsocial`** npm package.
 
-Remote hosts (ChatGPT web, Claude web) should keep using the DunSocial **MCP** server. This CLI is for **local agents, terminals, and CI**.
+```bash
+npm install -g dunsocial
+# or
+npx dunsocial …
+```
+
+Prefer **`--json`** on every command so output is machine-parseable.
+
+Remote hosts (ChatGPT web, Claude web) should keep using DunSocial **MCP**. This CLI is for **local agents, terminals, and CI**.
 
 ## Auth + workspace
 
 ```bash
-# Interactive (opens browser device login)
+# Interactive (browser approve at app.dunsocial.com/cli/authorize)
 dun auth login
 
-# CI / headless — prefer PAT from Settings → CLI (dun_pat_…)
-export DUN_TOKEN="$DUN_PAT" DUN_WORKSPACE_ID="$DUN_WORKSPACE_ID"
-# legacy full session also works:
-dun auth login --token "$DUN_TOKEN" --json
+# CI / headless — PAT from app Settings → CLI (dun_pat_…)
+export DUN_TOKEN="dun_pat_…"
+export DUN_WORKSPACE_ID="…"
+# optional:
+export DUN_API_URL=https://api.dunsocial.com
 
 dun auth status --json
 dun workspace list --json
 dun workspace use <id-or-slug> --json
 ```
 
-Env overrides (highest priority for CI):
+Env overrides config file `~/.config/dunsocial/config.json`.
 
-- `DUN_TOKEN`
-- `DUN_WORKSPACE_ID`
-- `DUN_API_URL` (default `https://api.dunsocial.com`)
+PAT notes:
 
-Config file: `~/.config/dunsocial/config.json` (mode 0600).
+- Workspace-bound; missing scope → exit `3` / forbidden
+- Cannot manage other tokens, billing, or team
+- Prefer PAT over full browser session tokens in CI
 
 ## Discovery order (always)
 
-1. `dun auth status --json` — confirm auth
-2. `dun workspace current --json` or `list` + `use`
+1. `dun auth status --json`
+2. `dun workspace current --json` (or `list` + `use`)
 3. `dun accounts list --json` — capture social account **ids**
-4. Act (schedule/publish/draft/media/memory)
+4. Act (schedule / publish / draft / media / memory)
 
 Do **not** invent account IDs. Do **not** treat `drafts create` as a successful publish.
 
@@ -46,17 +55,13 @@ Do **not** invent account IDs. Do **not** treat `drafts create` as a successful
 
 ```bash
 dun posts schedule \
-  --text "Shipped the DunSocial CLI for agents." \
+  --text "Shipped from the DunSocial CLI." \
   --accounts acc_x,acc_li \
   --in 1h \
   --json
 ```
 
-Or absolute time:
-
-```bash
-dun posts schedule --text "..." --accounts acc_x --at 2026-06-01T09:00:00Z --json
-```
+Absolute time: `--at 2026-06-01T09:00:00Z`.
 
 ## Publish now
 
@@ -68,36 +73,24 @@ dun posts publish --text "Hello from dun" --accounts acc_x --json
 
 ```bash
 dun media upload ./shot.png --alt "Product screenshot" --json
-# use returned asset id:
-dun posts schedule --text "..." --accounts acc_x --media <assetId> --in 30m --json
+dun posts schedule --text "…" --accounts acc_x --media <assetId> --in 30m --json
 ```
 
-## Drafts
-
-```bash
-dun drafts create --text "WIP idea" --platforms x,linkedin --json
-dun drafts list --json
-```
-
-## Memory
+## Drafts / memory / threads
 
 ```bash
+dun drafts create --text "WIP" --platforms x,linkedin --json
 dun memory collections list --json
-dun memory save --collection <id> --text "We never promise same-day enterprise onboarding." --json
-dun memory search --prompt "onboarding promises" --collections <id> --json
-```
-
-## Threads (X)
+dun memory save --collection <id> --text "…" --json
+dun memory search --prompt "…" --collections <id> --json
 
-```bash
-# thread.json => [ {"content":"1"}, {"content":"2"} ]  or { "tweets": [...] }
+# thread.json: [ {"content":"1"}, {"content":"2"} ]
 dun posts schedule-thread --account acc_x --file ./thread.json --in 2h --json
-dun posts publish-thread --account acc_x --file ./thread.json --json
 ```
 
 ## Destructive ops
 
-Require `--yes` (or `CI=1`) for `delete` commands.
+Require `--yes` (or `CI=1`) for `delete`.
 
 ## Exit codes
 
@@ -106,25 +99,25 @@ Require `--yes` (or `CI=1`) for `delete` commands.
 | 0 | ok |
 | 1 | usage |
 | 2 | auth |
-| 3 | forbidden |
+| 3 | forbidden / missing scope |
 | 4 | validation |
 | 5 | not found |
 | 6 | rate limited |
 | 7 | network |
 
-On failure with `--json`:
+Failure JSON:
 
 ```json
-{ "ok": false, "error": { "code": "validation", "message": "...", "details": null } }
+{ "ok": false, "error": { "code": "validation", "message": "…", "details": null } }
 ```
 
 ## Pitfalls
 
-- Workspace is required for almost every command after login (`workspace use` or `--workspace` / `DUN_WORKSPACE_ID`).
-- `--accounts` takes DunSocial **social account ids**, not handles.
-- Local files must be uploaded via `media upload` before referencing in posts (unless you already have an asset id / storage key).
-- Platform-specific metadata (Reddit/IG/Pinterest) can be passed as `--meta '{"reddit":{...}}'` JSON when needed; prefer dedicated product flows in the dashboard for complex cases.
-- MCP OAuth scopes and CLI bearer sessions are different paths — fixing one does not fix the other.
+- Need workspace: `workspace use` or `--workspace` / `DUN_WORKSPACE_ID`
+- `--accounts` = DunSocial social account **ids**, not handles
+- Upload local files with `media upload` before attaching
+- Platform-specific options via `--meta '{"reddit":{…}}'` when needed
+- MCP OAuth and CLI tokens are different systems
 
 ## Help