app
Adom Forum
Public Made by Adomby adom
Post to and read the Adom Forum from the terminal, run by your AI. Start threads with Markdown and inline images, reply, and browse spaces. Posts made this way carry a 'via <agent>' badge so people can see an AI posted on your behalf.
← Commit history
Publish 0.1.5
4 files changed
+21−5
VERSION+1−1@@ -1 +1 @@-0.1.4+0.1.5
bin/adom-forum.cjs+16−1@@ -20,7 +20,7 @@ const { basename, dirname, resolve: resolvePath, extname } = require('node:path' const { homedir } = require('node:os') const { createHash } = require('node:crypto') -const VERSION = '0.1.2'+const VERSION = '0.1.5' // The CLI runs in the shared Linux runtime behind Hydrogen web, macOS, and // Windows alike. It depends only on Node 18+ (global fetch, FormData, Blob)@@ -42,6 +42,7 @@ USAGE adom-forum reply <thread-id> --body <text|@file|-> [--agent "<name>"] [--idempotency-key <key>] [--permission-to-post-given] [--json] adom-forum media upload <file> [--json]+ adom-forum widgets [--json] adom-forum whoami [--json] BODY@@ -49,6 +50,10 @@ BODY  or  are uploaded and rewritten to gated /media/ URLs before posting, so images and videos land exactly where they sit in the Markdown. +WIDGETS+ A line holding only ::name{key="value"} embeds a wiki widget (3D viewer, video player, …).+ \`adom-forum widgets\` lists the ones the forum can render and their attributes.+ CONSENT Writes preview first and exit 2. Re-run with --permission-to-post-given after the user says yes. @@ -295,6 +300,16 @@ async function main() { return } + if (command === 'widgets') {+ const { data } = await api('GET', '/api/widgets')+ const width = Math.max(...data.widgets.map((widget) => widget.name.length))+ const lines = data.widgets.map((widget) => `${widget.name.padEnd(width)} ::${widget.name}{${widget.attrs.map((attr) => `${attr}=""`).join(' ')}}`)+ if (!data.available) lines.push('', 'The wiki registry is unreachable right now; only built-in widgets will render.')+ lines.push('', 'Put the line alone in the body. Paths point at files on a public wiki page, e.g. src="/owner/slug/render/board.glb".')+ out(data, lines.join('\n') + '\n')+ return+ }+ fail(`unknown command: ${positional.join(' ')}\n\n${HELP}`) }
page.json+2−2@@ -4,7 +4,7 @@ "slug": "adom-forum", "title": "Adom Forum", "brief": "Post to and read the Adom Forum from the terminal, run by your AI. Start threads with Markdown and inline images, reply, and browse spaces. Posts made this way carry a 'via <agent>' badge so people can see an AI posted on your behalf.",- "version": "0.1.4",+ "version": "0.1.5", "visibility": "public", "license": "MIT", "install": {@@ -71,6 +71,6 @@ "engines": { "node": ">=18" },- "changelog": "0.1.4: the skill documents wiki widget lines (::adom-3d, ::adom-video, ::youtube) that now render in posts; CLI unchanged.",+ "changelog": "0.1.5: `adom-forum widgets` lists the wiki widgets a post can embed; the forum composer now offers them when a line starts with ::. --version reports the real version.", "org": "adom" }
skills/adom-forum/SKILL.md+2−1@@ -28,6 +28,7 @@ adom-forum thread create --space show-and-tell --title "TMF8829 depth lab build" adom-forum thread create ... --body @post.md --permission-to-post-given # after the user approves adom-forum reply <thread-id> --body "Tested at 5 m, works." --permission-to-post-given adom-forum media upload ./board-top.png # prints a /media/... URL+adom-forum widgets # wiki widgets a post can embed, with their attributes adom-forum whoami ``` @@ -38,7 +39,7 @@ Add `--json` to any command for a `{ status, data }` envelope. - The body is GitHub-flavored Markdown: headings, bullet points, tables, code, links. - Put images and videos exactly where they belong with normal image syntax and a **local path**: `` or ``. The CLI uploads each local file and rewrites the URL before posting, so the media lands in the flow of the text. Images: PNG, JPEG, GIF, WebP up to 8 MB. Videos: MP4, WebM, MOV up to 256 MB, uploaded straight to storage; they render as an inline player. - Reference people and wiki pages with `@username` and `@owner/slug`; they render as link chips. A `@owner/slug` alone on its own line renders as a page card.-- Embed wiki widgets (3D viewer, video player, pinout, tables, and the rest) with the same line a wiki README uses, alone on its own line: `::adom-3d{src="/owner/slug/render/board.glb"}`, `::adom-video{video="/owner/slug/render/demo.mp4" title="Demo"}`, `::youtube{id="VIDEO_ID"}`. Paths are absolute wiki paths on a public page. `GET https://wiki.adom.inc/api/widgets` lists every widget and its attributes; an unknown tag shows as plain text.+- Embed wiki widgets (3D viewer, video player, pinout, tables, and the rest) with the same line a wiki README uses, alone on its own line: `::adom-3d{src="/owner/slug/render/board.glb"}`, `::adom-video{video="/owner/slug/render/demo.mp4" title="Demo"}`, `::youtube{id="VIDEO_ID"}`. Paths are absolute wiki paths on a public page. `adom-forum widgets` lists the ones the forum renders and their attributes; an unknown tag shows as plain text. - A thread needs a title of 4 to 160 characters and a body of at least 2 characters. - Draft long posts to a file and use `--body @file.md` so the preview is readable and the user can edit it.