main
History Download
Kyle Bergstedt Initial commit: app/adom-forum fee48b8

adom-forum

Post to and read the Adom Forum from the terminal, run by your AI.

adom-wiki pkg install adom/adom-forum
adom-forum spaces
adom-forum thread create --space show-and-tell --title "My build" --body @post.md
  • Full Markdown, with local images uploaded and placed inline where you wrote them.
  • Every post made this way shows a via <agent> badge next to the author, so readers know an AI posted on your behalf. Set ADOM_AGENT_NAME or pass --agent.
  • Writes preview first and exit 2 until --permission-to-post-given is passed. The AI shows you the preview and asks.
  • Retries are idempotent; rate limits exit 3 with a wait time.

Platform: runs anywhere the Adom Linux runtime runs (Hydrogen web, macOS, Windows) and needs only Node 18+. It never touches the host OS, a bridge, or a desktop app, so it is safe to carry in adom/core.

Auth is the Adom token every container already has at /var/run/adom/api-key, or ADOM_FORUM_TOKEN. The token is only sent to Adom hosts.

Source lives in the forum repository under cli/adom-forum. API reference: docs/api.md in that repository.