Docs

CLI

Scaffold configs, validate them, and export sessions from the command line.

Talkform ships with a small CLI for agent-friendly workflows. Run it without a global install:

npx --yes @talkform/cli@latest --help

Commands

talkform install --all

Install the canonical Talkform skill and exact-version local MCP configuration for Claude, Codex, and Cursor. Use --client claude|codex|cursor to target one client. The installer preserves unrelated configuration and refuses malformed or unmanaged files.

talkform templates

List bundled templates.

talkform init

Write a starter talkform.config.json into the current directory.

talkform validate <config>

Validate a JSON config file.

talkform dev

Run the local hosted app via the workspace web package.

talkform export --session <id> --format json|markdown

Fetch an exported session result from the running Talkform app.

Base URL

The CLI uses AUDIOFORM_BASE_URL if set, otherwise http://localhost:3000.

Machine authentication

Set AUDIOFORM_API_TOKEN in the trusted CLI environment. The CLI sends it as a bearer credential on API requests. Its value must match the server-only TALKFORM_API_TOKEN configured on the Talkform web service.

Do not put either token in browser code. Hosted production session endpoints remain disabled until the operator configures durable storage, distributed rate limiting, server authentication, and the explicit server opt-in.

The previous audioform binary remains as a compatibility alias for v0.1, but new integrations should use talkform.