Documentation

Everything you need to capture, shape, and share your work.

01

Getting started

Install BuildTales, run it locally, and make your first draft.

Run npm install, then npm run build && npm start. Open /app and choose a recent local session or begin with manual notes.
02

Capture workflow

Turn a reachable page into before-and-after evidence.

Paste a localhost, staging, or live URL. Capture before at the start and after when the work is done.
03

Session imports

Import recent Codex and Claude conversations locally.

BuildTales reads the selected local JSONL archive and turns useful context into a private, editable draft.
04

Writing and editing

Shape raw work into a concise build story.

Edit each post, regenerate from private notes, add a public link, and use readiness checks before handoff.
05

X publishing

Authorize BuildTales.app with X, then approve each finished thread.

BuildTales uses OAuth 2.0 with PKCE and publishes the approved posts as one reply chain.
06

Desktop companion

Keep local session access close at hand.

Run npm run desktop for the tray companion and control access to Codex and Claude archives.
07

Privacy and data

Know what stays local and what leaves your machine.

Session archives, uploaded images, captures, and drafts remain local. Nothing is published automatically.
08

Licence and billing

Create for free. Pay only when you are ready to publish.

Importing, drafting, editing, captures, and uploads are free. A personal $79 annual licence unlocks direct X publishing and includes product updates while the licence is active.